К основному содержанию
скилл CX Codex

architecture-review · owainlewis — скилл для Claude Code

Скилл architecture-review для Claude Code и Codex анализирует RFC, ADR или технические спецификации до написания кода. Проверяет архитектурные решения, риски безопасности и сценарии сбоев.

MIT 347 установок ★ 438 обновлён 2026-11-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add owainlewis/blueprint --skill architecture-review -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/architecture-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/architecture-review/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

architecture-review Donchitos Скилл architecture-review для Claude Code, Codex, Cursor и других агентов: строит матрицу трассировки требований из GDD к архитектурным решениям (ADR). Запускается вручную перед переходом из технической подготовки в препродакшн. CX Codex +1 653установок architecture-review decebals Скилл architecture-review для Claude Code: макроразбор Java-проекта — структура пакетов, границы модулей, направление зависимостей и слои. Выявляет, где нарушена архитектура и что с этим делать. CX Codex +1 394установок review-architecture serpro69 Скилл review-architecture проверяет написанный архитектурный артефакт (ADR, architecture doc или раздел дизайн-документа) на соответствие системе, которую тот описывает. CX Codex +1 ★ 155звёзд репо System Architecture Reviewer microsoft Субагент System Architecture Reviewer разбирает архитектурные решения с учётом ограничений проекта, фиксирует компромиссы и помогает сохранить обоснование решений. Пригодится перед выбором архитектуры или оформлением ADR. CX Codex +1 ★ 1 627звёзд репо adr-review ruvnet Скилл adr-review сверяет git-дифф с принятыми записями архитектурных решений (ADR). Помогает выявить нарушения архитектуры и устаревшие паттерны перед слиянием ветки. CX Codex +1 747установок architecture-compass stark-ai-de Скилл architecture-compass для Claude Code и Codex помогает управлять архитектурными решениями и проверять, как код им соответствует. Запускает аудит, настраивает ADR или ведёт ограниченный рефакторинг. CX Codex +1 2 700установок Python Backend Architecture Review rknall Скилл Python Backend Architecture Review для Claude Code: ревью архитектуры Python-бэкенда по системе, масштабируемости, безопасности и API. Разбирает документ проекта, находит узкие места в дизайне до релиза. CX Codex +1 528установок technical-spec majiayu000 Скилл technical-spec помогает готовить технические спецификации, RFC и архитектурные решения (ADR) по жёстким правилам оформления. CX Codex +1 245установок

Из того же набора9

plan Скилл plan делит спецификацию на законченные вертикальные срезы, каждый из которых агент сдаёт в одном pull request. Срабатывает при планировании крупной задачи перед написанием кода. CX Codex +1 788установок review Скилл review для Claude Code и Codex запускает изолированное ревью изменений без права записи. Проверяет совпадение со спецификацией, безопасность и поведение кода на некорректных данных. CX Codex +1 787установок task-to-pr Скилл task-to-pr ведёт задачу от тикета до открытого pull request: ветка, тесты, Conventional Commit, проверка CI и независимое ревью. Мержит только по явной команде. CX Codex +1 452установок spec Скилл spec для Claude Code и Codex формирует спецификацию отдельной фичи перед написанием кода. Он описывает пользовательские сценарии и технический дизайн в виде готового тикета. CX Codex +1 440установок improve Скилл improve для Claude Code упрощает существующий код, сохраняя его поведение. Агент ищет дубли, мёртвый код, слабые имена и лишние абстракции. CX Codex +1 372установок architecture Создаёт или обновляет файл ARCHITECTURE.md в корне проекта по шаблону. Сверяет требования с кодовой базой и фиксирует системные границы. CX Codex +1 331установок html-doc Скилл html-doc превращает готовый Markdown PRD или технический дизайн в статическую HTML-страницу для чтения в браузере. Он также проверяет результат. CX Codex +1 288установок codex-issue-coordinator Скилл codex-issue-coordinator запускает отдельных AI-воркеров на каждую задачу из списка или вехи GitHub, следит за их PR и тестами, и сам мержит, когда всё готово. Подходит, когда нужно обработать пачку задач в одном потоке Codex. CX Codex +1 241установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой