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

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

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

---

[에이전틱 문서 설계](/courses/agentic-documentation) 2. 규칙·결정·스펙·런북 3 / 9

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

AGENTS.md, ADR, API 스펙, 런북, KB의 책임 경계
개념 학습 45 XP 9분

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

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

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

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

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

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

실무에 남길 기준

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

[이전](/courses/agentic-documentation/lessons/ad-m1-quiz) 이해했어요 · 계속

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact