Claude Code plugin marketplace for modern Swift/SwiftUI development
A specialized AI toolkit for building professional iOS/macOS features with modern Swift 6.2, TCA (The Composable Architecture), and SwiftUI. This plugin provides ultra-specialized agents that orchestrate planning, implementation, testing, and deployment.
The swift-engineering plugin is a production-ready toolkit for professional Swift development:
- 17 Ultra-Specialized Agents — Planning (Opus 4.8), implementation incl. RealityKit/3D (Sonnet 5), utilities (Haiku) with clear handoffs
- TCA Support — Full workflow from architecture design to testing for The Composable Architecture
- Modern Swift 6.2 — iOS 26+ with strict concurrency, async/await, actors, Sendable
- Code Quality — Integrated code review, accessibility compliance, and performance checks
- AI Feature Quality — Measure Foundation Models / language-model features with the Evaluations framework, across every supported language
- Knowledge Skills — 51 specialized knowledge bases covering architecture patterns, adaptive UI (incl. adaptive toolbars), macOS multiplatform, SwiftData & persistence, App Intents/widgets, Live Activities, media & the now-playing experience, networking, animations, GPU visual effects, charts, security, app integrity (App Attest), Vision, Visual Intelligence, TextKit, on-device AI (Foundation Models, Core AI), RealityKit & 3D/spatial (ECS core, SwiftUI↔RealityKit, rendering, physics & interaction, 3D asset optimization, Reality Composer Pro, USD/USDKit, Object Capture, RealityKit debugging, AR/spatial), observability, performance profiling, release/CI-CD, AI-feature evaluation, design principles, accessibility, performance monitoring, and development tools
Add the plugin to Claude Code:
# Add marketplace source
/plugin marketplace add https://github.com/johnrogers/claude-swift-engineering
# Install swift-engineering plugin
/plugin install swift-engineeringEnable skill/agent evaluation hooks for better workflow discipline:
# 1. Symlink hooks-scripts to ~/.claude
ln -s /path/to/claude-swift-engineering/plugins/swift-engineering/hooks-scripts ~/.claude/hooks-scripts
# 2. Add to ~/.claude/settings.json
{
"hooks": {
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "cat ~/.claude/hooks-scripts/UserPromptSubmit/skill-forced-eval-hook.sh"
},
{
"type": "command",
"command": "cat ~/.claude/hooks-scripts/UserPromptSubmit/agent-forced-eval-hook.sh"
}
]
}
]
}
}Optional evaluation enforcement hooks are also available — a PostToolUse nudge and a Stop gate that ensure any edit to an AI/Foundation Models feature is matched by a created/updated Evaluation (covering every supported language). See the hooks documentation below.
See plugins/swift-engineering/hooks-scripts/README.md for complete hook documentation.
See plugins/swift-engineering/README.md for complete documentation on using agents and available workflows.
| Type | Agents | Responsibility |
|---|---|---|
| Planning | @swift-ui-design, @swift-architect, @tca-architect, @spatial-experience-architect | Architecture decisions incl. 3D/spatial (Opus, read-only) |
| Implementation | @feature-engineer, @tca-engineer, @swiftui-specialist, @realitykit-engineer, @accessibility-specialist, @swift-test-creator, @evaluation-engineer, @architecture-keeper, @swift-code-reviewer, @swift-modernizer | Code creation incl. RealityKit/3D, accessibility, tests, docs (Sonnet 5); code review & AI-feature evaluation (Opus 4.8) |
| Utilities | @swift-documenter, @search | API documentation and code search (Haiku) |
Architecture patterns (TCA, SwiftUI, modern Swift, advanced gestures), adaptive UI (available-space layout for iPhone fold, iPad multitasking & resizable windows), macOS multiplatform (keep the Mac target always buildable and natively adapted — platform gating, iOS-only API fixes, macOS scenes/menus/pointer), persistence (SwiftData as the default entity store — schema, queries, migrations, @ModelActor, CloudKit — plus SQLite/GRDB alternatives), system surfaces (App Intents, widgets, Live Activities, controls) and application networking (URLSession/REST, auth, streaming), motion & data viz (SwiftUI animations, Swift Charts), security (Keychain, biometrics, privacy manifest, CryptoKit) and observability (unified logging, signposts), performance profiling (Instruments/xctrace, hangs & hitches, SwiftUI updates) and release/CI-CD (signing, Xcode Cloud/fastlane, TestFlight, App Store), frameworks (SQLite, GRDB, StoreKit, networking, Foundation Models — on-device + Private Cloud Compute, vision, agentic dynamic profiles, Spotlight RAG; Core AI custom on-device models; the Vision framework; Visual Intelligence; NowPlaying media sessions; App Attest app integrity; TextKit text engine), AI-feature evaluation (the Evaluations framework — datasets, metrics, model judges, judge alignment, evaluation-driven development, every supported language), design (eight design principles, naming/UX writing, responsible AI), accessibility (VoiceOver, Dynamic Type, reading, captions, Nutrition Labels readiness), platform design (iOS 26, HIG, localization, haptics), performance monitoring (MetricKit metrics, diagnostics, state reporting), and development tools (testing, style, diagnostics), RealityKit & 3D/spatial (the ECS core and RealityView, SwiftUI↔RealityKit bridging, materials/lighting/rendering, physics & interaction, 3D asset optimization, Reality Composer Pro authoring, USD/USDKit, Object Capture photogrammetry, the RealityKit debugger, and AR/spatial world integration — RealityKit is Apple's recommended 3D engine now that SceneKit is deprecated). Each skill provides deep guidance on modern patterns and best practices.
claude-swift-engineering/
├── .claude-plugin/
│ └── marketplace.json # Marketplace configuration
├── .github/workflows/ # CI/CD pipelines
├── plugins/
│ └── swift-engineering/ # Main plugin
│ ├── agents/ # 15 specialized agents
│ ├── skills/ # 41 comprehensive skills
│ ├── hooks-scripts/ # Hooks system
│ ├── scripts/ # Helper utilities
│ ├── rules/ # Development rules
│ └── README.md # Plugin documentation
└── worktrees/ # Git worktrees for features
When making changes, increment the plugin version:
bash plugins/swift-engineering/scripts/bump-plugin-version.sh <new-version>This updates version numbers across plugin.json, marketplace.json, and other metadata files.
- Create new agent or skill file following existing patterns (see examples in
agents/orskills/) - Update
plugin.jsonif defining new tool capabilities - Run smoke tests to validate configuration
- Update both README files (root and plugin)
- Test integration with the workflow
- Agents (
agents/) — Each agent has a.mdfile with metadata and instructions - Skills (
skills/) — Knowledge resources agents reference, organized by topic - Hooks (
hooks-scripts/) — Executable hooks that enforce workflows - Scripts (
scripts/) — Utility shell scripts for automation - Rules (
rules/) — Development practices and decision-making frameworks - Documentation (
docs/) — Smoke tests and validation suite
The plugin implements several key principles:
- Ultra-Specialization — Each agent has one clear responsibility with defined handoffs
- Model Stratification — Opus 4.8 for architecture, the code-review gate, and AI-feature evaluation (best reasoning); Sonnet 5 for the rest of implementation (strong coding at lower cost); Haiku for utilities (fast)
- Local-First — Default to SQLite and UserDefaults, never SwiftData or Core Data
- Modern Swift Only — Swift 6.2 with strict concurrency, no deprecated APIs
- Read-Only Planning — Planning agents cannot modify code, ensuring clear separation
- Plan File Coordination — Agents share state via
docs/plans/<feature>.md
See plugins/swift-engineering/README.md for architecture details, workflow diagrams, and handoff models.
MIT License — See LICENSE file for details.
Author: John Rogers Repository: claude-swift-engineering Swift Version: 6.2+ iOS Deployment Target: 26.0+
For detailed documentation, agent specifications, and usage examples, see plugins/swift-engineering/README.md.