diff --git a/Agents.md b/Agents.md index ac66366..2aff1aa 100644 --- a/Agents.md +++ b/Agents.md @@ -44,6 +44,15 @@ When using AI to add or change docs in this repo: 4. Update the index when adding new markdown files. 5. Verify formatting (bullets, code blocks, and links) before commit. +## Doc Navigation Pattern (Required) +If you add, remove, or rename any file under docs/ai: + +1. Update [docs/ai/index.md](docs/ai/index.md) with the new or removed entry. +2. Add or update the page breadcrumb ("You are here") on the page. +3. Add or update the page "Contents" block. +4. Add or update the "Next Steps" block so readers can navigate forward. +5. Verify all links still resolve. + ## When A New Chat Starts If you had to restart a chat and re-explain the goal, add a short reminder so the assistant places content in the reader-facing docs instead of workflow files.