Skip to main content
reopt Handbook
reopt Handbook
Agentic Documentation

Paradigm Shift

Why Documentation Must ChangeAI-readable Design PrinciplesAI-assisted Writing Process

Practice by Document Type

Project Rule DocumentsFrom Docs to Skills, Plugins, and MCPAgent Documentation SecurityAPI Docs and SpecsREADME and OnboardingArchitecture Decision RecordsRunbooks and OperationsUser Guides and TutorialsKnowledge Bases and Internal Wikis

Operations

Maintenance StrategyTeam Documentation Culture

Appendix

TemplatesVerification ReportUpdates
Handbook›에이전틱 시대의 문서화 혁신›Updates
한국어English

Updates

Change log for the Agentic Documentation handbook.

Latest Update

June 13, 2026

Change Log

2026-06-13

Summary

  • Fixed English-locale links that pointed to bare /books/... paths, which redirected (308) into the Korean edition. They now point to /en/books/....
  • Updated the affected links on the cover page: the Harness Engineering related-reading link and all Contents card links.
  • General review pass for typo, markdown, and notation consistency.

Affected Chapters

  • index (cover)

2026-05-24

Summary

  • Added the English edition of the Agentic Documentation handbook.
  • Expanded the core framing from AI-readable docs to agent-operable documentation.
  • Added coverage for AGENTS.md, AGENTS.override.md, CLAUDE.md, .claude/rules/, Skills, Plugins, MCP, OpenAPI, RAG, and llms.txt.
  • Added agent documentation security coverage for prompt injection, tool poisoning, excessive agency, and supply chain risk.
  • Added OpenAPI 3.2, MCP Tool schema, annotation limits, RAG freshness, and citation-first KB guidance.
  • Added templates for project rules, Skills, Plugins, MCP Tool/Resource docs, llms.txt, runbooks, KB docs, and security review.

Affected Chapters

  • all English chapters

Source Links

  • 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

Related docs

Verification Report

Source, link, consistency, and build verification for the Agentic Documentation handbook.

API Docs and Specs

Connect OpenAPI 3.2, tool schemas, MCP Resources, and contract tests.

Updates

B2B SaaS Sales and Customer Success · Change log for B2B SaaS Sales and Customer Success.

Updates

AI Security and Compliance Operations · Change log for the AI Security and Compliance Operations handbook.

Release coverage history

Codex Command Master · Codex CLI: Dated release coverage and handbook update decisions, preserved separately from current instructions.

Verification Report

Source, link, consistency, and build verification for the Agentic Documentation handbook.

On this page

Change Log2026-06-132026-05-24