← ClaudeAtlas

debt-ops-addlisted

Register a deferred decision in the tech-debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer work, or when the user asks to log/register tech debt. Over-register freely; the developer drops with "drop A", "drop A,C", or "drop all".
bcanfield/agentic-tech-debt · ★ 6 · AI & Automation · score 71
Install: claude install-skill bcanfield/agentic-tech-debt
# debt-ops-add — register a tech-debt entry Call the bundled `register.py` via your shell tool. It lives in this skill's `scripts/` directory — reference it with the relative path below (your agent resolves it against the skill root). The helper writes the entry under the repo's detected registry dir (default `docs/debt/`), assigns a short batch letter (A, B, C…), and prints exactly one line: `+1 entry: <slug> (<letter>)`. That stdout IS the user-facing announcement — add no commentary before or after. ## The call ```bash python3 scripts/register.py \ --slug <slug> \ --principal <effort, e.g. 2d, 1w, unknown> \ --interest <ongoing cost, e.g. "+30min/incident", unknown> \ --hotspot <path or module, e.g. pricing/engine.ts, unknown> \ --business-capability <e.g. checkout, billing, unknown> \ --payoff-trigger <concrete trigger, or "unknown"> \ --quadrant <reckless-inadvertent|reckless-deliberate|prudent-inadvertent|prudent-deliberate> \ --category <migration|documentation|testing|code_quality|dead_code|code_rot|expertise|release|infrastructure|planning> \ --ai-authored <true|false> <<'EOF' <body: 2-5 sentences — what the debt is, why it exists, observed symptoms> EOF ``` The helper: - Generates the timestamp `id` itself (no `date` call needed). - Resolves filename collisions when two registrations land in the same second. - Tracks the letter mapping in `~/.cache/debt-ops/cache/<repo-hash>/current-turn.txt` (override the base with `DEBT_OPS_CACHE`) so the u