ponytail-debt

name	ponytail-debt
description	Harvest ponytail: comment markers into a debt ledger. Use for "ponytail debt", "/ponytail-debt", "list shortcuts", "ponytail ledger". Read-only unless user asks to write PONYTAIL-DEBT.md.

On-demand loading: Read when tracking deliberate ponytail deferrals marked in code.

When to use

• "ponytail debt", "/ponytail-debt", "what did ponytail defer", "list the shortcuts", "ponytail ledger"

Adapted from ponytail-debt (MIT). Works with rules/overlay-ponytail.mdc ponytail: convention.

Process

1. Grep repo for comment markers (skip node_modules, .git, build output):

   rg -n "ponytail:" --glob "!node_modules/**" --glob "!.git/**"

2. Each hit = one ledger row. Convention: ponytail: <ceiling>, <upgrade trigger>.

3. Output grouped by file:

   path:line — ceiling: … upgrade: …

4. Tag no-trigger when no upgrade path is named (rot risk).

5. End with N markers, M with no trigger. or No ponytail: debt. Clean ledger.

Boundaries

Read-only by default. Persist to PONYTAIL-DEBT.md only when user asks.