# arch-index

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

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

## Что делает

Скилл связывает архитектурные компоненты с существующими каталогами и файлами, фиксирует индекс на Git-коммите и проверяет каждый путь скриптом. Результат сборки включает `.arch/index.json`, отчёты для людей и Mermaid-диаграмму. Если проверка индекса не проходит, коммитная отметка не обновляется.

В режиме `drift` скрипт сравнивает сохранённую отметку с `HEAD`, проверяет пути и записывает вердикты по компонентам в `.arch/DRIFT.json`. При небольших изменениях агент разбирает добавленные файлы вне известных компонентов; крупный объём изменений запускает полную сборку. Скилл описывает уже существующий код, а не проектирует будущую систему. Для проверки нужны Python 3 и доступ к Git; без запуска валидатора сборка блокируется.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill arch-index -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/arch-index/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/arch-index/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill arch-index -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill arch-index -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/arch-index/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install coco-research/coco skills/arch-index
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add coco-research/coco --skill arch-index -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/coco-research/coco --path skills/arch-index
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/arch-index/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

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

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

## Примеры запросов агенту
- Составь индекс архитектурных компонентов этого репозитория в `.arch/index.json` и проверь все пути.
- Проверь архитектурный дрейф относительно сохранённого коммита.
- Какие файлы реализуют компонент авторизации? Обнови индекс, если структура изменилась.

## Похожие
- [arch-check](https://affpapa.org/nevibecode/skills/arch-check.md) — скилл · 3900 установок
- [breakdown-epic-arch](https://affpapa.org/nevibecode/skills/breakdown-epic-arch.md) — скилл · 9000 установок
- [feature-arch](https://affpapa.org/nevibecode/skills/feature-arch.md) — скилл · 609 установок
- [arch](https://affpapa.org/nevibecode/plugins/arch.md) — плагин · ★ 41430 у репозитория
- [arch-reviewer](https://affpapa.org/nevibecode/agents/arch-reviewer.md) — субагент · ★ 937 у репозитория
- [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
