Content
92%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.
The body is an exemplary release runbook: fully executable commands, explicit stop conditions and validation at every step, a clearly defined skip-live variant, and an explicit list of out-of-scope one-time actions. The only weakness is hardcoded volatile values (test count, model name/version) inline, which will age and slightly bloat the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is uniformly imperative with no concept explanations Claude already knows, but it hardcodes time-sensitive values inline ("the 131 tracked tests", "Sonnet 5, effort low", "v2") that will go stale and are not placed in a deprecated/old-patterns section, plus a few meta-sentences that could be trimmed. Fits anchor 4 ('efficient; minor instances that could be trimmed') better than 5. | 4 / 5 |
Actionability | Every step carries a copy-paste-ready command (`git status --porcelain`, `node e2e/live/run.mjs --all`, `gh workflow run release.yml --ref v2 -f sha=$(git rev-parse HEAD)`, `gh run watch`), and the skip-live variant includes the exact command variant and its expected notes line. Fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced steps each with explicit validation and stop conditions ("The branch must be `v2` and the tree must be clean", "If a row is `FAIL`, stop", "refuse to continue" at the skip limit), plus a defined error policy ("Stop and report at the first step that fails; do not retry"). The destructive/batch cap does not apply since validation checkpoints are present throughout. | 5 / 5 |
Progressive Disclosure | A self-contained runbook under 50 lines with no need for external references, organized as numbered steps plus clearly separated variant (`skip-live`) and exclusions sections. Per the rubric's simple-skill note, this scores 5 with just well-organized sections; no bundle files exist to reference. | 5 / 5 |
Total | 19 / 20 Passed |