공식 스킬 · 운영·관리
의사결정 기록(의사결정 로그 항목)
결정 사항을 짧은 로그 항목으로 남긴다. 결정, 배경, 검토한 선택지, 이유, 결정자, 날짜, 상태, 다시 검토할 조건을 적는다.
Claude, ChatGPT, 코딩 에이전트에서 쓸 수 있어요. Team, Business 요금제에서는 포드에 넣은 공식 스킬이 개선될 때마다 알아서 최신 버전으로 바뀌어요.
언제 쓰나요
- 되돌리기 어렵거나 나중에 질문이 나올 결정을 팀이 막 내렸을 때
- 왜 그렇게 정했는지 계속 묻는데 답이 어디에도 적혀 있지 않을 때
AI에게 주는 것
- 무엇을 누가 정했는지
- 날짜
- 논의한 선택지와 밀린 이유
- 스레드, 회의록, 문서(선택)
받는 결과
상태, 결정자, 배경, 선택지, 이유, 결과, 다시 검토할 조건을 담은 번호 붙은 마크다운 의사결정 로그 항목.
진행 방법
- 결정을 능동문 한 문장으로 쓰기 Nygard는 결정 섹션을 "in full sentences, with active voice"(완전한 문장, 능동태로) 쓰고, 보통 "We will(우리는 ~한다)"로 시작한다고 했다. 예: "우리는 3월 1일부터 Dealbook을 CRM으로 쓴다."
- 배경을 2~4문장으로 쓰기 선택을 하게 만든 사실과 압박: 마감, 비용, 고객, 제약. Nygard는 이 섹션이 "is value-neutral. It is simply describing facts."라고 했다. 가치 판단 없이 사실만 기술한다는 뜻이다. 의견은 이유에 쓴다.
- 검토한 선택지 나열하기 한 줄에 하나씩, 핵심 트레이드오프와 함께. Atlassian의 DACI 플레이는 선택지별 장점, 단점, 비용을 표로 정리한다. "아무것도 하지 않기"가 실제 선택지였다면 넣는다. 실제로 논의한 선택지만 쓴다.
- 이유 쓰기 배경과 연결되는 항목 2~4개로, 이 안이 다른 안보다 나았던 이유를 쓴다. 그다음 좋은 결과와 나쁜 결과를 모두 적는다. Nygard: "All consequences should be listed here, not just the 'positive' ones."(긍정적인 결과만이 아니라 모든 결과를 적는다)
- 결정한 사람과 의견을 들은 사람 적기 결정자는 한 명(Atlassian의 DACI 플레이는 이를 Approver라고 부르고, "the one person (yes: one!) who makes the decision", 즉 결정을 내리는 단 한 사람이라고 설명한다), 그리고 의견을 들은 사람들. 영국 정부의 ADR 프레임워크도 의견을 들은 이해관계자를 기록한다.
- 다시 검토할 조건 정하기 결정을 다시 열 구체적인 조건: 날짜, 숫자, 사건("영업 담당자가 20명을 넘으면", "가격이 예산을 넘으면", "내년 3월 1일에 재검토"). 이 스킬의 기본값: 모든 기록에 하나씩 둔다. "없음"은 결정이 정말 영구적일 때만 쓰고, 그 이유를 적는다.
- 상태와 번호 정하기 제안됨, 승인됨, 대체됨 중 하나. Nygard의 형식처럼 항목에 순서대로 번호를 매기고 같은 번호를 다시 쓰지 않는다. 예전 결정을 대체한다면 예전 항목에 "#[n]으로 대체됨"을 표시하고 지우지 않는다. Nygard도 뒤집힌 결정을 "around, but mark it as superseded", 즉 남겨 두고 대체됨으로 표시한다.
팀과 함께 쓰기
AI Skill Pod에 추가하면 외부 협력자를 포함해 팀원 모두가 자기 AI에서 같은 버전을 써요. 팀에서 AI 스킬을 공유하는 방법 읽기
변경 기록
- v1.0.0 · · First release.
출처
출처는 영어 페이지예요.
- Documenting architecture decisions (Michael Nygard, Cognitect) (2026-11-04 확인)
- Architectural Decision Records (ADRs) (2026-11-04 확인)
- Architectural Decision Record Framework (GOV.UK) (2026-11-04 확인)
- DACI: a decision-making framework (Atlassian Team Playbook) (2026-11-04 확인)