문서는 이제 작업 인터페이스다
AI-readable 구조, progressive disclosure, 명시적 계약
에이전트는 문서의 분위기를 읽지 못하고 구조·범위·우선순위·검증 방법을 통해 행동합니다. 좋은 문서는 한 화면에 모든 지식을 넣지 않고, 짧은 진입점에서 필요한 상세 문맥과 실행 증거로 이동하게 합니다.
| 문서 특성 | 사람에게 주는 가치 | 에이전트에게 주는 가치 |
|---|---|---|
| 짧은 요약과 범위 | 빠른 방향 파악 | 적용 여부 판정 |
| 안정된 제목·링크 | 탐색 비용 감소 | 정확한 retrieval |
| 명시적 단계·입출력 | 재현 가능한 실행 | workflow로 변환 가능 |
| 검증·출처·기준일 | 신뢰도 판단 | 완료와 최신성 판정 |
- 독자와 작업 정의누가 어떤 결정을 위해 읽는지 한 문장으로 씁니다.
- 구조화범위·선행 조건·단계·예외·완료 기준을 고정합니다.
- 연결상세 문서와 실행 도구를 안정된 링크로 잇습니다.
- 검증출처·기준일·테스트·owner를 기록합니다.