add-debtlisted

# Add Technical Debt <!-- prettier-ignore-start --> **Document Version:** 2.0 **Last Updated:** 2026-03-20 **Last Validated:** 2026-03-20 **Status:** ACTIVE <!-- prettier-ignore-end --> **Purpose:** Track technical debt items in the canonical TDMS tracker, whether discovered during PR review (deferred) or during ad-hoc development. **Quick Reference:** Minimum fields: file, line, title, severity (S0-S3), category. For PR deferrals: also provide PR number and reason. If all fields are provided in one message, skip to Step 4 (preview). ## When to Use - During PR review when issues are deferred for later (provide PR number) - When you discover tech debt during development outside formal audits - When an item should be tracked but won't be fixed immediately ## When NOT to Use - When running a formal audit — audits use `intake-audit.js` directly for bulk import - When adding items from automated sources (hooks, CI) — use `scripts/debt/intake-audit.js` directly - When items should be fixed immediately rather than tracked - When the item is already tracked in MASTER_DEBT.jsonl (check first) **Output Location:** `docs/technical-debt/MASTER_DEBT.jsonl` --- ## Workflow Detection This skill selects the appropriate workflow: | Context | Workflow | Source ID Format | | --------------------- | ------------ | ------------------- | | PR number provided | **Deferred** | `PR-{number}-{seq}` | | No PR number (ad-hoc) | **Manual** | `manual` |