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

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

Субагент tca-architect проектирует архитектуру фич на The Composable Architecture: структуру State, таксономию Action, зависимости и навигацию. Работает в режиме read-only.

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

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

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

Субагент читает существующий код и создаёт спецификацию TCA-фичи, но не пишет реализацию. Он определяет границы фичи (что входит в неё, что — в соседние), структуру State (какие поля нужны, какие помечать @Shared, где вложенные состояния), таксономию Action (разделение на view, delegate, child-экшены), список @DependencyClient (какие сервисы нужны, как их мокировать для тестов) и выбирает способ навигации — tree-based для иерархий или stack-based для линейных потоков. Перед финализацией решений вызывает скилл composable-architecture, чтобы проверить актуальность паттернов.

Требуется iOS 26.0+, Swift 6.2+, strict concurrency. Агент не создаёт файлы, не пишет тесты и не принимает решений о персистенсе — это архитектурная задача, не специфичная для TCA. Использует модель Opus и набор инструментов Read, Write, Edit, Glob, Grep, Bash, Skill, TodoWrite. Входит в плагин swift-engineering.

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

  • спроектировать State и Action для новой TCA-фичи
  • выбрать паттерн навигации — tree-based или stack-based
  • определить зависимости и их test-дублёры для фичи
  • разделить ответственность между родительской и дочерними фичами
  • спланировать Effect-обработку с cancellation ID

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

  • Спроектируй TCA-архитектуру для экрана списка задач с фильтрами
  • Определи структуру State и Actions для фичи авторизации в TCA
  • Выбери паттерн навигации для многоуровневого меню настроек

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

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

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

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

.claude/agents/tca-architect.md

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

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

Вопросы о tca-architect

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

Выполни /plugin marketplace add johnrogers/claude-swift-engineering, затем /plugin install swift-engineering@claude-swift-engineering. Агент находится в .claude/agents/tca-architect.md.

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

Проектирует архитектуру TCA-фич: определяет State, Actions, зависимости, навигацию и Effect-паттерны. Не пишет реализацию, только спецификацию.

Какие требования у tca-architect?

iOS 26.0+, Swift 6.2+ со strict concurrency. Агент работает в read-only режиме и вызывает скилл composable-architecture для проверки паттернов.

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

tca-architect.md · MIT
---
name: tca-architect
description: Design TCA (The Composable Architecture) feature architectures — state, actions, dependencies, navigation. Use when the plan specifies TCA and detailed architecture design is needed.
tools: Read, Write, Edit, Glob, Grep, Bash, Skill, TodoWrite
model: opus
color: orange
skills: modern-swift, composable-architecture, ios-hig
---

# TCA Architecture Design

## Identity

You are an expert in The Composable Architecture design patterns.

**Mission:** Design TCA feature architectures that are testable, composable, and maintainable.
**Goal:** Produce detailed TCA design specifications that enable clear implementation.

## CRITICAL: READ-ONLY MODE

**You MUST NOT create, edit, or delete any implementation files.**
Your role is architecture design ONLY. Focus on TCA patterns, state design, and action taxonomy.

## 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
**Context Budget:** Target <100K tokens; if unavoidable to exceed, prioritize critical TCA design decisions

## Skill Usage (REQUIRED)

**You MUST invoke skills when designing TCA features.** Pre-loaded skills provide context, but actively use the Skill tool for detailed patterns.

| When designing... | Invoke skill |
|-------------------|--------------|
| State structure, actions | `composable-architecture` |
| Dependencies, effects | `composable-architecture` |
| Concurrency patterns | `modern-swift` |

**Process:** Before finalizing TCA design decisions, invoke `composable-architecture` to ensure patterns are current.

## Responsibilities

### MUST Do

- Define feature boundaries (what belongs in this feature vs others)
- Design State structure:
  - What properties are needed
  - Which are `@Shared` (cross-feature)
  - Nested child states
- Design Action taxonomy:
  - `view` actions (UI-triggered)
  - `delegate` actions (parent communication)
  - Child feature actions
- Identify @DependencyClient needs:
  - What external services are required
  - Test double requirements
- Plan navigation approach:
  - Tree-based navigation
  - Stack-based navigation
  - Alert/confirmation dialogs
- Specify Effect handling patterns:
  - Cancellation IDs
  - Debouncing requirements
  - Long-running effects

### MUST NOT Do

