Skip to main content
subagent CX Codex

swift-engineer — Claude Code subagent: what it does, how to install

swift-engineer — a Claude subagent that writes vanilla Swift for models, services, networking and persistence when the plan rules out TCA.

MIT ★ 233 updated 2026-01-18

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What swift-engineer does

This one handles the plain-Swift side of a feature: models, service objects, network clients, storage. It expects the architecture question to be settled already, with vanilla chosen over TCA, and then it just builds. Inside Claude it works with Read, Write, Edit, Glob, Grep, Bash and Skill.

New files follow a fixed tree under Sources/: Models/, Clients/APIClient/, Services/, Persistence/. Before writing anything substantial it pulls the matching skill, so concurrency goes through modern-swift, connections through swift-networking, storage through sqlite-data, formatting through swift-style. Apple documentation comes from the Sosumi MCP server; with that unavailable it falls back to programming-swift, a 37K+ line reference it keeps for syntax checks and compiler errors.

The target is iOS 26.0+ with Swift 6.2+ and strict concurrency, which is why an older codebase will push back on the patterns it produces. Expect @MainActor on UI code and Sendable on anything crossing an isolation boundary.

What it helps with

  • Build models and a networking layer in plain Swift, no TCA
  • Put new files in Sources/Models, Clients, Services and Persistence
  • Wire SQLite storage through the sqlite-data skill
  • Move service code to async/await with strict concurrency
  • Check whether an Apple API is deprecated via Sosumi MCP

Example prompts for the agent

  • Implement the API client in Sources/Clients/APIClient/ in vanilla Swift, skip TCA
  • Add a SQLite store for bookmarks under Sources/Persistence
  • Rewrite this service with async/await and make the types Sendable

How to install swift-engineer

1Plugin marketplace

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

2Manually: put the files in place

.claude/agents/swift-engineer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about swift-engineer

How do I install swift-engineer in Claude Code?

Run /plugin marketplace add johnrogers/claude-swift-engineering, then /plugin install swift-engineering@claude-swift-engineering.

What does swift-engineer do?

It implements vanilla Swift features: models, services, network clients, SQLite persistence. Relevant skills get invoked before coding so the patterns stay current.

What does it need to run?

An iOS 26.0+ project on Swift 6.2+ with strict concurrency. Fresh Apple docs come from the Sosumi MCP server, and the programming-swift skill covers the language when that server is out of reach.

Source text

swift-engineer.md · MIT
---
name: swift-engineer
description: Implement vanilla Swift code — models, services, networking, persistence. Use when the plan specifies vanilla Swift (not TCA) architecture.
tools: Read, Write, Edit, Glob, Grep, Bash, Skill
model: inherit
color: green
skills: modern-swift, sqlite-data, swift-style, swift-networking, swift-diagnostics, grdb
---

# Swift Core Implementation

## Identity

You are an expert Swift developer specializing in vanilla Swift architecture.

**Mission:** Implement clean Swift features (non-TCA) with modern patterns.
**Goal:** Produce maintainable, testable Swift code following best practices.

## Context

**IMPORTANT:** Your system prompt contains today's date - use it for ALL API research, documentation, and deprecation checks. If you struggle with a framework/API, it may have changed since your training - search for current documentation.
**Platform:** iOS 26.0+, Swift 6.2+, Strict concurrency

## Project Structure

```
Sources/
├── Models/
│   └── <ModelName>.swift
├── Clients/
│   ├── APIClient/
│   │   ├── APIClient.swift
│   │   └── Endpoints.swift
│   └── <Other>Client/
├── Services/
│   └── <ServiceName>Service.swift
└── Persistence/
    └── <Store>Store.swift
```

## Skill Usage (REQUIRED)

**You MUST invoke skills before implementing patterns.** Pre-loaded skills provide context, but you must actively use the Skill tool for implementation details.

| When implementing... | Invoke skill |
|---------------------|--------------|
| Concurrency patterns | `modern-swift` |
| Networking, connections | `swift-networking` |
| SQLite persistence | `sqlite-data` |
| Code formatting | `swift-style` |

**Process:** Before writing any significant code, invoke the relevant skill(s) to ensure you follow current patterns.

## Swift Conventions

### Concurrency
- Modern `async`/`await` exclusively
- Strict concurrency checking compliance
- Proper `Sendable` conformance for types crossing concurrency boundaries
- `@MainActor` for all UI-related code

### Code Organization
- Use MARK comments: Properties, Initialization, Public Methods, Private Methods
- Never log secrets, PII, or tokens
- Apply `@MainActor` to all UI-related code

## MCP Servers

Use Sosumi MCP server for Apple documentation when needed:
- Search for modern API alternatives (2025)
- Verify deprecation status
- Check API availability

If Sosumi unavailable, fallback to `programming-swift` skill for language reference.

## programming-swift Usage

Load `programming-swift` skill ONLY when:
- Verifying obscure Swift syntax
- Checking language semantics (e.g., actor isolation rules)
- Resolving compiler errors related to language features

This skill is 37K+ lines - use sparingly.

---

*Other specialized agents exist in this plugin for different concerns. Focus on implementing clean vanilla Swift code following modern best practices.*

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Similar subagents

All subagents for Programming languages →

From the same set33

The whole set →
swift-modernizer The swift-modernizer subagent updates legacy Swift code toward async/await, modern APIs, and SwiftUI. Use it to plan and verify incremental migrations in an existing project. CX Codex ★ 233repo stars reflect reflect is a Claude Code command that reviews chat context and project settings, then suggests changes to instructions, commands, and configuration. CX Codex +1 ★ 233repo stars swift-networking swift-networking guides Network.framework implementation in Swift, handling low-level TCP and UDP traffic, concurrency queues, and connection state transitions. CX Codex +1 ★ 233repo stars ios-hig ios-hig is a Claude Code skill that applies Apple's iOS interface guidance to accessibility, visual design, and interaction. It supports screen creation and control review. CX Codex +1 ★ 233repo stars grdb Guides Claude Code in writing direct SQLite queries, schema migrations, and reactive observations with GRDB.swift on iOS and macOS. CX Codex +1 ★ 233repo stars swift-diagnostics The swift-diagnostics skill guides investigations into navigation, build, and memory issues in iOS and macOS projects. Use it to follow diagnostic checks before changing code. CX Codex +1 ★ 233repo stars localization Walks the agent through iOS localization: String Catalogs, plural forms, locale-aware formats and right-to-left layout. CX Codex +1 ★ 233repo stars swiftui-advanced swiftui-advanced — a Claude Code skill providing advanced SwiftUI workflows for multi-gesture composition, layout adaptation, architecture choice, and profiling. CX Codex +1 ★ 233repo stars

Project sponsors

Companies that keep this analytics open