Agent quality council
Quality drifts when the standard lives in individuals. A council makes
the standard explicit and applies it identically to every artefact,
which is the one thing agents do better than tired humans under
deadline.
Team
- Reviewers: one per dimension that matters for the artefact type,
such as correctness, clarity, and completeness.
- Arbiter: resolves disagreement between reviewers against the
written standard, or escalates.
Shape: parallel dimension reviews converging on one verdict per
artefact.
Method
- Write the standard per artefact type. What good looks like for a
document, a release, a support reply, or a report, with observable
criteria rather than adjectives.
- Review dimensions in parallel and independently. A single
reviewer holding four concerns applies them unevenly; separate
reviewers each apply one properly (see agent-design-review-panel).
- Make findings specific and actionable. Location, the criterion
missed, and what would satisfy it. Unactionable findings get ignored
and teach people to ignore the council.
- Distinguish blocking from advisory. Only criteria that genuinely
must be met block, or the gate becomes an obstacle to route around
(see agent-qa-gate).
- Escalate disagreement rather than averaging. Two reviewers
disagreeing on a real issue is information, and averaging destroys
it.
- Track which criteria fail most. Repeated failures point at a
missing template, unclear guidance, or an unrealistic standard rather
than at careless people.
- Revise the standard deliberately. When an exception is accepted
repeatedly, the standard is wrong and should change explicitly.
Run it
In Claude Code, define one subagent per dimension reviewing the artefact
in parallel, each writing findings to its own file, then an arbiter pass
producing the verdict. Blocking findings stop the release until
resolved. Port to CrewAI as parallel review tasks into an arbitration
task, or LangGraph with a gate node.
Signals it works
- Findings cite a written criterion rather than a preference.
- Blocking and advisory are distinguished, and blocking is rare.
- Repeated failures change the standard or the template.
Boundaries
The council enforces a written standard; it cannot supply taste or
domain judgement, and a wrong standard applied consistently produces
consistently wrong output. Humans set the standard and decide
exceptions. Anything with legal, safety, or regulatory implications
needs qualified review beyond this gate.
1---2name: agent-quality-council3description: Hold a consistent standard across everything a company ships, with agents that review against written criteria and escalate disagreements rather than averaging them. Use when quality varies by who happened to do the work.4---56# Agent quality council78Quality drifts when the standard lives in individuals. A council makes9the standard explicit and applies it identically to every artefact,10which is the one thing agents do better than tired humans under11deadline.1213## Team1415- **Reviewers**: one per dimension that matters for the artefact type,16 such as correctness, clarity, and completeness.17- **Arbiter**: resolves disagreement between reviewers against the18 written standard, or escalates.1920Shape: parallel dimension reviews converging on one verdict per21artefact.2223## Method24251. **Write the standard per artefact type.** What good looks like for a26 document, a release, a support reply, or a report, with observable27 criteria rather than adjectives.282. **Review dimensions in parallel and independently.** A single29 reviewer holding four concerns applies them unevenly; separate30 reviewers each apply one properly (see agent-design-review-panel).313. **Make findings specific and actionable.** Location, the criterion32 missed, and what would satisfy it. Unactionable findings get ignored33 and teach people to ignore the council.344. **Distinguish blocking from advisory.** Only criteria that genuinely35 must be met block, or the gate becomes an obstacle to route around36 (see agent-qa-gate).375. **Escalate disagreement rather than averaging.** Two reviewers38 disagreeing on a real issue is information, and averaging destroys39 it.406. **Track which criteria fail most.** Repeated failures point at a41 missing template, unclear guidance, or an unrealistic standard rather42 than at careless people.437. **Revise the standard deliberately.** When an exception is accepted44 repeatedly, the standard is wrong and should change explicitly.4546## Run it4748In Claude Code, define one subagent per dimension reviewing the artefact49in parallel, each writing findings to its own file, then an arbiter pass50producing the verdict. Blocking findings stop the release until51resolved. Port to CrewAI as parallel review tasks into an arbitration52task, or LangGraph with a gate node.5354## Signals it works5556- Findings cite a written criterion rather than a preference.57- Blocking and advisory are distinguished, and blocking is rare.58- Repeated failures change the standard or the template.5960## Boundaries6162The council enforces a written standard; it cannot supply taste or63domain judgement, and a wrong standard applied consistently produces64consistently wrong output. Humans set the standard and decide65exceptions. Anything with legal, safety, or regulatory implications66needs qualified review beyond this gate.