업데이트 내역

변경 기록

2026-05-24

변경 요약

• 에이전틱 문서화의 중심 메시지를 "AI-readable"에서 "agent-operable"로 확장
• AI-readable 문서 설계 원칙에 실행 가능성 원칙과 Skill/MCP 분리 기준 추가
• AGENTS.md, AGENTS.override.md, Codex instruction discovery, 32 KiB 기본 제한 반영
• Claude Code의 CLAUDE.md, CLAUDE.local.md, @import, .claude/rules/, path-scoped rules 구조 반영
• 신규 챕터 문서에서 스킬·플러그인·MCP로 추가
• 신규 챕터 에이전트 문서 보안 추가
• 신규 부록 템플릿 모음 추가
• Skills, Plugins, MCP Tools/Resources/Prompts의 역할과 분리 기준 추가
• API 문서 & 스펙을 OpenAPI 3.2.0, streaming, query, MCP Tool schema 기준으로 재작성
• AI와 협업하는 문서 작성 프로세스를 소스 스캔→초안→결정적 검증→에이전트 smoke test 루프로 재작성
• 런북 & 운영 문서에 Diagnose/Recommend/Act 권한 모드와 MCP Tool 승인 경계 추가
• 지식기반 (KB) & 내부 위키에 RAG chunking, citation-first 답변, MCP Resource URI, retrieval eval 추가
• 팀 문서화 문화 만들기를 agent instruction governance와 owner/review policy 중심으로 재작성
• llms.txt를 제안/관례로 명확히 표현하고 SEO·크롤링 보장으로 오해될 표현 제거
• 문서 유지보수 전략에 instruction drift, Skill/Plugin drift, MCP Resource freshness, 에이전트 smoke test 추가
• 검증 리포트를 2026년 5월 24일 기준으로 갱신

영향 챕터

• index
• why-change
• ai-readable-design
• ai-writing-process
• project-rules
• agent-surfaces
• agent-security
• api-docs
• readme-onboarding
• runbook
• knowledge-base
• maintenance
• team-culture
• templates
• verification
• updates

근거 링크

• OpenAI Codex: Custom instructions with AGENTS.md
• OpenAI Codex: Skills
• OpenAI Codex: Build plugins
• Claude Code: How Claude remembers your project
• Claude Code: Skills
• Model Context Protocol: Understanding MCP servers
• Model Context Protocol Schema Reference
• MCP Security Best Practices
• OpenAPI Specification v3.2.0
• OpenAPI Initiative: Announcing OpenAPI v3.2
• OWASP Top 10 for LLM Applications
• AGENTS.md
• The /llms.txt file

2026-03-26

변경 요약

• 신규 핸드북 초판 생성 (12챕터 + 부록)

영향 챕터

• 전체

템플릿

### YYYY-MM-DD

**변경 요약**

- ...

**영향 챕터**

- `...`

**근거 링크**

- ...