Content
100%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Excellent content: specific, lean, and correctly scoped, with an explicit write-run-fix loop, concrete commands and file templates, and clean separation of the main workflow from Playwright details and the output template. No dimension shows a meaningful weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and directive throughout: every line is either an instruction, a project-specific constraint, or a non-obvious operational detail ("Prefer `localhost` to `127.0.0.1`, because dev servers often listen on IPv6 only"; "Never use `pkill -f` with a pattern that also appears in your own command line"). No concept explanations Claude already knows and no padding to trim. | 5 / 5 |
Actionability | Fully executable guidance: a copy-paste-ready command ("pnpm exec playwright test <file> --timeout=15000 --max-failures=1"), a concrete pid pattern ("cmd & pid=$!"), complete file templates for test-plan.md and ledger.md with example rows, a screenshot naming convention ("screenshots/ac2-filter-after-reload.png"), and example ledger lines. The only unavoidably abstract parts (the tests themselves) are task-specific and delegated to references/playwright.md, which supplies the concrete patterns. | 5 / 5 |
Workflow Clarity | Clear sequence with explicit validation checkpoints and a feedback loop: read inputs → sort criteria into observable/internal → write one test, "Run only that test", and on failure "read the failure, and only then the product code it points at… Fix the test with a small edit and run it again". The failure-is-a-finding rule ("Do not weaken the assertion and do not change product code") and the closing checklist ("Every criterion must have a row in the test plan or a ledger line with a reason") complete the loop. | 5 / 5 |
Progressive Disclosure | A 73-line overview with well-signaled, one-level-deep references, both verified real: "For Playwright projects, follow [references/playwright.md]" and "Return only the `factory.qa.v1` template in [references/output.md]". Playwright-specific patterns and the output template are appropriately split out of the main file, and the references do not nest further. | 5 / 5 |
Total | 20 / 20 Passed |