harness-ratchet
Turn a repeated agent or prod failure into a permanent harness improvement (test/hook/script + optional AGENTS line + RULE-PROVENANCE). Use when user says harness-ratchet, ratchet this failure, never
SKILL.md.claude/skills/harness-ratchet/SKILL.md
GitHubHarness ratchet
When
A bug or agent mistake is repeatable and should never land silently again.
Protocol
- Capture the failure in 3 bullets (symptom, root cause class, blast radius).
- Prefer sensor over prose:
- unit/api test, fitness rule, golden case, hook deny, pre-release step
- If prose needed: ≤2 lines in
AGENTS.md+ row indocs/team/harness/RULE-PROVENANCE.md. - Update
docs/team/harness/HARNESS-MAP.mdif a new guide/sensor appears. - Run
npm run harness:score:reportand note delta. - Append example line to
docs/team/harness/RATCHET-EXAMPLE.mdor BITACORA.
Anti-patterns
- Adding AGENTS rules without a sensor
- Disabling human gates “to unblock”
- Ratcheting one-off non-repeatable noise
Done
Sensor fails on the old bug; score does not drop; provenance updated.