ai-docs/docs/ai/index.md

AI Documentation

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
2. Follow iOS Setup
3. Skim Usage and Token Budgeting
4. Return to Cross-Platform AI Usage

Guided Paths (Pick One)

• New to AI: AI Overview -> Cross-Platform AI Usage -> Usage and Token Budgeting
• iOS setup: AI Overview -> iOS Setup -> XcodeBuildMCP (iOS)
• Android setup: AI Overview -> Android Setup -> Cross-Platform AI Usage
• Contributors: AI Overview -> Governance, Privacy, and Policy -> Troubleshooting and FAQ

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

Start Here

• AI Overview
• iOS Setup
• Android Setup

Use AI Day-To-Day

• Cross-Platform AI Usage - Agents, instructions, prompting patterns, MCP overview, and workflow tips
• Skills Library

Safety And Cost

• Governance, Privacy, and Policy
• Usage and Token Budgeting
• Troubleshooting and FAQ

iOS MCP Details

• XcodeBuildMCP (iOS) - 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.