Skip to content

docs(testing): describe the Quorum eval lab accurately, replacing stale Drill references - #2135

Open
obra wants to merge 1 commit into
devfrom
docs/drill-to-quorum
Open

docs(testing): describe the Quorum eval lab accurately, replacing stale Drill references#2135
obra wants to merge 1 commit into
devfrom
docs/drill-to-quorum

Conversation

@obra

@obra obra commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Problem

The eval harness was renamed Drill → Quorum and rewritten from Python/uv to Bun/TypeScript. docs/testing.md and CLAUDE.md still said Drill (8 occurrences), and the quick start gave uv sync / uv run drill run ... -b claude — commands that no longer exist.

Fix

Verified against evals/README.md and the checkout in evals/, not just renamed:

  • Quorum described as what it is — the harness CLI, one part of the eval lab: it drives real coding-agent CLIs through a Gauntlet QA agent and grades against scenario acceptance criteria plus deterministic post-checks.
  • Quick start now matches reality: bun install, SUPERPOWERS_ROOT, bun run quorum run scenarios/<name> --coding-agent claude (scenarios are directories now, not *.yaml).
  • Added the safety pointer: live evals run agents in permissive modes; only the static gates are CI-safe (per the eval repo's Live Eval Risk section).
  • Inline drill mentions in the plugin-test list updated to quorum.

Provenance

Drift originally reported in PR #2121 (@JFWaskin), closed because its replacement quick start still used uv and claimed verification it didn't do; this version is written from the eval repo's own README.

Who is submitting

Claude Fable 5 on Claude Code 2.1.228, working the triage build queue directed by @obra, who reviews the diff.

@arittr @ada-sen — review requested.

…le Drill references

The evals harness was renamed Drill -> Quorum and rewritten from
Python/uv to Bun/TypeScript; docs/testing.md and CLAUDE.md still
described the old tool. Beyond the rename, the old text also
misdescribed the system: quorum is the harness CLI, one part of the
eval lab — it drives real coding-agent CLIs through a Gauntlet QA
agent and grades against scenario acceptance criteria plus
deterministic post-checks. The quick start now matches the eval
repo's actual commands (bun install / bun run quorum run
scenarios/<name> --coding-agent claude; scenarios are directories,
not *.yaml) and points at the Live Eval Risk section before anyone
runs a permissive-mode session.

Drift reported in closed PR #2121 (@JFWaskin); that PR's replacement
quick start kept the uv commands, so this rewrite goes from the eval
repo's README instead.
@obra
obra requested a review from arittr August 13, 2026 00:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant