Skip to main content
skill CX Codex

review-architecture — Claude Code skill: architecture doc review

review-architecture is a Claude Code skill that checks a written architecture artifact against the system it describes.

no license ★ 155 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-code
Open on GitHub

What review-architecture does

Point it at one committed artifact and it turns the prose into a set of claims. Each claim is then checked for whether the named mechanism exists and sits in the right place: module boundaries, who owns which data, NFR mechanisms, failure isolation, state consistency, versioning, binding to the domain. A second pass grades the decisions against the context the artifact states for itself.

The checking runs in a read-only architecture-reviewer subagent. The skill owns acceptance and presentation, so it relays the full claim table, the per-dimension verdicts and the Not Reviewed section. Compressing that report throws away the inspectable middle artifact the claim set exists to be.

One artifact per call: $kk:review-architecture <artifact-path>. Diagrams need prose beside them, and two paths at once are rejected. For a domain-reference kit, pass either page and the glossary/traps counterpart is found automatically. Runtime behaviour is not its job: that is $kk:review-code and $kk:review-spec. Security architecture goes to mcp__pal__secaudit.

What it helps with

  • catch an ADR that names a mechanism the system does not have
  • review a glossary and its traps page as one composite artifact
  • get a verdict per dimension instead of a single overall grade
  • judge how reversible a decision is before building on it
  • route security architecture to mcp__pal__secaudit on its own track

Example prompts for the agent

  • Run $kk:review-architecture <artifact-path> on the ADR in docs/adr/ and relay the report in full.
  • Review only the architecture section of the design doc under docs/feat/wip/.
  • Review docs/domain/<context>.md as a composite together with its traps page.

How to install review-architecture

1Skills CLI (Vercel)

npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/review-architecture/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about review-architecture

How do I install review-architecture in Claude Code?

Run npx skills add serpro69/claude-toolbox --skill review-architecture -a claude-code. The skill lands in ~/.claude/skills/review-architecture/SKILL.md.

What does review-architecture do?

It splits an architecture document into claims, then verifies that each declared mechanism exists and is wired into the right topology. Decisions are graded against the context the document sets out for itself.

Does it check runtime behaviour?

No. It confirms a mechanism is present and correctly placed; what the code does under retries belongs to $kk:review-code and $kk:review-spec.

Similar skills

All skills for Code review and refactoring →

From the same set30

The whole set →
design design is a Claude Code skill that turns requirements into design documents and task plans before coding begins. It can also resume a feature in docs/feat/wip/. CX Codex +1 ★ 155repo stars model model reads one bounded context and leaves a glossary, a traps page, and a queue of questions that need a human answer. CX Codex +1 ★ 155repo stars architecture-reviewer The architecture-reviewer subagent for Claude Code independently checks architectural documents against repository code. It verifies declared structures, not runtime behavior. CX Codex ★ 155repo stars chain-of-verification chain-of-verification is a Claude Code skill that checks answers through independent questions and follow-up verification. It runs for fact-checking, technical claims, and multi-step reasoning. CX Codex +1 ★ 155repo stars review-code review-code reviews active git changes through an experienced engineering perspective. Identifies SOLID flaws, architecture issues, and security vulnerabilities. CX Codex +1 ★ 155repo stars review-design review-design is a Claude Code skill that checks design documents before implementation begins. It runs after $kk:design and reviews all documents by default. CX Codex +1 ★ 155repo stars review-spec review-spec is a Claude Code skill that compares code with feature docs and reports mismatches in both directions. Run it mid-feature or after completion. CX Codex +1 ★ 155repo stars design-reviewer design-reviewer audits feature designs and implementation plans without conversational bias. Flags ambiguities, missing edge cases, and contradictions before implementation begins. CX Codex ★ 155repo stars

Project sponsors

Companies that keep this analytics open