문서 종류마다 결정이 다르다
AGENTS.md, ADR, API 스펙, 런북, KB의 책임 경계
프로젝트 규칙은 행동 경계를, ADR은 선택의 이유를, API 스펙은 시스템 계약을, 런북은 장애 대응을 다룹니다. 이들을 한 위키 페이지에 섞으면 최신성·승인·검증 주기가 모두 흐려집니다.
| 문서 | 답해야 할 질문 | 완료 증거 |
|---|---|---|
| 프로젝트 규칙 | 어떻게 작업해야 하는가 | 필수 명령·금지 패턴·scope |
| ADR | 왜 이 선택을 했는가 | 대안·trade-off·상태·후속 조건 |
| API 스펙 | 시스템이 무엇을 약속하는가 | schema·예제·contract test |
| 런북 | 실패 시 누가 무엇을 하는가 | 탐지·격리·복구·에스컬레이션 |
| KB | 검증된 지식을 어디서 찾는가 | 출처·태그·owner·review date |
- 결정 질문 분류행동·이유·계약·운영·지식 중 하나로 분류합니다.
- 정본 지정중복 복사 대신 canonical 문서와 링크를 정합니다.
- 검증 연결스펙은 contract test, 런북은 drill과 연결합니다.
- 변경 트리거코드·정책·사고 변화가 어떤 문서를 갱신하는지 정합니다.