architecture-reviewer — субагент для Claude Code
Субагент architecture-reviewer независимого аудита архитектурных документов. Сверяет заявленные структуры и механизмы с реальным кодом репозитория без оценки поведения системы.
Elastic-2.0 ★ 155 обновлён 2026-10-29
/plugin marketplace add serpro69/claude-toolbox
/plugin install kk@claude-toolboxЧто делает architecture-reviewer
Субагент запускается через порождающий скилл и изолирован от истории создания документа: у него нет черновиков, логов переписки и инструментов записи. Доступ ограничен чтением файлов, поиском через Grep, Glob и контекстными запросами capy_search. Это отсекает предвзятость автора и заставляет оценивать артефакт только по фактам.
Проверка идёт строго в три фазы. Сначала агент извлекает список утверждений исключительно из текста документа, не заглядывая в репозиторий. Затем он ищет заявленные механизмы в кодовой базе и проверяет их топологию — например, наличие нужного маршрута API или таблицы в схеме данных. Поведенческую корректность под нагрузкой или повторными запросами агент намеренно игнорирует.
Без предоставленного абсолютного пути к плагину субагент сразу остановит работу, потому что переменные среды и доступ к оболочке в нём заблокированы. Вопросы безопасности, потоков авторизации и классификации данных он выносит во внешний аудит и не моделирует угрозы самостоятельно.
Какие задачи решает
- сверять архитектурные решения с фактическим кодом репозитория
- проверять обоснованность и обратимость проектных решений
- находить расхождения между документацией и топологией сервисов
- оценивать связанные наборы терминов и проектных ограничений
Примеры запросов агенту
- Запусти архитектурный аудит для файла
docs/adr/0004-idempotency.md - Проверь раздел архитектуры в проектном документе
docs/design/billing-v2.md - Выполни проверку глоссария и ограничений предметной области в
docs/domain/
Как установить architecture-reviewer
1Через маркетплейс плагинов
/plugin marketplace add serpro69/claude-toolbox/plugin install kk@claude-toolbox2Вручную: положить файлы
.claude/agents/architecture-reviewer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/architecture-reviewer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/architecture-reviewer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об architecture-reviewer
Как установить architecture-reviewer в Claude Code?
Выполните в терминале Claude Code команду /plugin marketplace add serpro69/claude-toolbox, а затем установите пакет вызовом /plugin install kk@claude-toolbox.
Что именно проверяет этот субагент?
Он проверяет только наличие и структуру заявленных архитектурных компонентов в репозитории, а также логическую связность решений. Поведенческую логику и сценарии выполнения он не тестирует.
Проверяет ли агент безопасность архитектуры?
Нет. Границы доверия, потоки аутентификации и классификацию данных субагент исключает из своей проверки и передаёт специализированным инструментам безопасности.