# review-architecture

Скилл review-architecture проверяет написанный архитектурный артефакт (ADR, architecture doc или раздел дизайн-документа) на соответствие системе, которую тот описывает.

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

## Что делает

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

Проверку ведёт read-only субагент `architecture-reviewer`, а скилл принимает отчёт и показывает его целиком: таблицу утверждений, вердикты по измерениям, раздел Not Reviewed. Сжимать отчёт нельзя, иначе пропадает промежуточный артефакт, ради которого всё делалось.

На вызов приходится ровно один артефакт: `$kk:review-architecture <artifact-path>`. Диаграмма без текста не примется, два пути сразу тоже. Для доменного справочника хватает одного пути, парная страница подтянется сама. Поведение кода скилл не проверяет, для этого есть `$kk:review-code` и `$kk:review-spec`. Security-архитектуру он отдаёт в `mcp__pal__secaudit`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-architecture -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-architecture -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install serpro69/claude-toolbox kodex-plugin/skills/review-architecture
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-architecture -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/review-architecture
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/serpro69/claude-toolbox/tree/HEAD/kodex-plugin/skills/review-architecture/SKILL.md

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

## Примеры запросов агенту
- Запусти `$kk:review-architecture <artifact-path>` на ADR из `docs/adr/` и покажи отчёт целиком.
- Отревьюь архитектурный раздел дизайн-документа из `docs/feat/wip/` и не трогай остальное.
- Сверь доменный справочник `docs/domain/<context>.md` вместе с парной страницей ловушек.

## Похожие
- [architecture-review](https://affpapa.org/nevibecode/skills/owainlewis-architecture-review.md) — скилл · 347 установок
- [adr-review](https://affpapa.org/nevibecode/skills/adr-review.md) — скилл · 747 установок
- [architecture-compass](https://affpapa.org/nevibecode/skills/architecture-compass.md) — скилл · 2700 установок
- [architecture-decision](https://affpapa.org/nevibecode/skills/architecture-decision.md) — скилл · 505 установок
- [Python Backend Architecture Review](https://affpapa.org/nevibecode/skills/python-backend-architecture-review.md) — скилл · 528 установок
- [code-architecture-review](https://affpapa.org/nevibecode/skills/code-architecture-review.md) — скилл · 270 установок

Из того же набора: [serpro69/claude-toolbox](https://affpapa.org/nevibecode/by/serpro69/claude-toolbox.md) — 30 карточек

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