결정을 문서화하는 방법, 그래서 실제로 유지되고 (다시 논의되는 것을 멈추게)

11개월 전, 당신의 팀은 내부에서 통합을 구축할지 구매할지 선택하기 위해 세 번의 회의를 가졌습니다. 사람들은 준비를 해왔습니다. 누군가 스프레드시트를 만들었습니다. 논의는 정말 좋았습니다 — 우려가 제기되었고, 트레이드오프가 고려되었으며, 결정을 내렸습니다. 그리고 나서 모두 다시 일로 돌아갔습니다.

이번 주에 새로운 엔지니어링 리드가 합류하여 통합을 살펴보고 합리적인 질문을 던졌습니다: "왜 우리가 이걸 직접 만들지 않았나요?" 그리고 방에 있는 누구나 할 수 있는 솔직한 대답은: 아무도 정확히 기억하지 못한다는 것이었습니다. 그래서 질문은 다시 열렸습니다. 세 번의 회의가 다시 열릴 예정인데, 첫 번째 때보다 정보가 적습니다. 왜냐하면 스프레드시트를 만든 사람이 3월에 떠났기 때문입니다.

그 이야기에서 특별한 점은 없으며, 그것이 문제입니다. 결코 작업을 잃지 않을 팀들이 결정을 끊임없이 잃습니다. 왜냐하면 작업에는 시스템이 있지만 결정에는 분위기가 있기 때문입니다. 이 게시물은 완전하고 실용적인 해결책입니다: 무엇을 기록할지, 중요한 일곱 가지 분야, 빌릴 가치가 있는 프레임워크, 그리고 이 실천을 지속하게 만드는 습관들입니다.

결정 기록이란 무엇이며 — 이 게시물에서 다루는 내용

결정 기록은 하나의 중요한 결정을 포착하는 짧고 구조화된 문서입니다: 무엇이 결정되었는지, 대안은 무엇이었는지, 왜 이 옵션이 선택되었는지, 누가 결정을 내렸는지, 그리고 언제 그것이 효과가 있었는지 확인할 것인지. 이는 결정이 내려질 때 작성되며, 나중에 재구성되지 않고, 전체 팀이 검색할 수 있는 곳에 보관됩니다.

회의록이 아니라 대화의 연대기적 기록이며, 작업도 아닙니다. 이러한 구분은 각기 다른 게시물이 있을 만큼 중요합니다: 회의록과 결정 로그는 문서 수준을 다루고, 작업 항목과 결정는 작업 수준을 다룹니다. 이 게시물은 두 게시물이 다시 참조하는 방법을 설명합니다.

하나의 범위 주의: 중요한 결정. 오프사이트를 어디에서 개최할지는 기록할 필요가 없습니다. 6개월 후에 다시 논의하고 싶지 않은 사항 — 아키텍처, 공급업체, 가격, 정책, 채용 기준 — 는 기록해야 합니다. 유용한 테스트: 미래의 동료가 "왜 이렇게 되었나요?"라고 그럴듯하게 물어볼 수 있다면, 그 결정은 기록할 자격이 있습니다.

문서화되지 않은 결정이 실제로 비용이 얼마나 드는가

비용은 평범하고 반복적이며 대부분 보이지 않는데, 이는 정상적인 작업으로 위장되어 나타나기 때문입니다. 해결된 질문들이 다시 소송에 회부되며 — 같은 논쟁이 다시 벌어지고, 맥락을 지닌 사람은 빠집니다. 새로운 직원들은 아무도 설명할 수 없는 형태의 시스템을 물려받아, 물건을 부수면서 다시 배우거나 방에 있는 가장 오래된 직원에게 모든 질문을 전달하게 됩니다. 그리고 결과가 잘못되면, 이유가 나빴는지 운이 나빴는지 알 방법이 없으므로, 과정은 결코 개선되지 않습니다.

더 날카로운 측면도 있다: 책임. 결정이 기억 속에만 존재할 때, 그 역사는 이를 다시 이야기하는 사람에 의해 다시 쓰여진다 — 보통은 그들의 이익을 위해서. 기록은 중요한 순간에 그 이유를 검토할 수 있게 하며, 이는 진정한 결정 감사 추적의 기초가 된다. 우리는 복합 비용 자체에 대한 짧은 동반 기사를 작성했다: 문서화되지 않은 결정의 비용.

이미 존재하는 프레임워크와 그들이 남기는 간극

이 관행을 새로 만들 필요는 없습니다; 여러 신뢰할 수 있는 프레임워크가 이를 다룹니다. 그러나 각 프레임워크가 실제로 무엇을 다루는지 주목할 가치가 있습니다. 왜냐하면 가장 인기 있는 것들은 이 게시물이 다루고 있는 문제와는 다른 문제를 해결하기 때문입니다.

패턴을 주목하세요: 네 가지 유명한 프레임워크 중 세 가지가 역할을 할당합니다; 오직 ADR만이 기록을 생성합니다. 역할과 기록은 상호 보완적인 절반입니다 — RAPID 또는 DACI는 누가 D를 가지고 있는지를 알려줍니다; 기록은 D가 무엇을 결정했는지와 그 이유를 보존합니다. "우리는 결정 프로세스가 있다"고 느끼는 대부분의 팀은 역할 프레임워크를 채택하고 기록을 완전히 건너뛰었습니다. 이것이 아래의 일곱 개 분야가 채우는 간극입니다. 하나의 프레임워크가 경계를 넘고 있으며, 이는 역할 프레임워크가 생성하는 기록에 가장 가까운 것이기 때문에 언급할 가치가 있습니다: SPADE (Gokul Rajaram, Google, Facebook 및 Square에서 사용됨)는 다른 역할들이 할당하는 역할에 대안과 설명을 추가합니다 — 아래의 일곱 개 분야 중 두 개로, 결정하는 순간에 포착됩니다. 여전히 결정이 아닌 결정 회의에 따라 조직되므로 아직 로그는 아닙니다; 그러나 이미 SPADE를 운영하는 팀은 하나의 로그에서 두 개의 필드가 있습니다. 짧은 버전은 다섯 글자로 된 SPADE 프레임워크이며, 네 개의 역할 프레임워크는 결정 권한 가이드에서 나란히 있습니다.

