# solution-architect

Субагент solution-architect для Claude Code, Codex и Cursor сравнивает архитектурные варианты и рекомендует один с учётом ограничений. Включается, когда требования понятны, но решений несколько.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/agents/.claude/agents/solution-architect.md
- Обновлён: 2026-10-30
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/solution-architect

## Что делает

solution-architect предназначен для задач, когда корневая причина уже найдена, требования зафиксированы, но остаётся выбор между несколькими подходами. Субагент переформулирует результат, выявит две-три жизнеспособные схемы, сравнит их по корректности, простоте, совместимости, отказоустойчивости и стоимости миграции, а затем рекомендует один вариант с описанием компонентов, интерфейсов и переходов состояния.

В арсенале субагента есть инструменты для чтения кода (`Read`), поиска (`Grep`), глобирования путей (`Glob`) и выполнения команд (`Bash`), что позволяет проверить предположения прямо на репозитории. Субагент работает в режиме планирования (`permissionMode: plan`) и не редактирует исходный код — это оставляет за собой разработчик или другой агент.

Не запускай solution-architect для мелкого исправления, когда корень проблемы ещё не ясен, или если вариантов дизайна нет. Субагент остановится с пометкой `blocked`, если ответ зависит от решения на уровне продукта, и вернёт `inconclusive`, если фактов в репозитории недостаточно.

## Установка

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- выбрать между несколькими архитектурными подходами на основе реальных ограничений
- разложить дизайн на компоненты, интерфейсы и состояния перед кодированием
- оценить стоимость миграции и риски отката для каждого варианта
- выявить недостающие решения на уровне продукта, которые меняют архитектуру

## Примеры запросов агенту
- У нас есть список требований и два пути: монолит с плагинами или микросервисы. Какой выбрать?
- Нужно переписать хранилище данных. Вот текущий код, вот новые требования. Какая схема миграции безопаснее?
- Система растёт, появились граничные точки между компонентами. Как переструктурировать, чтобы минимум переделывать?

## Похожие
- [deliberation](https://affpapa.org/nevibecode/skills/deliberation.md) — скилл · ★ 33 у репозитория
- [maestro-design](https://affpapa.org/nevibecode/skills/maestro-design.md) — скилл · ★ 238 у репозитория
- [architect-reviewer](https://affpapa.org/nevibecode/agents/voltagent-architect-reviewer.md) — субагент · ★ 6505 у репозитория
- [java-architect](https://affpapa.org/nevibecode/agents/voltagent-java-architect.md) — субагент · ★ 6505 у репозитория
- [senior-architect](https://affpapa.org/nevibecode/skills/sickn33-senior-architect.md) — скилл · 2200 установок
- [oma-brainstorm](https://affpapa.org/nevibecode/skills/oma-brainstorm.md) — скилл · ★ 1472 у репозитория

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

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

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