3-review

Reviews a built change from six independent lenses and writes one review file per lens.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/AiFirstDevelopment/quorum --skill 3-review-aifirstdevelopment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 3-review
Source: https://github.com/AiFirstDevelopment/quorum/tree/main/plugins/quorum/skills/3-review
Command: npx skills add https://github.com/AiFirstDevelopment/quorum --skill 3-review-aifirstdevelopment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated code often gets reviewed by the same session that wrote it, which rationalizes its own choices instead of investigating them. This Skill runs step 3 of the quorum pipeline: it reviews the built change from several independent lenses in fresh context, producing a panel of evidence for adjudication rather than a single self-agreeing opinion. ## Core Features & Use Cases - Six independent review lenses: behavior (operates the running app), correctness, spec-fidelity against plan.md, security, simplicity, and test-quality, each run in fresh context via separate subagents where available. - Structured review files: each lens writes a numbered findings file to docs/work/<slug>/reviews/ with severity levels (blocker, major, minor, nit), file:line references, and concrete failure scenarios. - Pipeline state tracking: records the reviewed commit head, round number, findings count, and any dropped lenses via the quorum state script so later steps know exactly what was examined. - Use Case: After a plan has been built, run the review step to get six blind reviews of the diff — including one that launches and drives the actual application — before adjudicating findings and opening a pull request. ## Quick Start Run the review step on a built work item by invoking /quorum:3-review with the work item's slug.

Frequently Asked Questions about 3-review

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

FAQPage Schema
How do I review AI-generated code without self-confirmation bias?▼

Review the diff in fresh context rather than the session that wrote the code, since the original session rationalizes its own choices. This Skill spawns a separate subagent per review lens so no lens is anchored by another's conclusions or by the build narrative.

What review lenses does the quorum review step run?▼

It runs six lenses by default: behavior, correctness, spec-fidelity, security, simplicity, and test-quality. A lens may be dropped only if genuinely inapplicable, and dropped lenses are recorded as missing in the pipeline state.

How does the behavior lens differ from static code review?▼

The behavior lens launches and operates the assembled application as a user would, walking each acceptance criterion and then going off-script. It reports observed behavior rather than reading the diff, catching defects that static analysis misses.

Can the review step fix the problems it finds?▼

No. The review step changes no code, not even obvious typos, because reviews are evidence for the adjudication step that follows. A reviewer who edits contaminates the record the judge relies on.

What makes a valid finding in a review file?▼

Every finding needs a file and line reference plus a concrete failure scenario describing inputs and the wrong result. Findings are rated blocker, major, minor, or nit, and speculative findings without a failure scenario should be dropped.