포착할 내용: 일곱 가지 분야

이것은 Argumentree의 고유 템플릿입니다 — 외부 표준이 아니라 우리가 사용하고 추천하는 합성입니다: ADR의 기록 규율에 일반 팀 결정이 필요로 하는 두 가지 요소(명시된 소유자와 검토 날짜)를 추가한 것입니다. 그대로 가져가세요.

복사할 수 있는 기록

실제로 일곱 개의 필드는 반 페이지에 맞습니다. 압축된 작업 예:

그것이 전체 아티팩트입니다. 내년에 팀에 합류하는 사람은 그것을 40초 안에 읽고 결정된 사항, 이긴 것, 비용, 그리고 언제 다시 올라오는지를 알 수 있습니다. 이를 세 번의 회의록과 비교해 보세요.

그것을 고정시키는 방법들

템플릿은 실패하지 않지만, 습관은 실패합니다. 결정 로그가 살아 있는 팀과 두 주 후에 로그가 사라지는 팀을 구분짓는 네 가지 관행이 있습니다:

일반적인 실수

대부분의 포기된 결정 로그는 네 가지 실패 모드에 해당합니다:

우리는 애자일입니다 — 이게 단순히 문서 작업의 부담이 아닌가요?

가장 강력한 반대 의견은 제대로 언급할 가치가 있다: 문서화에는 실제 비용이 들고, 대부분의 문서는 읽히지 않으며, 작업에 대해 글을 쓰는 데 에너지를 소비하는 팀은 아무런 이득 없이 스스로를 느리게 만들었다. 애자일의 통찰력 — 포괄적인 문서화보다 작동하는 소프트웨어 — 은 실제 문제에 대한 수정이었다.

답은 이의 제기가 잘못된 아티팩트를 겨냥하고 있다는 것입니다. Nygard는 바로 이 이유로 애자일 팀을 위해 ADR을 작성했습니다. 기록은 반 페이지로, 지식이 자유로울 때 한 번 작성됩니다. 그리고 그 기록의 독자는 감사자가 아니라 미래의 당신입니다. 11개월 후, 통합을 바라보며 그 이유를 궁금해하고 있습니다. 비용 비대칭은 극단적입니다: 결정 시점에서의 5분과 이후 재소송을 위한 3회의 회의입니다. 이것은 회의를 피함으로써 스스로 비용을 충당하는 드문 문서입니다.

정직한 경고: 이 실천은 프로세스 연극으로 강요될 때 실패합니다 — 아무도 믿지 않는 필수 항목, 체크박스를 만족시키기 위해 작성된 기록. 팀이 예방하는 고통을 느꼈을 때 효과가 있습니다. 만약 당신의 팀이 아직 결정을 잃은 적이 없다면, 다음 중요한 통화에 대한 하나의 로그 항목으로 시작하고 첫 번째 "잠깐, 우리는 이걸 기록했어!" 순간이 습관을 판매하도록 하세요.

Argumentree가 결정을 자동으로 문서화하는 방법

위의 모든 내용은 위키 페이지와 함께 작동합니다. 우리가 Argumentree를 만든 이유는 수동으로 캡처하기 가장 어려운 분야가 3번 필드인 주장이기 때문입니다. 주장은 실시간으로 논의 중에 발생하며, 이후에 그것을 기록하는 것은 기억에서 요약하는 것을 의미합니다. Argumentree에서는 심의 자체가 구조화되어 있습니다: 질문이 명확하고, 옵션과 그에 대한 찬반 주장이 나무 구조를 형성하며, 평가 결과 어떤 주장이 실제로 결정을 이끌었는지를 보여줍니다.

즉, 결정 기록은 회의 후에 누군가 작성하는 문서가 아닙니다 — 회의 자체의 구조가 보존된 것입니다. 모든 일곱 개 필드는 자동으로 생성됩니다: 질문, 옵션, 논거, 결정, 근거(승리한 논거 경로), 소유자, 검토 날짜. 전사 단계가 없고, 기억의 왜곡이 없으며, 모든 미래의 독자가 전체 논리를 검토할 수 있습니다. 회의 인텔리전스에서 끝에서 끝까지 확인해 보세요. 이번 주에 실제 결정에 이 형식을 사용해 보고 싶다면, 무료로 시작하여 다음 결정을 내릴 때 문서화할 수 있습니다.

결정은 자산이다 — 만약 당신이 그것들을 유지한다면

스마트해지는 조직과 바쁘게 지내는 조직의 차이는 지능이 아니라 기억이다. 작업은 완료되고 사라지지만, 그 이유와 함께 유지되는 결정은 누적된다: 선례가 형성되고, 패턴이 드러나며, 리뷰는 프로세스가 스스로 개선되도록 가르친다.

보다 심각하게 느껴지는 것보다 작게 시작하세요. 다음 중요한 결정: 5분, 7개 분야, 1개의 검색 가능한 홈, 1개의 리뷰 날짜. 새로운 엔지니어링 리드가 "왜 우리가 이걸 스스로 만들지 않았나요?"라고 물었을 때 — 누군가가 3회의 회의 대신 40초 읽기로 대답한다면 — 그 실천은 영구적으로 그 자체로 비용을 지불하게 될 것입니다.