From 5b514f80ff8fc9fddc27c12c77fac4d6c96d0cc0 Mon Sep 17 00:00:00 2001
From: Matt Bruce <matt.bruce1@toyota.com>
Date: Wed, 11 Feb 2026 10:58:40 -0600
Subject: [PATCH] docs: add doc navigation rules

---
 Agents.md | 9 +++++++++
 1 file changed, 9 insertions(+)

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.