> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swiftaiboilerplate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentic Development Setup

> Set up Claude Code for agentic iOS development with SwiftAI Boilerplate Pro

SwiftAI Boilerplate Pro ships with a production-tested `AGENTS.md` at the repository root that gives Claude Code and Claude-powered agents project context from the first message. It points the agent to the full guidelines in `docs/CLAUDE.md`. Combined with community skills, Claude understands your architecture, follows your patterns, and can build and verify features autonomously.

<Info>
  **Ready out of the box.** `AGENTS.md` is at the root of the boilerplate and references `docs/CLAUDE.md`. Open Claude Code or Xcode Coding Intelligence from the project directory so the agent can load these automatically.
</Info>

## How It Works

`AGENTS.md` and `docs/CLAUDE.md` tell Claude about **your project**: the MVVM architecture, module boundaries, which abstractions to use, build commands, and what patterns to follow.

Community skills teach Claude about **iOS development in general**: SwiftUI best practices, App Store guidelines, simulator automation.

| Layer                | What It Provides                                  | File                                  |
| -------------------- | ------------------------------------------------- | ------------------------------------- |
| **Project-specific** | Architecture, abstractions, module boundaries     | `AGENTS.md` (root) → `docs/CLAUDE.md` |
| **Domain-wide**      | iOS best practices, debugging, testing, App Store | Community skills                      |

Together, they let Claude generate code that fits your project and follows platform conventions.

***

## Xcode Coding Intelligence

Xcode Coding Intelligence with Claude Agent works well with SwiftAI Boilerplate Pro as long as the agent is opened from the repository root. The important files are:

```text theme={null}
SwiftAIBoilerplatePro/
├── AGENTS.md
├── SwiftAIBoilerplatePro.xcodeproj
├── Packages/
└── docs/
    └── CLAUDE.md
```

`AGENTS.md` must stay in the project root; it points the agent to `docs/CLAUDE.md`. If an agent says it cannot see the project instructions, check that you opened the repository folder itself, not only the `docs/` folder or an individual Xcode file.

<Steps>
  <Step title="Open the full project">
    Open the root folder that contains `AGENTS.md` and `SwiftAIBoilerplatePro.xcodeproj`.
  </Step>

  <Step title="Start Claude Agent in Xcode">
    Use Xcode Coding Intelligence from that project context. The boilerplate instructions are already written for SwiftUI, MVVM, Swift Packages, Supabase, RevenueCat, OpenRouter, and strict concurrency.
  </Step>

  <Step title="Verify the agent loaded context">
    Ask: "Before coding, summarize the rules from `docs/CLAUDE.md` that apply to this project." If the answer does not mention SwiftAI Boilerplate Pro modules and build commands, restart the agent from the repository root.
  </Step>
</Steps>

<Tip>
  The auto-loaded entry point is the root `AGENTS.md`, which references `docs/CLAUDE.md`. The other files under `docs/` are human-readable guides and deeper references.
</Tip>

***

## Recommended Skills

You can install community skills to extend Claude's iOS knowledge. Installation methods differ by skill:

* Commands that start with `/plugin` run inside **Claude Code or Claude Agent chat**.
* Commands that start with `git`, `cp`, or `npx` run in your **terminal**.

<CardGroup cols={2}>
  <Card title="Apple Platform Skills" icon="apple">
    Apple platform conventions, Xcode project structure, SwiftUI, App Store review awareness, and platform-idiomatic patterns.

    **Run in terminal:**

    ```bash theme={null}
    git clone https://github.com/rshankras/claude-code-apple-skills.git
    mkdir -p .claude/skills
    cp -R claude-code-apple-skills/skills/* .claude/skills/
    ```

    **Source:** [rshankras/claude-code-apple-skills](https://github.com/rshankras/claude-code-apple-skills)
  </Card>

  <Card title="iOS Simulator" icon="mobile">
    Lets Claude boot, build, install, and interact with the iOS Simulator directly. Your AI can run and test the app it builds.

    **Run in Claude chat:**

    ```text theme={null}
    /plugin marketplace add conorluddy/ios-simulator-skill
    /plugin install ios-simulator-skill@conorluddy
    ```

    **Source:** [conorluddy/ios-simulator-skill](https://github.com/conorluddy/ios-simulator-skill)
  </Card>

  <Card title="SwiftUI Best Practices" icon="paintbrush">
    State management (`@State`, `@Binding`, `@Observable`), view architecture, performance, accessibility, animations, and Liquid Glass (iOS 26).

    **Run in terminal:**

    ```bash theme={null}
    npx skills add AvdLee/SwiftUI-Agent-Skill --all
    ```

    **Source:** [AvdLee/SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill)
  </Card>
</CardGroup>

<Note>
  The boilerplate works without community skills. They are optional additions on top of the included `AGENTS.md` and `docs/CLAUDE.md`, and community repositories may change their install commands over time.
</Note>

<Info>
  **App Generator is a separate product (coming soon).** The agentic workflow on this page uses *your own* coding-agent CLI on the boilerplate source. The App Generator is a standalone macOS tool that drives your agent CLI to scaffold a differentiated app from the template; it ships separately and is not bundled with the boilerplate. See [License & Updates](/pages/reference/license) for editions and availability.
</Info>

***

## Skill-Module Mapping

Which skills help most when working on each boilerplate module:

| Module                    | Best Skills                                   | Why                                                    |
| ------------------------- | --------------------------------------------- | ------------------------------------------------------ |
| **FeatureChat**           | SwiftUI Best Practices, iOS Simulator         | View architecture, state management, simulator testing |
| **Auth**                  | Apple Platform Skills                         | App Store guidelines, security                         |
| **Payments**              | Apple Platform Skills                         | In-app purchase compliance                             |
| **AI**                    | SwiftUI Best Practices                        | Async/await, streaming patterns                        |
| **Storage**               | SwiftUI Best Practices                        | SwiftData best practices                               |
| **DesignSystem**          | SwiftUI Best Practices, Apple Platform Skills | Accessibility, theming                                 |
| **Rating prompt feature** | Apple Platform Skills                         | SKStoreReviewController guidelines                     |
| **Localization**          | Apple Platform Skills, SwiftUI Best Practices | L10n, VoiceOver                                        |

***

## Further Reading

* **[AI-Assisted Development](/pages/guides/ai-assisted-development)**: Cursor and Bolt AI configurations