# 에이전틱 문서 설계 코스

> 문서를 설명 자료에서 작업 인터페이스로 확장합니다. AI-readable 구조, 프로젝트 규칙, ADR·API 스펙·런북을 설계하고, 반복 절차를 스킬·플러그인·MCP로 승격하며 보안과 유지보수까지 운영합니다.

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

---

[에이전트 엔지니어링](/tracks/agent-engineering)

# 에이전틱 문서 설계

사람이 읽고 에이전트가 실행하는 살아 있는 지식 체계

문서를 설명 자료에서 작업 인터페이스로 확장합니다. AI-readable 구조, 프로젝트 규칙, ADR·API 스펙·런북을 설계하고, 반복 절차를 스킬·플러그인·MCP로 승격하며 보안과 유지보수까지 운영합니다.
중급 8레슨 515 XP 약 89분

출처 · 핸드북 · 에이전틱 시대의 문서화 혁신 · 원문 검토 2026-06-20

선수 코스를 먼저 완료해 주세요
[AI 에이전트 오케스트레이션](/courses/agent-orchestration) 완료 후 이 코스를 시작할 수 있어요.

[선수 코스 학습하기](/courses/agent-orchestration)

![에이전트의 도구·컨텍스트·평가 시스템이 연결되는 모습을 표현한 일러스트](/images/home/track-agent-engineering.png)
0%

코스 진행률 9개 학습 단계 기준

## 이 코스를 마치면

- 사람용 설명과 에이전트용 실행 문맥의 차이를 진단할 수 있다
- 진입점·규칙·결정·스펙·런북을 책임별로 분리한 문서 아키텍처를 설계할 수 있다
- 반복 절차를 문서에서 skill·plugin·MCP로 승격할 기준을 세울 수 있다
- 출처·owner·검증·보안·폐기 주기가 있는 문서 운영 체계를 만들 수 있다

1

## 1. AI-readable 문서

검색 가능하고 구조화되며 검증 가능한 문서가 무엇인지 익힙니다.

- 문서는 이제 작업 인터페이스다 AI-readable 구조, progressive disclosure, 명시적 계약 개념 45 XP
- AI-readable 문서 진단 퀴즈 좋은 구조와 위험한 문서 패턴 구분 퀴즈 50 XP

2

## 2. 규칙·결정·스펙·런북

서로 다른 문서 책임을 하나의 정보 구조로 연결합니다.

- 문서 종류마다 결정이 다르다 AGENTS.md, ADR, API 스펙, 런북, KB의 책임 경계 개념 45 XP
- 실전: 결제 정책 변경 문서화 규칙·ADR·스펙·런북에 변경을 배치 시나리오 60 XP

3

## 3. 문서에서 실행 표면으로

반복 절차를 skill·plugin·MCP로 승격하고 권한을 분리합니다.

- 읽는 지식과 실행하는 capability 문서·skill·plugin·MCP를 선택하는 기준 개념 45 XP
- 실행 표면 승격 체크리스트 문서 자동화 전 반복성·권한·복구 검토 체크리스트 55 XP

4

## 4. 보안·품질·유지보수

문서 오염과 비밀 유출을 막고 최신성을 운영 지표로 관리합니다.

- 살아 있는 문서의 수명주기 출처·검토·드리프트·비밀·prompt injection과 폐기 개념 45 XP
- 워크북: 문서 운영 정책 신뢰·최신성·검증·폐기 규칙 수립 워크북 70 XP

## 최종 챌린지

코스에서 배운 내용을 업무에 재사용할 수 있는 산출물로 완성하세요.

- 최종 챌린지 · 에이전틱 문서 아키텍처 한 프로젝트의 지식·규칙·실행·운영 체계를 설계 레슨 완료 후 100 XP

---

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