Documentation maintenance
August 25, 2026 ยท View on GitHub
How contributor and usage docs stay current. See the setup index for the other setup pages.
- Read
project-intent.mdbefore making product-level changes or writing docs that describe the project's goals. - Follow Documentation principles for usage docs, MCP instruction text, and contributing guides (lightweight pages, current behavior, post-tool detail in responses).
- Update
docs/use/when end-user MCP behavior or guidance changes; updatedocs/contributingwhen contributor workflows, architecture notes, or verification guidance change. - Treat docs updates as part of done work.
- Keep
AGENTS.mdconcise and index-like; put details in focused docs. - When failures repeat, promote lessons from docs into tests, lint rules, or scripts.