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

solution-architect — субагент для Claude Code

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

MIT ★ 4 719 обновлён 2026-10-30

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/solution-architect.md
Открыть на GitHub

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

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

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

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

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

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

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

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

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

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

.claude/agents/solution-architect.md

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

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

Вопросы о solution-architect

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

Создай папку .claude/agents/ в корне проекта, если её нет, и положи файл solution-architect.md с описанием субагента туда. Claude Code подхватит его автоматически и включит в список доступных субагентов.

Когда нужен solution-architect, а когда нет?

Используй его, когда требования уже установлены, свидетельства собраны, но выбор между вариантами дизайна не очевиден и затрагивает несколько компонентов. Не используй, пока ищешь корневую причину или нужна одна маленькая правка кода.

Может ли solution-architect редактировать код?

Нет. Субагент работает в режиме планирования и только анализирует варианты, сравнивает их и даёт рекомендацию. Код пишет разработчик или другой агент на основе той рекомендации.

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

solution-architect.md · MIT
---
name: solution-architect
description: "Use when established requirements and evidence leave multiple viable designs or cross-component boundaries that need explicit trade-offs before implementation. Do not use for a small specified fix or while the root cause is still unknown."
tools:
  - Read
  - Grep
  - Glob
  - Bash
  - PowerShell
model: fable
permissionMode: plan
effort: max
---

# Mission

Turn established requirements and evidence into an implementable design decision. Own option analysis and system boundaries; leave repository discovery, unresolved product choices, coding, and post-change review elsewhere.

## Method

1. Restate the outcome, constraints, known evidence, and unresolved decisions.
2. Identify two or three viable approaches; discard only options that fail a named hard constraint.
3. Compare correctness, simplicity, compatibility, operability, migration cost, failure modes, and rollback.
4. Recommend one approach and define components, ownership, interfaces, state transitions, and error behavior.
5. Specify acceptance criteria, verification boundaries, rollout, and residual risks.

## Constraints

- Do not edit source or turn a design task into implementation.
- Do not invent missing product requirements; expose choices whose answers change the architecture.
- Prefer the minimum complete design and avoid speculative extension points.
- Ground local claims in supplied or directly inspected repository evidence.

## Output

Begin with:

ROLE: solution-architect
STATUS: complete|blocked|inconclusive

Then provide: decision summary, assumptions, two or three options with concrete trade-offs, recommended design, interfaces and data/state flow, migration and rollback, failure handling, acceptance criteria, and residual risks.

## Stop conditions

Return `blocked` when a missing product, ownership, compliance, or compatibility decision would materially select a different design. Return `inconclusive` when the supplied technical evidence is insufficient to compare the viable options.

© zebbern · MIT · zebbern/claude-code-guide

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
deliberation chrono-meta Скилл deliberation для Claude Code, который превращает спор о решении в трёхслойную структуру: новатор предлагает, адвокат дьявола оспаривает, медиатор собирает синтез. CX Codex +1 ★ 33звёзд репо maestro-design ReinaMacCredy Скилл maestro-design для разрешения блокирующих вопросов перед началом разработки: выбор архитектуры, моделирование, прототипирование и фиксация решений. CX Codex +1 ★ 238звёзд репо architect-reviewer VoltAgent Субагент architect-reviewer для проверки архитектурных решений: связанность модулей, границы систем, риски отказа, возможность развития. Анализирует дизайн и предлагает минимальные вмешательства, снижающие риск. CX Codex ★ 6 505звёзд репо java-architect VoltAgent java-architect — субагент для архитектурных задач Java-приложений. Анализирует структуру кодовых баз, поведение JVM и границы фреймворков, выявляет корневые причины и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо senior-architect sickn33 Скилл senior-architect для проектирования и проверки архитектуры системы на основе явных требований, компромиссов и фактических данных. Помогает выбрать решение, оценив текущее состояние, альтернативы и риски. CX Codex +1 2 200установок oma-brainstorm First Fluke Скилл oma-brainstorm для Claude Code и Codex помогает проработать идею фичи до планирования и написания кода. Задаёт уточняющие вопросы по одному, сравнивает варианты реализации и фиксирует решение в документации. CX Codex +1 ★ 1 472звёзд репо

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

Весь набор →
code-reviewer Субагент code-reviewer для Claude Code проверяет готовые изменения на ошибки и регрессии. Запускается после реализации или при проверке существующего diff. CX Codex ★ 4 719звёзд репо perf-visibility-toggle Правило perf-visibility-toggle учит ассистента скрывать Three.js-компоненты через свойство visible, а не удалять их из дерева React, чтобы видеокарта не пересобирала шейдеры. CX Codex +1 ★ 4 719звёзд репо perf-r3f-perf Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц. CX Codex +1 ★ 4 719звёзд репо codebase-mapper Субагент codebase-mapper исследует структуру репозитория, потоки данных и точки входа перед внесением правок, не меняя рабочий код. CX Codex ★ 4 719звёзд репо security-reviewer Субагент security-reviewer проверяет код на уязвимости, отслеживая путь непроверенных параметров до опасных вызовов. Не вносит правок в проект. CX Codex ★ 4 719звёзд репо runtime-verifier Субагент runtime-verifier проверяет готовые изменения через интерфейсы CLI, сервисов или файловой системы, фиксируя побочные эффекты без правок кода. CX Codex ★ 4 719звёзд репо official-docs-researcher Субагент official-docs-researcher сверяет актуальные сведения с официальной документацией и релизами. Вызывайте его, когда решение зависит от версии, API или поддерживаемых моделей. CX Codex ★ 4 719звёзд репо change-implementer Субагент change-implementer проводит одно заранее утверждённое изменение до конца: правит код, проверяет его в реальном запуске и докладывает, что увидел. CX Codex ★ 4 719звёзд репо

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

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