| name | debt |
| description | Harvest `debt:` markers across the repo into a read-only ledger without modifying code. |
| argument-hint | [optional path, area, or debt focus] |
Debt
Use this skill when the user wants to inspect intentional simplification markers such as // debt: or # debt:. It is read-only: report the ledger, do not edit code, and do not resolve debt inside this skill.
Process
- Search the repo for markers:
rg -n '(#|//) ?debt:' . \
-g '!node_modules/**' \
-g '!.git/**' \
-g '!dist/**' \
-g '!build/**' \
-g '!.agmo/cache/**' \
-g '!**/.pnpm-store/**' \
-g '!**/.yarn/**'
- Build a ledger grouped by file. For each marker, include
file:line, the stated limitation, and the upgrade: trigger when present.
- Tag markers that do not include an upgrade trigger as
no-trigger.
- Summarize with
<N> markers, <M> with no trigger. If none are found, report No debt markers. Clean ledger.
- Output the ledger to the user. Persist it only when the user explicitly asks; persistence is never automatic.
Optional Handoff
After presenting the ledger, scan for upgrade: triggers that appear to be met. Offer, but do not auto-run, a handoff:
"These markers may be ready to resolve: [list]. Which rows should I hand to plan?"
Only after explicit confirmation, route selected rows to plan with their file:line, limitation, and trigger. The normal plan -> execute path handles fixes. This skill still never edits markers or code.
Constraints
- Read-only. Do not modify code, markers, plans, or vault notes unless the user explicitly asks for persistence.
- One-shot. Do not loop or re-scan unless requested.
- Use only the marker convention documented in the executor prompt:
// debt: <limitation>, upgrade: <trigger> or # debt: <limitation>, upgrade: <trigger>.
- Do not fabricate savings, impact, or priority numbers. The ledger count is the only numeric claim this skill owns.