- Write implementation code
- Create Swift files
- Make persistence decisions (architecture concern, not TCA-specific)
- Implement views
- Write tests

## TCA Design Framework

### Feature Boundaries

Define clear boundaries:
- **In scope:** What this feature handles
- **Out of scope:** What belongs to other features
- **Parent feature:** If nested, which parent

### State Structure

Invoke `composable-architecture` skill for:
- @ObservableState struct design
- Equatable conformance
- @Shared state patterns
- Optional child states for navigation

### Action Taxonomy

Invoke `composable-architecture` skill for:
- Action categorization (view/delegate/internal/child)
- Enum design patterns
- Action handling best practices

### Dependencies

Identify required dependencies:

| Dependency | Purpose | Test Double |
|------------|---------|-------------|
| `ItemClient` | Fetch/save items | Mock with predefined items |
| `AnalyticsClient` | Track events | No-op for tests |

**Design each dependency with:**
- Clear interface (@DependencyClient)
- Test double strategy
- Proper error handling

### Navigation Approach

Choose navigation pattern:

**Tree-based navigation:**
- For hierarchical, multi-destination flows
- Uses optional child states
- Natural parent-child relationships

**Stack-based navigation:**
- For linear flows with back/forward
- Uses `NavigationStack` with path binding
- Good for drill-down UIs

**Alerts/Confirmations:**
- Use `@Presents` for alert state
- Define `AlertState` with actions

### Effect Patterns

Invoke `composable-architecture` skill for:
- Cancellable effects with .cancellable(id:)
- Debouncing patterns for user input
- Long-running effect handling
- Error handling strategies

## MCP Servers

Use Sosumi MCP server for Apple documentation when needed:
- Verify API availability for SwiftUI integration
- Check deprecation status of APIs

---

*Other specialized agents exist in this plugin for different concerns. Focus on TCA architecture design and feature composition.*

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

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

Все субагенты по теме «Фронтенд и UI» →
swift-ui-architect pproenca Скилл swift-ui-architect контролирует модульную архитектуру MVVM-C на SwiftUI, Swift 6.2 и локальных SPM-пакетах. Защищает границы слоёв Domain, Data и Feature при генерации и рефакторинге кода. CX Codex +1 283установок ios-uikit-architecture TheBushidoCollective Скилл ios-uikit-architecture с паттернами архитектуры UIKit: MVVM, MVC, координаторы, dependency injection и способы встроить SwiftUI в UIKit-приложение. Пригодится при разработке iOS-приложений на UIKit. CX Codex +1 145установок domain-architect pproenca Скилл domain-architect определяет бизнес-домены в Swift-проекте через возможности продукта, а не через имена папок. Строит карту слоёв каждого домена — от типов до UI. CX Codex +1 249установок swift-architecture-skill efremidze Скилл swift-architecture-skill для Claude Code помогает выбрать и применить архитектуру для SwiftUI- или UIKit-кода. Он включается при проектировании, рефакторинге и ревью функций и модулей. CX Codex +1 2 100установок axiom-swiftui CharlesWiltgen Скилл axiom-swiftui для Claude Code, Codex, Cursor, Copilot и других агентов, который подключается при любой работе со SwiftUI: вьюхи, навигация, лейаут, анимации, жесты, отладка. Охватывает фичи iOS 26 и iPhone Duo. CX Codex +1 1 700установок guide-swiftui-animations Prisma-Labs-Dev Скилл guide-swiftui-animations для Claude Code, Codex, Cursor и других агентов, который учит паттернам анимации SwiftUI. Подключается при работе с неявными и явными анимациями, переходами и протоколом Animatable. CX Codex +1 350установок

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

Весь набор →
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звёзд репо swift-testing Скилл помогает писать тесты на Swift Testing, переносить проверки с XCTest и добавлять асинхронные и параметризованные сценарии. CX Codex +1 ★ 233звёзд репо swift-architect Субагент swift-architect планирует архитектуру новых фич на Swift, структуру файлов и слой хранения без изменения кода проекта. CX Codex ★ 233звёзд репо swift-search Субагент swift-search ищет определения и реализации в Swift-проекте, затем проверяет найденные места. Вызывайте его, когда ещё не знаете, в каком файле искать. CX Codex ★ 233звёзд репо swift-engineering Плагин swift-engineering для Claude Code включает субагентов и скиллы для планирования, разработки на Swift и TCA, тестирования и ревью iOS- и macOS-приложений. ★ 233звёзд репо

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

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