Agent design review panel
Ask one reviewer to check "everything" and it checks the first thing it thinks
of, then calls the job done. Split the concern into fixed lenses, give each its
own agent, and the security hole the correctness reviewer skimmed past gets
caught by the agent that looks for nothing else. The shape is a parallel judge
panel: reviewers run independently, then a moderator merges their verdicts.
Team
- Correctness (
code-review): does the design meet the spec on every path.
- Security (
security-engineer-role): injection, authz gaps, secret
handling.
- Cost (
cloud-architect-role): compute, latency, and spend at real scale.
- Simplicity (
principal-architect-role): what can be deleted and still
work.
- Moderator (
staff-engineer): merges the four verdicts into one decision.
Method
- Give every reviewer the identical packet. The design doc, the spec it
answers, and the constraints. Same input, different lens, so a disagreement
reflects the lens and not a difference in what each one read.
- Run them in isolation. No reviewer sees another's findings before forming
its own. Cross-talk collapses four independent opinions into one loud one,
which is the exact failure the panel exists to prevent.
- Fix a common finding format. Each reviewer returns findings as
severity, location, concern, recommendation plus a one-word lens verdict:
approve, revise, or reject. A uniform shape lets the moderator merge without
re-reading four styles.
- Merge, dedupe, and rank by lens priority. The moderator collapses
duplicate findings and resolves conflicts by a stated order: a security
reject outranks a cost revise. It never overrules a lens on that lens's own
turf.
- Emit one verdict with the blocking lens named. Approve only when no lens
rejects. On a revise, the author fixes and the panel re-runs, capped at two
rounds before a human breaks the tie.
Run it
In Claude Code, spawn one subagent per lens in a single parallel Task batch,
each prompt carrying its lens and the shared packet, and forbid them from
reading each other's output. A separate moderator subagent reads the four
finding lists and writes the synthesis. Store each review and the synthesis as
files so the author sees who blocked and why. Terminate on a clean approve
across all lenses, or on the revise cap with escalation to a human. To port,
this is a CrewAI parallel task group feeding a synthesis task, an AutoGen
GroupChat with a summarizing manager, or a LangGraph fan-out to reviewer nodes
joining at a reducer.
Signals it works
- Findings cluster by lens, and no two reviewers report the same issue.
- The verdict names the exact lens that blocked, or approves cleanly.
- Reviewers reach different conclusions, proof they did not anchor on one voice.
Boundaries
A panel reviews a design or plan, not a line-level diff: for author-reviewer
iteration on code use agent-code-review-loop. Four lenses is a default, not a
law, add a performance or accessibility lens when the artifact demands it. The
moderator arbitrates priority; it does not invent findings the reviewers missed.
1---2name: agent-design-review-panel3description: Convene several reviewer agents with fixed distinct lenses, correctness, security, cost, and simplicity, then synthesize their verdicts into one. Use when a single review agent keeps missing whole classes of problems because it cannot hold every concern at once on a design or plan.4---56# Agent design review panel78Ask one reviewer to check "everything" and it checks the first thing it thinks9of, then calls the job done. Split the concern into fixed lenses, give each its10own agent, and the security hole the correctness reviewer skimmed past gets11caught by the agent that looks for nothing else. The shape is a parallel judge12panel: reviewers run independently, then a moderator merges their verdicts.1314## Team1516- **Correctness** (`code-review`): does the design meet the spec on every path.17- **Security** (`security-engineer-role`): injection, authz gaps, secret18 handling.19- **Cost** (`cloud-architect-role`): compute, latency, and spend at real scale.20- **Simplicity** (`principal-architect-role`): what can be deleted and still21 work.22- **Moderator** (`staff-engineer`): merges the four verdicts into one decision.2324## Method25261. **Give every reviewer the identical packet.** The design doc, the spec it27 answers, and the constraints. Same input, different lens, so a disagreement28 reflects the lens and not a difference in what each one read.292. **Run them in isolation.** No reviewer sees another's findings before forming30 its own. Cross-talk collapses four independent opinions into one loud one,31 which is the exact failure the panel exists to prevent.323. **Fix a common finding format.** Each reviewer returns findings as33 `severity, location, concern, recommendation` plus a one-word lens verdict:34 approve, revise, or reject. A uniform shape lets the moderator merge without35 re-reading four styles.364. **Merge, dedupe, and rank by lens priority.** The moderator collapses37 duplicate findings and resolves conflicts by a stated order: a security38 reject outranks a cost revise. It never overrules a lens on that lens's own39 turf.405. **Emit one verdict with the blocking lens named.** Approve only when no lens41 rejects. On a revise, the author fixes and the panel re-runs, capped at two42 rounds before a human breaks the tie.4344## Run it4546In Claude Code, spawn one subagent per lens in a single parallel Task batch,47each prompt carrying its lens and the shared packet, and forbid them from48reading each other's output. A separate moderator subagent reads the four49finding lists and writes the synthesis. Store each review and the synthesis as50files so the author sees who blocked and why. Terminate on a clean approve51across all lenses, or on the revise cap with escalation to a human. To port,52this is a CrewAI parallel task group feeding a synthesis task, an AutoGen53GroupChat with a summarizing manager, or a LangGraph fan-out to reviewer nodes54joining at a reducer.5556## Signals it works5758- Findings cluster by lens, and no two reviewers report the same issue.59- The verdict names the exact lens that blocked, or approves cleanly.60- Reviewers reach different conclusions, proof they did not anchor on one voice.6162## Boundaries6364A panel reviews a design or plan, not a line-level diff: for author-reviewer65iteration on code use `agent-code-review-loop`. Four lenses is a default, not a66law, add a performance or accessibility lens when the artifact demands it. The67moderator arbitrates priority; it does not invent findings the reviewers missed.