review-architecture — скилл для Claude Code
Скилл review-architecture проверяет написанный архитектурный артефакт (ADR, architecture doc или раздел дизайн-документа) на соответствие системе, которую тот описывает.
лицензия не указана ★ 155 обновлён 2026-10-29
npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-codeЧто делает review-architecture
Скилл берёт один закоммиченный артефакт и разбирает его на проверяемый набор утверждений. Дальше по каждому пункту смотрит, существует ли названный механизм и стоит ли он в правильной топологии: границы модулей, владение данными, NFR-механизмы, изоляция отказов, консистентность состояния, версионирование, привязка к домену. Отдельный проход оценивает решения по контексту, который документ заявляет сам.
Проверку ведёт read-only субагент architecture-reviewer, а скилл принимает отчёт и показывает его целиком: таблицу утверждений, вердикты по измерениям, раздел Not Reviewed. Сжимать отчёт нельзя, иначе пропадает промежуточный артефакт, ради которого всё делалось.
На вызов приходится ровно один артефакт: $kk:review-architecture <artifact-path>. Диаграмма без текста не примется, два пути сразу тоже. Для доменного справочника хватает одного пути, парная страница подтянется сама. Поведение кода скилл не проверяет, для этого есть $kk:review-code и $kk:review-spec. Security-архитектуру он отдаёт в mcp__pal__secaudit.
Какие задачи решает
- поймать ADR, где механизм объявлен, но в системе его нет
- сверить глоссарий и страницу ловушек как единый артефакт
- получить вердикт по каждому измерению, а не общий вывод
- оценить, насколько обратимо принятое решение
- увести security-архитектуру в
mcp__pal__secauditотдельным треком
Примеры запросов агенту
- Запусти
$kk:review-architecture <artifact-path>на ADR изdocs/adr/и покажи отчёт целиком. - Отревьюь архитектурный раздел дизайн-документа из
docs/feat/wip/и не трогай остальное. - Сверь доменный справочник
docs/domain/<context>.mdвместе с парной страницей ловушек.
Как установить review-architecture
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-code2Вручную: положить файлы
~/.claude/skills/review-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/review-architecture/
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-architecture -a codex2Вручную: положить файлы
.agents/skills/review-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-architecture -a cursor2Вручную: положить файлы
.cursor/skills/review-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install serpro69/claude-toolbox kodex-plugin/skills/review-architecture2Вручную: положить файлы
.github/skills/review-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/review-architectureВручную: положить файлы
.devin/skills/review-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о review-architecture
Как установить review-architecture в Claude Code?
Выполни npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-code. Скилл окажется в ~/.claude/skills/review-architecture/SKILL.md.
Что делает review-architecture?
Разбирает архитектурный документ на утверждения и проверяет, что названные механизмы существуют и связаны в правильную топологию. Решения оцениваются по контексту, который документ заявляет о себе сам.
Проверяет ли он поведение кода?
Нет, только наличие и топологию механизмов. Поведение в рантайме относится к $kk:review-code и $kk:review-spec, а угрозы безопасности уходят в mcp__pal__secaudit.