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

arch-reviewer — субагент для Claude Code: что делает и как установить

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

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает 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-local

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

.claude/agents/arch-reviewer.md

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

По шагам, с командами для каждой платформы: Субагенты 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

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

Все субагенты по теме «Код-ревью и рефакторинг» →
arch-check codewithmukesh Скилл arch-check сверяет кодовую базу с заявленной архитектурой: направление зависимостей, нарушения слоёв, утечки между модулями и циклы. Пригодится перед релизом или после крупной фичи. CX Codex +1 3 900установок plan-reviewer diet103 Субагент plan-reviewer анализирует планы доработки архитектуры, миграций баз данных и интеграций до написания кода. Помогает найти скрытые риски и пропущенные шаги. CX Codex ★ 10 055звёзд репо architect-reviewer VoltAgent Субагент architect-reviewer для проверки архитектурных решений: связанность модулей, границы систем, риски отказа, возможность развития. Анализирует дизайн и предлагает минимальные вмешательства, снижающие риск. CX Codex ★ 6 505звёзд репо code-reviewer coco-research Субагент code-reviewer для ревью кода, архитектуры и безопасности. Проверяет SOLID, DDD, уязвимости, API-дизайн и производительность перед слиянием PR. CX Codex ★ 328звёзд репо skill-quality-reviewer Galaxy-Dawn Скилл skill-quality-reviewer проверяет структуру, описания и стиль написания локальных скиллов по четырём шкалам. Пригодится авторам агентов перед публикацией или для ревизии каталога наработок. CX Codex +1 467установок code-refactor-master diet103 Субагент code-refactor-master для Claude Code перестраивает структуру проекта, отслеживает импорты и разбивает крупные компоненты. Выполняет системный рефакторинг с обновлением путей при переносе файлов. CX Codex ★ 10 055звёзд репо

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

Весь набор →
knowledge-extractor Субагент knowledge-extractor извлекает из завершённой работы повторно используемые решения и ошибки и сохраняет их для вики. Запускайте его после крупного этапа разработки. CX Codex ★ 937звёзд репо session-handoff Скилл session-handoff собирает итоги текущей сессии в блок HANDOFF, чтобы следующая сессия сразу продолжила работу без повторного аудита. CX Codex +1 ★ 937звёзд репо verify Скилл verify для Claude Code и Codex, самопроверяет конвейер хуков Citadel во время работы. Запускает реальные вызовы инструментов (Write, Edit, Bash, Read), проверяет, что все хуки срабатывают, телеметрия накапливается и нет ошибок. CX Codex +1 ★ 937звёзд репо unharness Скилл unharness для Claude Code готовит план удаления Citadel из проекта и сохраняет переносимый архив. Запускается по просьбе удалить Citadel или очистить проект от harness. CX Codex +1 ★ 937звёзд репо grill Скилл grill превращает размытый план в чёткое техническое задание через интервью: по одному вопросу, каждый с готовым ответом на выбор. CX Codex +1 ★ 937звёзд репо autopilot Скилл autopilot автоматизирует очередь задач из папки .planning/intake/: составляет бриф, вносит правки в код и проверяет результат. CX Codex +1 ★ 937звёзд репо doc-gen Скилл doc-gen создаёт комментарии к функциям, README для каталогов и справку по API, подстраиваясь под стиль проекта. Полезен, когда документацию нужно сверить с кодом, а не пересказать сигнатуры. CX Codex +1 ★ 937звёзд репо policy-enforcer Субагент policy-enforcer для Claude Code сверяет планируемое действие с правилами Citadel и возвращает вердикт: разрешить или заблокировать. Archon и Fleet запускают его перед операциями с низкой обратимостью. CX Codex ★ 937звёзд репо

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

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