debt-ops-addlisted
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