honey-debt
Installation
SKILL.md
Honey Debt
Lever 1 trades code for a known ceiling. That trade is only honest if someone can
see it later. Every deliberate simplification carries a shortcut: comment naming its
ceiling and the trigger to revisit; this collects them into one ledger. Older code
may carry the previous honey: prefix — same convention, harvest both.
Scan
P='(#|//|--|/\*) ?(shortcut|honey):'
if git rev-parse --git-dir >/dev/null 2>&1; then git grep --untracked -nE "$P"
else grep -rnE "$P" . --exclude-dir={node_modules,.git,dist,build,vendor}; fi
Each hit is one row. git grep skips everything gitignored. The comment prefix is
what keeps prose that merely mentions the convention out of the ledger.