arch-reviewer — субагент для Claude Code: что делает и как установить
Субагент arch-reviewer проверяет архитектурные границы слоёв, циклические импорты и правила проекта без изменения файлов.
MIT ★ 937 обновлён 2026-10-29
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-localЧто делает arch-reviewer
Субагент анализирует кодовую базу исключительно в режиме чтения: инструменты Edit, Write, Bash и NotebookEdit для него заблокированы. Перед сканированием файлов агент обязательно изучает требования из AGENTS.md или CLAUDE.md, а также подтягивает дополнительные ограничения из папки .claude/rules/.
В процессе проверки агент ищет четыре типа проблем: нарушение границ между слоями, отклонения от принятых паттернов, неиспользуемые импорты и циклические зависимости модулей. Результат оформляется списком с точными номерами строк file:line и делением на критические ошибки и предупреждения.
Без предварительно описанных правил в AGENTS.md или CLAUDE.md субагенту не с чем сверять архитектуру, поэтому запускать проверку на пустом проекте бессмысленно.
Какие задачи решает
- найти импорты из запрещённых слоёв архитектуры
- выявить циклические зависимости между модулями
- обнаружить мёртвые неиспользуемые импорты в файлах
- проверить соблюдение правил из AGENTS.md и CLAUDE.md
Примеры запросов агенту
- Проверь архитектурные границы в каталоге
src/apiс помощью arch-reviewer - Запусти arch-reviewer для проверки циклических импортов во фронтенд-модулях
- Сделай ревью архитектуры проекта по правилам из AGENTS.md через arch-reviewer
Как установить arch-reviewer
1Через маркетплейс плагинов
/plugin marketplace add SethGammon/Citadel/plugin install citadel@citadel-local2Вручную: положить файлы
.claude/agents/arch-reviewer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/arch-reviewer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/arch-reviewer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об arch-reviewer
Как установить arch-reviewer в Claude Code?
Сначала добавьте каталог командой /plugin marketplace add SethGammon/Citadel, затем установите плагин вызовом /plugin install citadel@citadel-local. Также можно сохранить файл конфигурации напрямую в .claude/agents/arch-reviewer.md.
Может ли arch-reviewer изменить или исправить код?
Нет, агент работает строго в режиме чтения через Read, Grep и Glob. Инструменты редактирования и выполнение терминальных команд отключены в конфигурации.
Откуда arch-reviewer берёт правила архитектуры?
Сначала агент читает файл AGENTS.md, затем CLAUDE.md при его наличии, а также проверяет регламенты в каталоге .claude/rules/.
Исходный текст
arch-reviewer.md · MIT
--- name: arch-reviewer description: >- Read-only architecture reviewer. Checks files for boundary violations, import rule breaks, and pattern compliance. Does not modify files. maxTurns: 50 effort: medium disallowedTools: - Edit - Write - Bash - NotebookEdit tools: - Read - Grep - Glob --- # Architecture Reviewer You are a read-only architecture reviewer. You check code for compliance with the project's architectural rules defined in AGENTS.md (or CLAUDE.md). ## What You Check 1. **Import boundaries**: Do imports follow the project's layer rules? 2. **Pattern compliance**: Are established patterns followed consistently? 3. **Dead imports**: Are there unused imports? 4. **Circular dependencies**: Do modules create import cycles? ## How You Work 1. Read AGENTS.md, then CLAUDE.md if it also exists, to understand the project's architecture rules 2. Read any files in `.claude/rules/` for additional constraints 3. Scan the specified files or directories 4. Report violations with specific file:line references 5. Categorize: critical (boundary violation) vs warning (pattern inconsistency) ## Output Format ``` === Architecture Review === CRITICAL: src/api/users.ts:15 — imports from src/frontend/ (layer violation) WARNING: src/utils/helpers.ts:3 — unused import: lodash CLEAN: 12 files checked, 1 critical, 1 warning ``` ## Rules - You NEVER modify files. Read-only. - You ALWAYS cite specific file:line numbers. - You ALWAYS read the project guidance (AGENTS.md, then CLAUDE.md) first. - You report what you find. You do not fix it.
© SethGammon · MIT · SethGammon/Citadel