diff --git a/docs/ai/android.md b/docs/ai/android.md index 10824e9..670f2f3 100644 --- a/docs/ai/android.md +++ b/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. diff --git a/docs/ai/cross-platform.md b/docs/ai/cross-platform.md index 0490a6d..ec853b5 100644 --- a/docs/ai/cross-platform.md +++ b/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. diff --git a/docs/ai/governance.md b/docs/ai/governance.md index 1873eda..e04e39b 100644 --- a/docs/ai/governance.md +++ b/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. diff --git a/docs/ai/index.md b/docs/ai/index.md index d793b32..35963ca 100644 --- a/docs/ai/index.md +++ b/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 diff --git a/docs/ai/ios-xcodebuildmcp.md b/docs/ai/ios-xcodebuildmcp.md index 40b886e..258015a 100644 --- a/docs/ai/ios-xcodebuildmcp.md +++ b/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 diff --git a/docs/ai/ios.md b/docs/ai/ios.md index 260ccba..21cb1f8 100644 --- a/docs/ai/ios.md +++ b/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. diff --git a/docs/ai/overview.md b/docs/ai/overview.md index dd6ab63..ab6264a 100644 --- a/docs/ai/overview.md +++ b/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. diff --git a/docs/ai/skills.md b/docs/ai/skills.md index 5ca02f3..b2677fb 100644 --- a/docs/ai/skills.md +++ b/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. diff --git a/docs/ai/troubleshooting.md b/docs/ai/troubleshooting.md index 9f81489..e8c8722 100644 --- a/docs/ai/troubleshooting.md +++ b/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. diff --git a/docs/ai/usage-tokens.md b/docs/ai/usage-tokens.md index f08104f..ac10fdc 100644 --- a/docs/ai/usage-tokens.md +++ b/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.