addlisted

# add — register a tech-debt entry Call the bundled `register.py` via Bash — it lives in this skill's `scripts/` directory, so reference it with the relative path below (Codex 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 user can drop by letter.