Generate-tech-debt

Maintain <cwd>/TECH_DEBT.md as a flat, append-mostly log of deferred work. Each entry is a sectioned markdown block with a stable TD-NNNN ID and structured metadata. The skill always asks the user whether to append a new entry or edit an existing one before writing — no silent overwrites.

This skill depends on /lets-quick-discussion being installed for the missing-fields path (step 3) — a deliberate cross-skill reference chosen by the maintainer. If /lets-quick-discussion is not available in the project, hard-stop in step 3 and ask the user for the missing fields directly.

Inputs and outputs

• Input: the user's freeform instruction describing one piece of tech debt — a known issue, a postponed cleanup, a deferred upgrade. May reference a file (path:line), a commit SHA, or a PR URL.
• Output: an edit to <cwd>/TECH_DEBT.md — either append a new ## TD-NNNN: <title> block or modify an existing entry. Pre-existing content is preserved verbatim; entries are never reordered.
• One-line report posted in the conversation: TD-NNNN added: <title> or TD-NNNN updated: <field>.

Entry schema

Every entry uses this exact shape so the file stays greppable:

## TD-NNNN: <title>