claude-swift-engineering

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.

Swift Engineering Plugin

The swift-engineering plugin is a production-ready toolkit for professional Swift development:

12 Ultra-Specialized Agents — Planning (Opus), implementation (Inherit), 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
Knowledge Skills — 18 specialized knowledge bases covering architecture patterns, frameworks, design, and development tools

Quick Start

Installation

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-engineering

Hooks (Optional)

Enable 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"
          }
        ]
      }
    ]
  }
}

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.

What's Included

12 Specialized Agents

Type	Agents	Responsibility
Planning	@swift-ui-design, @swift-architect, @tca-architect	Architecture decisions (Opus, read-only)
Implementation	@tca-engineer, @swift-engineer, @swiftui-specialist, @swift-test-creator, @documentation-generator, @swift-code-reviewer, @swift-modernizer	Code creation and review (Inherit)
Utilities	@swift-documenter, @search	API documentation and code search (Haiku)

18 Knowledge Skills

Architecture patterns (TCA, SwiftUI, modern Swift, advanced gestures), frameworks (SQLite, GRDB, StoreKit, networking), platform design (iOS 26, HIG, localization, haptics), and development tools (testing, style, diagnostics). Each skill provides deep guidance on modern patterns and best practices.

For Contributors

Repository Structure

claude-swift-engineering/
├── .claude-plugin/
│   └── marketplace.json                    # Marketplace configuration
├── .github/workflows/                      # CI/CD pipelines
├── plugins/
│   └── swift-engineering/                  # Main plugin
│       ├── agents/                         # 12 specialized agents
│       ├── skills/                         # 18 comprehensive skills
│       ├── hooks-scripts/                  # Hooks system
│       ├── scripts/                        # Helper utilities
│       ├── rules/                          # Development rules
│       └── README.md                       # Plugin documentation
└── worktrees/                              # Git worktrees for features

Development Workflow

Bumping Version

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.

Adding Agents or Skills

Create new agent or skill file following existing patterns (see examples in agents/ or skills/)
Update plugin.json if defining new tool capabilities
Run smoke tests to validate configuration
Update both README files (root and plugin)
Test integration with the workflow

Code Organization

Agents (agents/) — Each agent has a .md file 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

Architecture & Design Principles

The plugin implements several key principles:

Ultra-Specialization — Each agent has one clear responsibility with defined handoffs
Model Stratification — Opus for architecture (best reasoning), Inherit for implementation (cost-effective), 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.

License

MIT License — See LICENSE file for details.

Credits

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.

swift-style