arch-review-full

Runs eight architecture lens-group reviews in parallel and merges them into one report.

89|10|Updated Sep 15, 2026
One-click install
npx skills add https://github.com/baristaze/swe_guidelines --skill arch-review-full-baristaze
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-review-full
Source: https://github.com/baristaze/swe_guidelines/tree/main/skills/arch-review-full
Command: npx skills add https://github.com/baristaze/swe_guidelines --skill arch-review-full-baristaze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a change against a full architecture guideline by hand means checking hundreds of rules across many concerns, which is slow and easy to do inconsistently. This Skill fans the review out to eight parallel reviewers, one per lens group, and merges their findings into a single deduplicated, severity-sorted report. ## Core Features & Use Cases - Parallel group reviews: Launches eight reviewers at once (object model, contracts, context, storage, async, network, delivery, ops), each judging only its own lens group against the guideline. - Static checker integration: Runs the arch-check static checker once on the working tree and distributes each group's relevant findings to its reviewer, so no reviewer re-runs it. - Deterministic merge: Deduplicates findings that flag the same path:line or the same symbol, sorts by severity, and counts applied, passed, findings, unverified, and not-applicable lenses across the whole catalog. - Use Case: Before opening a pull request that crosses layers, run the full review on the branch's diff range to get one consolidated report of every architecture rule the change breaks, with one-sentence fixes. ## Quick Start Ask the assistant to run a full architecture review over the files changed in your current branch compared to main.

Frequently Asked Questions about arch-review-full

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a full architecture review before a pull request?▼

Pass the skill a scope such as a diff range, commit, or path, and it resolves the scope once, launches eight parallel group reviewers, and merges their findings into one report sorted by severity. An empty scope is reported as nothing to review.

What lens groups does the full architecture review cover?▼

It covers eight groups: object model, contracts, context, storage, async, network, delivery, and ops. Each group is judged by its own reviewer against its lens file so no perspective is diluted by another.

Does the review run the static checker for every group?▼

No. The arch-check checker runs once from the repository root when the scope reads the working tree, and each reviewer receives only its group's portion of the output. For a range or commit scope the checker is skipped because it only reads the working tree.

What happens if one of the parallel reviewers fails?▼

A reviewer that fails or returns a malformed report is re-run once. If it fails again, that group is reported as not reviewed with the error, while the other seven groups still merge into the final report.

When should I use a single group review instead of the full review?▼

Use a single arch-review-<group> skill when the change touches only one concern, since the full review costs eight full reads of the scope. A narrow path or range is cheaper than reviewing the whole tree with all.