SwiftAgent

AI-powered agents for modern Swift/SwiftUI development with GitHub Copilot

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, implementation, utilities 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 for GitHub Copilot (Xcode)

Copy the .github/ folder to your Swift project:

# Copy agents and skills to your project
cp -r .github/agents /path/to/your/project/.github/
cp -r .github/skills /path/to/your/project/.github/
cp .github/copilot-instructions.md /path/to/your/project/.github/

Then open your project in Xcode — agents will appear in the Copilot GUI.

MCP Server (Recommended)

The SwiftAgent MCP Server provides universal access to all agents, skills, and tools from any MCP-compatible IDE (Cursor, Claude Desktop, VS Code, etc.).

# 1. Install and build the MCP server
cd mcp-server && npm install && npm run build

For Cursor / Claude Desktop, add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json or Cursor settings):

{
  "mcpServers": {
    "swift-agent": {
      "command": "node",
      "args": ["/path/to/swift-agent/mcp-server/dist/index.js"]
    }
  }
}

Available Tools:

• list_resources — List all agents, skills, and rules
• load_resource — Load a specific agent, skill, or rule by name
• search_swiftagent — Search across all SwiftAgent resources
• get_simulator — Get the best iOS Simulator UDID
• search_codebase — Search code with ripgrep

Available Prompts: All 12 agents are exposed as MCP prompts. Use @swift-architect, @tca-engineer, etc.

Static Installation (GitHub Copilot)

For Copilot-only workflows, copy files directly:

What's Included

12 Specialized Agents

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

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

swift-agent/
├── .github/
│   ├── agents/                         # 12 Copilot agents
│   ├── skills/                         # 17 knowledge skills
│   ├── prompts/                        # Session management prompts
│   └── copilot-instructions.md         # Global instructions
├── mcp-server/                         # MCP Server (TypeScript)
│   ├── src/index.ts                    # Server entry point
│   ├── package.json                    # npm configuration
│   └── dist/                           # Compiled output
├── mcp/                                # MCP development resources (internal)
├── rules/                              # Development rules & patterns
├── scripts/                            # Automation scripts
├── VERSION                             # Project version
├── LICENSE                             # MIT License
└── README.md                           # Documentation

Development Workflow

Bumping Version

When making changes, increment the version:

bash scripts/bump-plugin-version.sh <new-version>

Adding Agents or Skills

1. Create new agent or skill file in .github/agents/ or .github/skills/
2. Update references in copilot-instructions.md if necessary
3. Test in Xcode with Copilot

Code Organization

• Agents (.github/agents/) — Each agent has a .md file with metadata and instructions
• Skills (.github/skills/) — Knowledge resources agents reference, organized by topic
• Rules (rules/) — Development practices and decision-making frameworks
• Scripts (scripts/) — Utility shell scripts for automation

Architecture & Design Principles

The plugin implements several key principles:

• Ultra-Specialization — Each agent has one clear responsibility with defined handoffs
• 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 README.md for architecture details, workflow diagrams, and handoff models.

License

MIT License — See LICENSE file for details.

Credits

Author: John Rogers Repository: swift-agent Swift Version: 6.2+ iOS Deployment Target: 26.0+

---

For detailed documentation, agent specifications, and usage examples, see the Agents docs.