# architecture-auditor

Субагент architecture-auditor оценивает архитектуру проекта, ищет циклические зависимости и даёт советы по выбору паттернов при изменении нескольких модулей.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 276 у репозитория
- Автор: Samarth Gupta
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/architecture-auditor.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/samarth-gupta-architecture-auditor

## Что делает

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

Для исследования кодовой базы используются инструменты `Read`, `Grep`, `Glob` и консоль `Bash`. При этом терминальные команды ограничены чтением структуры вроде `tree`, `find -type f` и `wc -l`. Изменяющие команды агент не выполняет, поэтому код он не форматирует, тесты не запускает и коммиты не создаёт.

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

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add gupsammy/Claudest
```
В чате агента (не в терминале):
```text
/plugin install claude-coding@Claudest
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/architecture-auditor.md

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

## Примеры запросов агенту
- Какую структуру модулей выбрать для нового сервиса уведомлений?
- Проверь архитектуру изменений в модулях авторизации и базы данных
- Оцени, нет ли циклических зависимостей между пакетами core и api

## Похожие
- [architecture-review](https://affpapa.org/nevibecode/commands/architecture-review.md) — команда · 3419 установок
- [clean-architecture](https://affpapa.org/nevibecode/skills/pproenca-clean-architecture.md) — скилл · 2100 установок
- [architecture-survey](https://affpapa.org/nevibecode/skills/architecture-survey.md) — скилл · 201 установка
- [architecture-critic](https://affpapa.org/nevibecode/agents/architecture-critic.md) — субагент · ★ 47914 у репозитория
- [guarding-architecture](https://affpapa.org/nevibecode/skills/guarding-architecture.md) — скилл · 25600 установок
- [architecture-compass](https://affpapa.org/nevibecode/skills/architecture-compass.md) — скилл · 2700 установок

## Другие версии с тем же именем
- [architecture-auditor · qdhenry](https://affpapa.org/nevibecode/agents/architecture-auditor.md) — ★ 1357 у репозитория

Из того же набора: [gupsammy/claudest](https://affpapa.org/nevibecode/by/gupsammy/claudest.md) — 47 карточек

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