Design review panel for an architecture proposal
For: Engineering manager or architect taking a design document to review before build starts
The pain today
Design reviews depend on who shows up. The security, data, reliability and cost questions get asked late, by different people in different meetings, and the build starts with the gaps still in.
The ask
“I attached our design document for the new event pipeline, plus our security standard, data retention policy and reliability checklist. Review it from each of those angles, tell me what is missing or contradicts our standards, and quote the section each point is about.”
Plain words, as you would say it to a colleague. Edit it to fit your case before you send it.
What you attach or connect
- Design document or request for comments
- Security standard
- Data handling and retention policy
- Reliability and operability checklist
- Cost and capacity assumptions
The unit of work
One worker task per one reviewer brief against the design document.
Why a swarm fits
Each reviewer needs the document plus only its own standard. Separate briefs stop one concern from crowding out the others, and different model families notice different gaps.
Not for
A short change to one component: one strong model, or one colleague, reads it faster.
The decision tree
5 typed decisions, each with an action for every answer
At fixed moments in a run, the engine puts one narrow question to a decision model. The decision model never writes text: it answers yes or no with a probability, picks from listed options, or gives a score, about a small slice of the material. The engine then does exactly what this tree says, which is what makes the run auditable. The thresholds are the template's design values, not measured results.
Before workers, before a task runs
Small worker or strong modelYes or no, with a probability
Before a task runs
Does this design section describe storing, retaining, exporting or deleting data, so that the data reviewer must read it?
Sees only: One design section and the data reviewer's brief
Why: Each reviewer reads only the sections its standard speaks to.
- Yes: 0.60 or higherthenAccept
- Unsure: 0.25 up to 0.60thenAccept
- No: below 0.25thenSkip this unit
Small worker or strong modelYes or no, with a probability
Before a task runs
Does this section involve authentication, secrets, network exposure or separation between tenants closely enough to need the strong security reviewer?
Sees only: One design section and the security standard's table of contents
Why: Spends the expensive reviewer on the sections where a missed gap is costly.
- Yes: 0.60 or higherthenEscalate to a strong model
- Unsure: 0.30 up to 0.60thenEscalate to a strong model
- No: below 0.30thenAccept
After workers, the judge checks
Evidence checkYes or no, with a probability
After a worker answers
Does the quoted design section omit or contradict what the quoted line of the standard requires, rather than cover it in other words in the same section?
Sees only: The quoted design section and the quoted line of the standard
Why: Separates real defects from a reviewer not recognising the author's wording.
- Yes: 0.85 or higherthenAccept
- Unsure: 0.50 up to 0.85thenEscalate to a strong model
- No: below 0.50thenReject and retry
Reconciler, while merging
Conflict checkYes or no, with a probability
While reconciling
Do these two reviewers' recommendations for the same section pull in opposite directions, such as longer log retention for debugging against shorter retention for privacy?
Sees only: Two findings on the same design section
Why: Conflicting advice is a decision for the board, so it is kept rather than averaged away.
- Yes: 0.70 or higherthenMark unresolved
- Unsure: 0.40 up to 0.70thenMark unresolved
- No: below 0.40thenAccept
Accountable person, before anything is settled
Person decidesYes or no, with a probability
Before anything is reported as settled
Would this finding, if upheld, require changing the design before build starts rather than noting a follow-up?
Sees only: One verified finding with its quotes
Why: The review board decides what blocks a build; the panel never approves a design.
Accountable: The architect and the review board decide which findings block the build; the panel never approves a design.
- Yes: 0.40 or higherthenAsk a person
- Unsure: 0.15 up to 0.40thenAsk a person
- No: below 0.15thenAccept
The fleet: who does what
Model tiers by role, not brands: you choose the models. Strong reasoning models plan and reconcile, small fast models do the wide work, and the judge is a decision model from a different family, so it does not share the workers' blind spots.
Planner
A strong reasoning model splits the document by section and gives each reviewer its standard and checklist.
Workers
Mid-size reviewers from mixed families, one per brief: security, data, reliability, cost and operability.
Designed for 4 to 16 agents, one worker task per one reviewer brief against the design document. Each worker receives only its own unit.
Decisions here:1. Small worker or strong model2. Small worker or strong model
Judge, from a different model family
A decision model from a different family checks each finding is backed by a quoted section and a quoted standard.
Decisions here:3. Evidence check
Reconciler
A strong reasoning model merges findings, keeps reviewer disagreements side by side and lists unanswered questions.
Decisions here:4. Conflict check
Accountable person
The architect and the review board decide which findings block the build; the panel never approves a design.
Decisions here:5. Person decides
Checked before anything is accepted
- Every finding quotes the design section and the standard it fails
- Findings with no quoted standard are marked opinion, not defect
- Conflicting advice between reviewers is kept, not averaged
What comes back
- Findings by brief, with quotes
- Contradictions between the design and the standards
- Open questions for the author
- Places where reviewers disagree
What to measure
- Findings the author accepts
- Issues found during build that the panel missed
- Review turnaround
- Cost per review
Names of measures only. No result is claimed for this template.
Templates open in the workspace chat with the ask filled in. Nothing runs until you send it.
Get early accessSign in to useMore in Software engineering
Dependency and licence audit across a monorepo
For: Engineering lead or open-source compliance owner preparing a release, a sale or a customer audit
A monorepo pulls in a very long list of direct and transitive packages, each with its own licence text.
Migration impact map across services
For: Staff engineer or platform lead planning a framework, database or shared-library migration
A breaking upgrade touches modules owned by many teams.
Test case tournament for a module that must not break
For: Quality lead or engineer owning a payment, pricing or permissions module with thin tests
The module that must not break has happy-path tests only.