Content
86%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.
A dense, well-structured contract: prescriptive rules with concrete definitions, paths, and thresholds; clean one-level-deep references to a real schema and template; and no filler. Remaining gaps are minor — a couple of per-stage indicators lack derivation formulas, and the reporting sequence is implied by section order rather than explicit steps.
Suggestions
Add one-line derivation rules (or point to where they live) for table indicators named without formulas, e.g. 'defect escape rate' and 'eval pass rate'.
State the reporting sequence explicitly (gather raw counts → derive indicators → apply bands → emit artifacts/sdlc-metrics.md) instead of leaving the order implicit across sections 1–5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout: 'Measure the handoffs, not the keystrokes', 'unavailable inputs are reported as unavailable, never estimated', 'No composite scores: do not blend indicators into a single productivity number'. It never explains what DORA or git is, assumes Claude's competence, and every section prescribes rather than pads. | 5 / 5 |
Actionability | Guidance is concrete and executable for an instruction-only skill: exact metric definitions ('Change failure rate: deploys needing hotfix or rollback, divided by deploys'), concrete paths ('docs/ops/bands.yaml', 'artifacts/sdlc-metrics.md'), and a per-stage indicator table. Not anchor 5 because a few table indicators such as 'defect escape rate' and 'eval pass rate' are named without a derivation rule in either the body or the schema reference. | 4 / 5 |
Workflow Clarity | The reporting workflow is well structured — emit at 'a workflow terminal state, alongside artifacts/session-cost.md', 'Load references/metrics-schema.md for the report skeleton', band 'Detection is deterministic and computed before any agent reads the signal' — with report-time checkpoints (cite source, mark unavailable, trend vs previous). Not anchor 5 because the gather → derive → emit sequence is implicit in sections rather than stated as an ordered procedure. | 4 / 5 |
Progressive Disclosure | The body is an overview contract that delegates detail at the right depth: 'Load references/metrics-schema.md for the report skeleton' and 'Schema: references/bands-template.yaml', both real files in the bundle, confirmed one level deep with no further nested references, plus a clean References section. Content is appropriately split between the contract body, the report skeleton, and the bands template. | 5 / 5 |
Total | 18 / 20 Passed |