docs: improve navigation and routing

docs/ai/android.md

@@ -61,3 +61,8 @@ Refactor this file to reduce duplication without changing behavior.
 - Copilot access not provisioned for the GitHub account.
 - VS Code extension disabled after an update.
 - Multiple AI extensions competing for suggestions.
+
+## Next Steps
+- For workflow patterns, read [Cross-Platform AI Usage](cross-platform.md).
+- For safety rules, read [Governance, Privacy, and Policy](governance.md).
+- For cost guidance, read [Usage and Token Budgeting](usage-tokens.md).

docs/ai/cross-platform.md

@@ -155,3 +155,8 @@ Use the build MCP tool to run the build and summarize any errors.
 ### Where To Learn More
 - iOS examples: see [iOS Setup](ios.md)
 - Android examples: see [Android Setup](android.md)
+
+## Next Steps
+- If you need skills guidance, read [Skills Library](skills.md).
+- For safety rules, read [Governance, Privacy, and Policy](governance.md).
+- If setup is not working, follow [Troubleshooting and FAQ](troubleshooting.md).

docs/ai/governance.md

@@ -44,3 +44,7 @@ Example prompt:
 ```text
 Is it ok to share this log snippet with user IDs in Copilot?
 ```
+
+## Next Steps
+- For day-to-day workflows, read [Cross-Platform AI Usage](cross-platform.md).
+- For cost guidance, read [Usage and Token Budgeting](usage-tokens.md).

docs/ai/index.md

@@ -14,6 +14,12 @@ Follow the steps in order. Do not skip ahead if this is your first time.
 3. Skim [Usage and Token Budgeting](usage-tokens.md)
 4. Return to [Cross-Platform AI Usage](cross-platform.md)
 
+## Guided Paths (Pick One)
+- New to AI: [AI Overview](overview.md) -> [Cross-Platform AI Usage](cross-platform.md) -> [Usage and Token Budgeting](usage-tokens.md)
+- iOS setup: [AI Overview](overview.md) -> [iOS Setup](ios.md) -> [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md)
+- Android setup: [AI Overview](overview.md) -> [Android Setup](android.md) -> [Cross-Platform AI Usage](cross-platform.md)
+- Contributors: [AI Overview](overview.md) -> [Governance, Privacy, and Policy](governance.md) -> [Troubleshooting and FAQ](troubleshooting.md)
+
 ## If You Are New
 1. Read the overview to understand terms and guardrails.
 2. Follow the setup guide for your platform.
@@ -28,12 +34,14 @@ If you will edit these docs, start with the "Key Repo Files" section in the over
 - [iOS Setup](ios.md)
 - [Android Setup](android.md)
 
-## Usage Guides
+## Use AI Day-To-Day
 - [Cross-Platform AI Usage](cross-platform.md) - Agents, instructions, prompting patterns, MCP overview, and workflow tips
 - [Skills Library](skills.md)
+
+## Safety And Cost
+- [Governance, Privacy, and Policy](governance.md)
 - [Usage and Token Budgeting](usage-tokens.md)
 - [Troubleshooting and FAQ](troubleshooting.md)
-- [Governance, Privacy, and Policy](governance.md)
 
 ## iOS MCP Details
 - [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md) - Full MCP setup and usage for Xcode workflows

docs/ai/ios-xcodebuildmcp.md

@@ -170,3 +170,7 @@ Apple announced that Xcode 26.3 exposes Xcode capabilities through the Model Con
 
 ### Source
 https://www.apple.com/newsroom/2026/02/xcode-26-point-3-unlocks-the-power-of-agentic-coding/
+
+## Next Steps
+- For iOS setup basics, read [iOS Setup](ios.md).
+- For cross-platform usage patterns, read [Cross-Platform AI Usage](cross-platform.md).

docs/ai/ios.md

@@ -82,3 +82,8 @@ The detailed MCP setup and XcodeBuildMCP guidance is in a dedicated page:
 - Copilot access not provisioned for the GitHub account.
 - Xcode plugin disabled after update.
 - Multiple AI plugins competing for suggestions.
+
+## Next Steps
+- For workflow patterns, read [Cross-Platform AI Usage](cross-platform.md).
+- For MCP automation, read [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md).
+- For safety rules, read [Governance, Privacy, and Policy](governance.md).

docs/ai/overview.md

@@ -198,6 +198,11 @@ Example prompt:
 Refactor only the validation logic in this file. Keep behavior the same and list tests to update.
 ```
 
+## Next Steps
+- If you have not set up an editor yet, go to [iOS Setup](ios.md) or [Android Setup](android.md).
+- For day-to-day usage patterns, read [Cross-Platform AI Usage](cross-platform.md).
+- For safety and cost guidance, read [Governance, Privacy, and Policy](governance.md) and [Usage and Token Budgeting](usage-tokens.md).
+
 ## Getting Help
 - Ask your team lead or the AI docs owner.
 - Use the escalation guidance in [Troubleshooting and FAQ](troubleshooting.md).

docs/ai/skills.md

@@ -86,3 +86,7 @@ Do not list every skill in this guide. Instead, point readers to a single repo t
 ### Link To The Assets Repo
 - Repo: (link)
 
+## Next Steps
+- For day-to-day workflows, read [Cross-Platform AI Usage](cross-platform.md).
+- For setup issues, follow [Troubleshooting and FAQ](troubleshooting.md).
+

docs/ai/troubleshooting.md

@@ -60,3 +60,7 @@ Copilot suggestions stopped in VS Code 1.92 after extension update. Restarted, s
 - Account access issues after setup.
 - Consistent failures across multiple editors.
 - Policy or security concerns.
+
+## Next Steps
+- For setup steps, read [AI Overview](overview.md).
+- For safe usage rules, read [Governance, Privacy, and Policy](governance.md).

docs/ai/usage-tokens.md

@@ -196,3 +196,7 @@ Agent: Refactor these two files, update tests, and summarize results.
 - Is the request specific and scoped?
 - Do I need the whole file or just a section?
 - Can I ask for a plan first?
+
+## Next Steps
+- For workflow patterns, read [Cross-Platform AI Usage](cross-platform.md).
+- For troubleshooting, read [Troubleshooting and FAQ](troubleshooting.md).