Design review panel for an architecture proposal

For: Engineering manager or architect taking a design document to review before build starts

Pattern: Specialist panelNeeds live modelsDesigned for 4 to 16 agents

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.

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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.

  1. Planner

    A strong reasoning model splits the document by section and gives each reviewer its standard and checklist.

  2. 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

  3. 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

  4. Reconciler

    A strong reasoning model merges findings, keeps reviewer disagreements side by side and lists unanswered questions.

    Decisions here:4. Conflict check

  5. 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 use

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.

Pattern: Map, verify, reduceNeeds scale5 decisionsDesigned for 40 to 600 agents

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.

Pattern: Hierarchical decompositionNeeds a connector6 decisionsDesigned for 30 to 800 agents

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.

Pattern: TournamentNeeds a connector6 decisionsDesigned for 20 to 300 agents