docs: add contents blocks

docs/ai/android.md

@@ -2,6 +2,13 @@
 
 You are here: [AI Docs Home](index.md) > Android Setup
 
+## Contents
+- Setup
+- Android-Specific Guidance
+- MCP For Android
+- Android Troubleshooting
+- Next Steps
+
 ## Setup: VS Code + GitHub Copilot Extension
 ### Prerequisites
 - VS Code installed and up to date.

docs/ai/cross-platform.md

@@ -2,6 +2,17 @@
 
 You are here: [AI Docs Home](index.md) > Cross-Platform AI Usage
 
+## Contents
+- Instructions (Always-On Rules)
+- Agents.md
+- Agents vs Skills
+- Prompting Patterns
+- Prompting Anti-Patterns
+- Plan-First Workflow
+- Starter Prompts
+- MCP Overview
+- Next Steps
+
 ## Instructions (Always-On Rules)
 Instructions are repo-scoped rules that auto-apply based on file patterns. They are always on and do not need to be invoked.
 

docs/ai/governance.md

@@ -2,6 +2,16 @@
 
 You are here: [AI Docs Home](index.md) > Governance, Privacy, and Policy
 
+## Contents
+- Allowed Data
+- Handle With Care
+- Forbidden Data
+- Safe Prompt Examples
+- Redaction Tips
+- Compliance Expectations
+- Ownership
+- Next Steps
+
 ## Allowed Data
 - Public information or approved internal content.
 - Code that is already in approved repos.

docs/ai/index.md

@@ -2,6 +2,13 @@
 
 You are here: AI Docs Home
 
+## Contents
+- Guided Paths
+- Start Here
+- Use AI Day-To-Day
+- Safety And Cost
+- iOS MCP Details
+
 Welcome. This section is the entry point for AI enablement. It assumes no prior knowledge and is safe to follow step-by-step.
 
 ## Who This Is For

docs/ai/ios-xcodebuildmcp.md

@@ -2,6 +2,14 @@
 
 You are here: [AI Docs Home](index.md) > XcodeBuildMCP (iOS)
 
+## Contents
+- What XcodeBuildMCP Is
+- What It Can Do
+- Xcode 26.3 MCP Setup
+- Standardize The Simulator
+- References
+- Next Steps
+
 This page focuses on MCP-based Xcode workflows and the XcodeBuildMCP setup.
 
 ## What XcodeBuildMCP Is

docs/ai/ios.md

@@ -2,6 +2,14 @@
 
 You are here: [AI Docs Home](index.md) > iOS Setup
 
+## Contents
+- Setup Path A (Xcode)
+- Setup Path B (VS Code)
+- iOS-Specific Guidance
+- MCP For iOS
+- iOS Troubleshooting
+- Next Steps
+
 ## Setup Path A: Xcode + GitHub Copilot for Xcode
 ### Prerequisites
 - Xcode installed and up to date.

docs/ai/overview.md

@@ -2,6 +2,16 @@
 
 You are here: [AI Docs Home](index.md) > AI Overview
 
+## Contents
+- Start Here
+- Quick Setup Verification
+- Terminology
+- Where AI Assets Live
+- Agents vs Skills
+- How To Evaluate AI Output
+- Chat Types And Modes
+- Guardrails And Next Steps
+
 ## Start Here
 AI tools help with drafting, refactoring, explaining code, and accelerating routine tasks. They are not a replacement for engineering judgment, security review, or domain knowledge.
 

docs/ai/skills.md

@@ -2,6 +2,13 @@
 
 You are here: [AI Docs Home](index.md) > Skills Library
 
+## Contents
+- Skills vs Agents vs Instructions
+- Skills Governance And Sync
+- How To Connect Skills
+- Central Assets Repo
+- Next Steps
+
 ## Skills vs Agents vs Instructions
 - Skills are reusable workflows you load for specific tasks.
 - Agents are full modes/personas that control behavior end-to-end.

docs/ai/troubleshooting.md

@@ -2,6 +2,16 @@
 
 You are here: [AI Docs Home](index.md) > Troubleshooting and FAQ
 
+## Contents
+- Common Setup Issues
+- Quick Diagnostic Flow
+- Quick Setup Verification Checklist
+- Extension Or Plugin Conflicts
+- Company Network Restrictions
+- Low-Quality Suggestions
+- Escalation
+- Next Steps
+
 ## Common Setup Issues
 - Cannot sign in: confirm GitHub access and SSO.
 - No suggestions: verify Copilot is enabled in the editor.

docs/ai/usage-tokens.md

@@ -2,6 +2,16 @@
 
 You are here: [AI Docs Home](index.md) > Usage and Token Budgeting
 
+## Contents
+- How Tokens Are Spent
+- Chat Context
+- Model Choice Matters
+- Chat Modes And Cost
+- Best Practices To Reduce Usage
+- Red Flags
+- Quick Checklist
+- Next Steps
+
 ## How Tokens Are Spent
 Tokens are consumed based on input length, output length, and tool usage. Long prompts and repeated context increase usage quickly.