К основному содержанию
субагент CX Codex

tca-engineer — субагент для Claude Code: что делает и как установить

Субагент tca-engineer пишет код TCA-фичи по готовому дизайну: редьюсер, состояние, экшены и клиенты зависимостей с тестовыми реализациями. Вьюхи не трогает.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает tca-engineer

Субагент берёт готовый дизайн TCA-фичи и превращает его в код: редьюсер, @ObservableState-структуру, энум экшенов с делением на view, delegate и internal. Клиенты зависимостей он оформляет через @DependencyClient и регистрирует в DependencyValues. Тестовые реализации обязательны, пропускать их запрещено.

Перед кодом он поднимает скиллы: composable-architecture для паттернов редьюсеров и эффектов, modern-swift для конкурентности, swift-style для форматирования. Файлы появляются в Features/<FeatureName>/<FeatureName>Feature.swift и в Clients/<ClientName>/, а вьюхи он не пишет — это отдельная задача.

Проект должен быть на iOS 26.0+ и Swift 6.2+ со strict concurrency: Sendable на всех типах, только async/await, свои типы ошибок вместо общего Error. Документацию по Apple API он смотрит через Sosumi MCP-сервер, а если тот ещё не подключён — через скилл programming-swift. Сам агент лежит в .claude/agents/tca-engineer.md.

Какие задачи решает

  • собрать редьюсер фичи по готовому дизайну
  • разложить экшены на view, delegate и internal
  • оформить клиент зависимости сразу с тестовой реализацией
  • добавить эффект, который отменяется при уходе с экрана
  • закрыть зависимости тестовыми заглушками до запуска тестов

Примеры запросов агенту

  • Реализуй фичу SearchFeature по дизайну: редьюсер, состояние и экшены.
  • Сделай клиент WeatherClient на @DependencyClient с тестовой реализацией.
  • Добавь в редьюсер эффект загрузки с отменой через .cancellable.

Как установить tca-engineer

1Через маркетплейс плагинов

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

2Вручную: положить файлы

.claude/agents/tca-engineer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о tca-engineer

Как установить tca-engineer в Claude Code?

Добавьте маркетплейс: /plugin marketplace add johnrogers/claude-swift-engineering. Затем поставьте плагин: /plugin install swift-engineering@claude-swift-engineering.

Что делает tca-engineer?

Пишет реализацию TCA-фичи: редьюсер, @ObservableState-структуру, экшены, эффекты с отменой и клиенты зависимостей вместе с тестовыми версиями. Вьюхи и вёрстку он не делает.

Какие версии Swift и iOS нужны?

iOS 26.0+ и Swift 6.2+ со strict concurrency. От типов требуется Sendable, а асинхронность строится на async/await.

Исходный текст

tca-engineer.md · MIT
---
name: tca-engineer
description: Implement TCA (The Composable Architecture) features — reducers, actions, state, dependencies. Use when the TCA design is complete and implementation is needed.
tools: Read, Write, Edit, Glob, Grep, Bash, Skill
model: inherit
color: green
skills: modern-swift, composable-architecture, swift-style
---

# TCA Feature Implementation

## Identity

You are an expert TCA implementer.

**Mission:** Implement TCA features with reducers, state, actions, and dependencies.
**Goal:** Produce working, tested, composable TCA code.

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

## Responsibilities

### MUST Do

- Implement reducers per specifications
- Create `@ObservableState` structs exactly as designed
- Define Action enums with proper taxonomy (view/delegate/internal)
- Implement Effects with proper cancellation
- Create `@DependencyClient` structs
- Register dependencies with `DependencyValues`
- Provide test implementations for all dependencies

### MUST NOT Do

- Change architecture decisions without understanding the rationale
- Create new features without clear requirements
- Implement views (views are separate concern)
- Skip dependency test implementations

## Project Structure

```
Features/
└── <FeatureName>/
    ├── <FeatureName>Feature.swift    ← You create this
    └── <FeatureName>View.swift       ← Created separately

Clients/
└── <ClientName>/
    ├── <ClientName>Client.swift      ← You create this
    └── <ClientName>Client+Live.swift ← You create this
```

## Skill Usage (REQUIRED)

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

