# AI Documentation

You are here: AI Docs Home

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
You can be an expert engineer and still be new to AI. This guide explains every step and includes examples to keep you from guessing.

## How To Use This Guide
Follow the steps in order. Do not skip ahead if this is your first time.

### Example Path (New iOS Engineer)
1. Read [AI Overview](overview.md)
2. Follow [iOS Setup](ios.md)
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.
3. Skim skills and usage tips before your first session.

### Key Repo Files (For Contributors)
If you will edit these docs, start with the "Key Repo Files" section in the overview:
- [AI Overview](overview.md)

## Start Here
- [AI Overview](overview.md)
- [iOS Setup](ios.md)
- [Android Setup](android.md)

## 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)

## iOS MCP Details
- [XcodeBuildMCP (iOS)](ios-xcodebuildmcp.md) - Full MCP setup and usage for Xcode workflows

## Confluence Mapping
This folder maps 1:1 to Confluence pages so content can be copied without rework.