ratchet-ops

Triage failing policy-check rows and author enforcement checks for shipped improvements.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill ratchet-ops-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ratchet-ops
Source: https://github.com/leonardoacosta/skills/tree/main/leo-core/skills/ratchet-ops
Command: npx skills add https://github.com/leonardoacosta/skills --skill ratchet-ops-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Config-ratchet lanes fail or get silently weakened when engineers narrow detectors, delete noisy rows, or ship improvements without matching enforcement checks. This Skill provides a disciplined procedure for triaging failing policy-check rows and authoring new ones so regressions cannot ship silently. ## Core Features & Use Cases - Failure triage: Read the ratchet snapshot, reproduce one failing row live, classify it as a real regression, pre-existing debt, or environment artifact, and verify with a pasted exit code. - Narrowest-control ladder: Work a four-rung ladder (fix, documented exemption, demote to INFO, delete) with an explain-first step before touching any contested row. - Ledger-closure authoring: Land an enforcement artifact (declared-requirement header, liveness header, policy-check row with counter function, or INFO row) in the same change as any shipped improvement. - Use Case: A nightly timer files an issue because the skill-descriptions-budget row fails. Use this Skill to reproduce the row, classify the failure, apply the correct ladder rung, and close the issue with the commit ref. ## Quick Start Ask the agent to triage the currently failing policy-check ratchet row and verify the fix with the blocking tier exit code.

Frequently Asked Questions about ratchet-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage a failing policy-check ratchet row?

Read the JSON snapshot first and print every error-level row, then reproduce one row live by invoking the runner's blocking tier in quiet mode. Classify the failure as a real regression, pre-existing debt, or environment artifact before editing anything, and verify with the pasted exit code.

What is the Ledger-closure rule for shipped improvements?

Any improvement recorded as shipped must add, in the same change, an enforcement artifact that would fail if it regressed. Depending on the improvement, that is a declared-requirement header, a liveness header, a policy-check row with a counter function, or an INFO row.

When should a policy-check row be blocking versus INFO?

Make a row blocking only when a failure is unambiguously wrong, such as a dropped key, banned token, or budget breach. If the right response is an operator judgment call, use an INFO row so people are not trained to silence the lane.

Can I narrow a detector or delete a noisy ratchet row?

Only after working the narrowest-control ladder top-down: fix the regression, add a documented KNOWN_GAPS-style exemption, demote to INFO, then delete as a last resort. Deleting requires stating why the incident class the row guards can no longer recur.

Why does a new ratchet row fail on a fresh checkout?

Rows landed against pre-existing debt are expected to fail initially; document this in the row's paragraph and track genuine offenders in a KNOWN_GAPS-style array beside the counter function. Also check for environment artifacts like a stale checkout before concluding anything.