ADR을 위한 팀워크 조언

팀에서 결정 기록을 사용하는 것을 고려하고 있다면, 여러 팀과 함께 일하며 배운 조언을 소개합니다.

“무엇을” 강제하기보다 “왜”에 대해 함께 이야기함으로써 팀원들을 이끌 기회가 있습니다. 예를 들어 결정 기록은 팀이 더 똑똑하게 생각하고 더 잘 소통하는 방법입니다. 결정 기록이 사후에 강제되는 서류 작업 요건에 불과하다면 가치가 없습니다.

일부 팀은 약어인 “ADR”보다 “결정(decisions)”이라는 이름을 훨씬 선호합니다. 일부 팀이 디렉터리 이름으로 “decisions”를 사용하면 전구가 켜지는 듯한 일이 일어나고, 팀은 공급업체 결정, 계획 결정, 일정 결정 등 더 많은 정보를 그 디렉터리에 넣기 시작합니다. 이 모든 종류의 정보에 같은 템플릿을 쓸 수 있습니다. 우리는 사람들이 약어(“ADR”)보다 단어(“결정”)로 더 빨리 배우고, “기록(record)”이라는 단어를 빼면 진행 중인 작업 문서를 쓰려는 동기가 더 커지며, 또한 일부 개발자와 일부 관리자는 “아키텍처”라는 단어를 싫어한다고 가정합니다.

이론적으로는 불변성이 이상적입니다. 실제로는 우리 팀에서는 가변성이 더 잘 맞았습니다. 우리는 기존 ADR에 날짜 스탬프와 그 정보가 결정 이후에 들어왔다는 메모와 함께 새 정보를 삽입합니다. 이런 접근 방식은 우리 모두가 갱신할 수 있는 “살아 있는 문서”로 이어집니다. 전형적인 갱신은 새로운 팀원 덕분에, 새로운 제공 서비스 덕분에, 우리 사용의 실제 결과 덕분에, 또는 공급업체의 기능, 요금제, 라이선스 계약 같은 사후 제3자 변경 이후에 정보를 얻을 때 이루어집니다.