Agentic Development Setup - 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.

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.

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:

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.

Open the full project

Open the root folder that contains AGENTS.md and SwiftAIBoilerplatePro.xcodeproj.

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.

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.

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.

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.

Apple Platform Skills

Apple platform conventions, Xcode project structure, SwiftUI, App Store review awareness, and platform-idiomatic patterns.Run in terminal:

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

iOS Simulator

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:

/plugin marketplace add conorluddy/ios-simulator-skill
/plugin install ios-simulator-skill@conorluddy

Source: conorluddy/ios-simulator-skill

SwiftUI Best Practices

State management (@State, @Binding, @Observable), view architecture, performance, accessibility, animations, and Liquid Glass (iOS 26).Run in terminal:

npx skills add AvdLee/SwiftUI-Agent-Skill --all

Source: AvdLee/SwiftUI-Agent-Skill

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.

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 for editions and availability.

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

​How It Works

​Xcode Coding Intelligence

​Recommended Skills

Apple Platform Skills

iOS Simulator

SwiftUI Best Practices

​Skill-Module Mapping

​Further Reading

How It Works

Xcode Coding Intelligence

Recommended Skills

Skill-Module Mapping

Further Reading