architecture-review · owainlewis — скилл для Claude Code
Скилл architecture-review для Claude Code и Codex анализирует RFC, ADR или технические спецификации до написания кода. Проверяет архитектурные решения, риски безопасности и сценарии сбоев.
MIT 347 установок ★ 438 обновлён 2026-11-10
npx skills add owainlewis/blueprint --skill architecture-review -a claude-codeЧто делает architecture-review
Скилл подключается на этапе проектирования, когда правки стоят дёшево. Проверяющий сопоставляет документ с кодовой базой, REQUIREMENTS.md, текущими схемами и конфигурациями, сверяя каждое утверждение автора с реальным состоянием системы.
В процессе разбора агент трассирует один боевой запрос от входа до интерфейса, просчитывая поведение при сбоях, повторах и одновременном выполнении. Отдельно проверяются владение данными, миграции, откат изменений и границы авторизации. Любые стилистические правки отбрасываются: в отчёт попадают только критические блокеры и важные развилки, способные изменить архитектуру.
Проверку обязан выполнять сторонний исполнитель без права редактирования файлов — свежий субагент либо отдельный процесс вроде claude -p. Если изолированного проверяющего запустить негде или не хватает контекста, вердикт выставляется в статус Blocked.
Какие задачи решает
- найти тупиковые решения и уязвимости в RFC до написания кода
- смоделировать поведение системы при сетевых сбоях, повторах и параллельных запросах
- проверить реалистичность планов миграции данных и сценариев отката
- упростить дизайн системы за счёт сокращения состояний и лишних связей
Примеры запросов агенту
- Проверь архитектурный документ в docs/rfcs/002-billing.md на риски масштабирования и безопасность
- Сделай architecture review для спецификации новой схемы авторизации в spec.md
Как установить architecture-review
1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill architecture-review -a claude-code2Вручную: положить файлы
~/.claude/skills/architecture-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/architecture-review/
1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill architecture-review -a codex2Вручную: положить файлы
.agents/skills/architecture-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill architecture-review -a cursor2Вручную: положить файлы
.cursor/skills/architecture-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install owainlewis/blueprint skills/architecture-review2Вручную: положить файлы
.github/skills/architecture-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill architecture-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/owainlewis/blueprint --path skills/architecture-reviewВручную: положить файлы
.devin/skills/architecture-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill architecture-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об architecture-review
Как установить architecture-review в Claude Code?
Выполните команду npx skills add owainlewis/blueprint --skill architecture-review -a claude-code в терминале.
Что делает этот скилл?
Он детально инспектирует технические предложения (ADR, RFC, спецификации) до начала кодинга, формируя вердикт Approve, Request changes или Blocked с перечнем критических рисков.
Кто выступает ревьюером при запуске скилла?
Проверку должен проводить свежий субагент или изолированный агент в режиме чтения (claude -p или codex exec), который не участвовал в написании рассматриваемого документа.
Исходный текст
SKILL.md · MIT
--- name: architecture-review description: "Reviews a technical proposal before any code is written: an architecture, spec, RFC, ADR, or design issue. Finds choices that would make it wrong, unsafe, or impossible to prove, and the open questions that block building it." user-invocable: true argument-hint: "[architecture, spec, RFC, ADR, or issue]" disable-model-invocation: true --- # Architecture review Find the choices that would make a design wrong, unsafe, or impossible to prove, while they are still cheap to change. Judge the decisions, not the document's length or format. ## Reviewer Someone who did not write the proposal: a fresh subagent, or another agent CLI run read-only (`codex exec "<prompt>"` or `claude -p "<prompt>"`). If neither is available, say review is blocked. The reviewer changes nothing. ## Steps 1. Read the proposal, `REQUIREMENTS.md`, `ARCHITECTURE.md`, and the code, schemas, and config it touches. Check every claim about the current system against them. 2. Write down the problem, who it affects, the intended outcome, and the main tradeoff. Flag any the proposal leaves unclear. 3. Walk one real request from input to what the user sees, including what happens when a step fails, is retried, or runs twice at once. 4. Check data ownership, interfaces, migrations, rollback, security (auth, untrusted input, secrets), and the scale the proposal claims. 5. Look for a simpler design that gets the same result with less state or fewer moving parts. 6. Check that each important rule and failure has an acceptance check. ## Findings Report only what could change the design: - **Blocker:** unsafe, contradicts the goal or the current system, or cannot recover from a likely failure. - **Important:** two capable engineers could build it in ways that differ for users, data, or security. For each: where it is, what goes wrong and when, the evidence, and the smallest fix or your recommended answer. Say whether you ran it, traced it through the code, or only read the proposal. Skip wording preferences and questions that cannot change the design. No findings is a valid result. ## Verdict End with this block: ```text VERDICT: Approve | Request changes | Blocked UNVERIFIED: <what you could not check, or None> REVIEWED_AT: <commit SHA, or the proposal's date> ``` Any Blocker or Important finding means `Request changes`. Use `Blocked` when context or a reviewer is missing. A detailed document is not a reason to approve. On a later round, confirm the old findings are settled and review only what changed since `REVIEWED_AT`.
© owainlewis · MIT · owainlewis/blueprint
Похожие скиллы
Все скиллы по теме «Код-ревью и рефакторинг» →Сначала — architecture-review от других авторов.