# 문서 종류마다 결정이 다르다

> AGENTS.md, ADR, API 스펙, 런북, KB의 책임 경계

- Canonical: https://learning.reopt.ai/en/courses/agentic-documentation/lessons/ad-m2-concept
- Language: en
- HTML: https://learning.reopt.ai/en/courses/agentic-documentation/lessons/ad-m2-concept

---

[Agentic documentation](/en/courses/agentic-documentation) 2. 규칙·결정·스펙·런북 3 / 9

# 문서 종류마다 결정이 다르다

AGENTS.md, ADR, API 스펙, 런북, KB의 책임 경계
Concept 45 XP 9 min

프로젝트 규칙은 행동 경계를, ADR은 선택의 이유를, API 스펙은 시스템 계약을, 런북은 장애 대응을 다룹니다. 이들을 한 위키 페이지에 섞으면 최신성·승인·검증 주기가 모두 흐려집니다.
문서 유형은 변경 주기로 분리한다 자주 바뀌는 운영 절차와 오래 남는 설계 결정을 같은 승인 흐름에 두지 않습니다. 각 유형에 owner, 변경 트리거, 검증 방식을 따로 둡니다.

| 문서 | 답해야 할 질문 | 완료 증거 |
| 프로젝트 규칙 | 어떻게 작업해야 하는가 | 필수 명령·금지 패턴·scope |
| ADR | 왜 이 선택을 했는가 | 대안·trade-off·상태·후속 조건 |
| API 스펙 | 시스템이 무엇을 약속하는가 | schema·예제·contract test |
| 런북 | 실패 시 누가 무엇을 하는가 | 탐지·격리·복구·에스컬레이션 |
| KB | 검증된 지식을 어디서 찾는가 | 출처·태그·owner·review date |

- 1 결정 질문 분류 행동·이유·계약·운영·지식 중 하나로 분류합니다.

- 2 정본 지정 중복 복사 대신 canonical 문서와 링크를 정합니다.

- 3 검증 연결 스펙은 contract test, 런북은 drill과 연결합니다.

- 4 변경 트리거 코드·정책·사고 변화가 어떤 문서를 갱신하는지 정합니다.

실무에 남길 기준

- 문서 유형을 책임과 변경 주기로 나누면 충돌이 줄어든다
- API 스펙과 런북은 실행·드릴로 검증되어야 한다
- 중복 설명보다 정본과 안정된 링크가 중요하다

[Previous](/en/courses/agentic-documentation/lessons/ad-m1-quiz) Got it · Continue

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact