# 문서는 이제 작업 인터페이스다

> AI-readable 구조, progressive disclosure, 명시적 계약

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

---

[Agentic documentation](/en/courses/agentic-documentation) 1. AI-readable 문서 1 / 9

# 문서는 이제 작업 인터페이스다

AI-readable 구조, progressive disclosure, 명시적 계약
Concept 45 XP 9 min

에이전트는 문서의 분위기를 읽지 못하고 구조·범위·우선순위·검증 방법 을 통해 행동합니다. 좋은 문서는 한 화면에 모든 지식을 넣지 않고, 짧은 진입점에서 필요한 상세 문맥과 실행 증거로 이동하게 합니다.
설명보다 탐색과 판정 제목·요약·적용 범위·선행 조건·단계·완료 기준·출처를 명시하고, 같은 용어가 문서마다 다른 의미로 쓰이지 않게 canonical vocabulary를 둡니다.

| 문서 특성 | 사람에게 주는 가치 | 에이전트에게 주는 가치 |
| 짧은 요약과 범위 | 빠른 방향 파악 | 적용 여부 판정 |
| 안정된 제목·링크 | 탐색 비용 감소 | 정확한 retrieval |
| 명시적 단계·입출력 | 재현 가능한 실행 | workflow로 변환 가능 |
| 검증·출처·기준일 | 신뢰도 판단 | 완료와 최신성 판정 |

- 1 독자와 작업 정의 누가 어떤 결정을 위해 읽는지 한 문장으로 씁니다.

- 2 구조화 범위·선행 조건·단계·예외·완료 기준을 고정합니다.

- 3 연결 상세 문서와 실행 도구를 안정된 링크로 잇습니다.

- 4 검증 출처·기준일·테스트·owner를 기록합니다.

실무에 남길 기준

- AI-readable은 쉬운 문장이 아니라 명시적 구조와 계약을 뜻한다
- 긴 문서보다 필요한 문맥만 단계적으로 여는 정보 구조가 유리하다
- 검증 방법과 기준일 없는 문서는 에이전트에게 stale context가 된다

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