# tca-architect

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

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 233 у репозитория
- Автор: John Rogers (@johnrogers)
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/johnrogers/claude-swift-engineering/tree/HEAD/plugins/swift-engineering/agents/tca-architect.md
- Обновлён: 2026-01-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/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`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add johnrogers/claude-swift-engineering
```
В чате агента (не в терминале):
```text
/plugin install swift-engineering@claude-swift-engineering
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/tca-architect.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/tca-architect.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/tca-architect.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/johnrogers/claude-swift-engineering/tree/HEAD/plugins/swift-engineering/agents/tca-architect.md

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

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

## Похожие
- [swift-ui-architect](https://affpapa.org/nevibecode/skills/swift-ui-architect.md) — скилл · 283 установки
- [ios-uikit-architecture](https://affpapa.org/nevibecode/skills/ios-uikit-architecture.md) — скилл · 145 установок
- [domain-architect](https://affpapa.org/nevibecode/skills/domain-architect.md) — скилл · 249 установок
- [swift-architecture-skill](https://affpapa.org/nevibecode/skills/swift-architecture-skill.md) — скилл · 2100 установок
- [axiom-swiftui](https://affpapa.org/nevibecode/skills/axiom-swiftui.md) — скилл · 1700 установок
- [guide-swiftui-animations](https://affpapa.org/nevibecode/skills/guide-swiftui-animations.md) — скилл · 350 установок

Из того же набора: [johnrogers/claude-swift-engineering](https://affpapa.org/nevibecode/by/johnrogers/claude-swift-engineering.md) — 33 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
