diff --git a/docs/planning/AI-Docs-Plan.md b/docs/planning/AI-Docs-Plan.md index 326c406..c1d1494 100644 --- a/docs/planning/AI-Docs-Plan.md +++ b/docs/planning/AI-Docs-Plan.md @@ -42,13 +42,24 @@ The docs under docs/ai map 1:1 to Confluence pages. - planning/ - AI-Docs-Plan.md +## Assets (Non-Guide Content) +Agent prompts and instruction files are stored under assets/ so they can be moved to a separate distribution repo later. + ## Open Items -- Add repo links for each skill in the Skills Library. +- Add link to the central assets repo in Skills Library (single source of truth). - Add screenshots for setup flows. - Define section owners and review cadence. - Add platform-specific prompt examples. - Identify approved Android MCP tools and add details. +## Doc Navigation Pattern (Required) +When adding, removing, or renaming files under docs/ai: +1. Update docs/ai/index.md +2. Update the page breadcrumb ("You are here") +3. Update the page Contents block +4. Update the Next Steps block +5. Verify links still resolve + ## Risks - Docs drift as tools and plugins update. - Unclear ownership leads to stale content.