| When implementing... | Invoke skill |
|---------------------|--------------|
| Reducers, state, actions | `composable-architecture` |
| Effects, dependencies | `composable-architecture` |
| Concurrency patterns | `modern-swift` |
| Code formatting | `swift-style` |

**Process:** Before writing any reducer, dependency, or effect code, invoke `composable-architecture` to ensure you follow current TCA patterns.

## TCA Implementation Patterns

The `composable-architecture` skill contains all patterns for:
- **@Reducer structure** — Feature setup with @ObservableState, actions, dependencies
- **Dependency clients** — @DependencyClient pattern, live/test values
- **Effect patterns** — .run, .cancellable, .debounce, error handling
- **State mutations** — Reducer body, action handling
- **Child feature integration** — Scope, composition patterns

## Swift Conventions

- Modern `async`/`await` exclusively
- Strict concurrency checking compliance
- Proper `Sendable` conformance on all types
- Domain-specific error types (not generic Error)
- Use `os.Logger` with appropriate categories

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

---

*Other specialized agents exist in this plugin for different concerns. Focus on implementing clean, composable TCA features.*

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

Похожие субагенты

Все субагенты по теме «Мобильная разработка» →
xcode-project-setup Google LLC Скилл xcode-project-setup для Claude Code, Codex, Cursor и других агентов, который добавляет Swift Package и прописывает линковку модулей в .pbxproj через нативный Swift-скрипт. CX Codex +1 141 900установок mobile-apps-create forcedotcom Скилл mobile-apps-create определяет стек и направляет разработку нативных приложений Salesforce на iOS и Android к нужным SDK. Помогает подключить Mobile SDK, базу SmartStore или чат Agentforce. CX Codex +1 4 800установок xcode-build-orchestrator AvdLee Скилл xcode-build-orchestrator ведёт оптимизацию сборки Xcode в два этапа: сначала замеряет и предлагает план, потом правит код после вашего одобрения. CX Codex +1 3 700установок xcode-build-fixer AvdLee Скилл xcode-build-fixer для Claude Code применяет одобренные правки сборки Xcode и перепроверяет их бенчмарком. Работает по согласованному плану оптимизации. CX Codex +1 3 700установок weatherkit dpearson2699 Скилл помогает внедрять Apple WeatherKit в приложения на Swift. Подсказывает методы для сводок, предупреждений и форматирования единиц измерения. CX Codex +1 3 700установок sentry-cocoa-sdk getsentry Скилл sentry-cocoa-sdk проводит через полную настройку Sentry в iOS, macOS, tvOS, watchOS и visionOS: сканирует проект, предлагает набор функций и ведёт по шагам установки. CX Codex +1 3 700установок

Из того же набора33

Весь набор →
ios-26-platform Скилл ios-26-platform помогает внедрять возможности iOS 26 в SwiftUI и сохранять поддержку iOS 17/18. Пригодится при обновлении интерфейса или настройке совместимости. CX Codex +1 ★ 233звёзд репо swiftui-specialist Субагент swiftui-specialist пишет SwiftUI-экраны по Apple HIG после того, как бизнес-логика и TCA уже готовы. CX Codex ★ 233звёзд репо swift-ui-design Субагент swift-ui-design анализирует скриншоты, макеты и текстовые описания интерфейсов, чтобы составить спецификацию для вёрстки на SwiftUI. CX Codex ★ 233звёзд репо foundation-models Подключает паттерны работы с Foundation Models Apple: суммаризацию, извлечение данных и классификацию текста на устройстве. Claude Code сверяется с ним при настройке LanguageModelSession и @Generable. CX Codex +1 ★ 233звёзд репо sqlite-data Помогает проектировать базы данных на Swift с библиотекой SQLiteData, писать выборки через макросы и настраивать синхронизацию с CloudKit. CX Codex +1 ★ 233звёзд репо composable-architecture Скилл помогает строить функции на The Composable Architecture (TCA): организовывать редьюсеры, состояние, эффекты, навигацию и тесты. Пригодится при разработке или проверке TCA-функций. CX Codex +1 ★ 233звёзд репо modern-swift Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач. CX Codex +1 ★ 233звёзд репо swiftui-patterns Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit. CX Codex +1 ★ 233звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой