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.

Output

Installs
26
GitHub Stars
347
First Seen
Aug 5, 2026