# arch

Команда для построения и проверки .arch/index.json — карты, которая связывает каждый компонент архитектуры с файлами, которые его реализуют. Находит, когда файлы и описание компонентов перестали совпадать.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 328 у репозитория
- Автор: coco-research
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/coco-research/coco/tree/HEAD/commands/team/arch.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/arch

## Что делает

Команда `arch` решает две задачи: построить карту архитектуры с нуля или проверить, не разошлась ли она с реальным кодом. Работает через три подкоманды: `build` создаёт `.arch/index.json` по текущему состоянию репозитория, `drift` сравнивает существующую карту с деревом файлов и находит расхождения, `check` запускает валидатор без записи изменений.

Процесс состоит из четырёх слоёв. Первый — детерминированный, без агентов: команда проверяет экосистему, смотрит, не было ли слишком много изменений с момента последней привязки, и для неизменённых деревьев завершает работу сразу. Второй — агент-архитектор синтезирует индекс. Третий — две параллельные проверки: рецензент архитектуры смотрит на связность и ясность компонентов, эксперт домена проверяет, совпадает ли описание с кодом. Четвёртый — финальный агент применяет замечания и рисует диаграмму.

Каждый run привязан к коммиту через `.arch/pinned-commit`, и индекс обновляется только если все проверки пройдены. Результат пишется в `.arch/index.json`, доказательства валидации — в `.arch/ARCH-EVIDENCE.md`.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/commands/arch.md` — Вызов — /arch. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/arch.md` — Вызов — /prompts:arch. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/arch.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/arch.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/coco-research/coco/tree/HEAD/commands/team/arch.md

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

## Примеры запросов агенту
- Какие файлы реализуют компонент 'api'?
- /team arch drift
- /team `arch build --full`

## Похожие
- [arch-check](https://affpapa.org/nevibecode/skills/arch-check.md) — скилл · 3900 установок
- [breakdown-epic-arch](https://affpapa.org/nevibecode/skills/breakdown-epic-arch.md) — скилл · 9000 установок
- [arch-diagram](https://affpapa.org/nevibecode/skills/arch-diagram.md) — скилл · ★ 145 у репозитория
- [arch-reviewer](https://affpapa.org/nevibecode/agents/arch-reviewer.md) — субагент · ★ 937 у репозитория
- [feature-arch](https://affpapa.org/nevibecode/skills/feature-arch.md) — скилл · 609 установок
- [html-ppt-knowledge-arch-blueprint](https://affpapa.org/nevibecode/skills/html-ppt-knowledge-arch-blueprint.md) — скилл · 184 установки

Из того же набора: [coco-research/coco](https://affpapa.org/nevibecode/by/coco-research/coco.md) — 82 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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