debt

Solid

List every deliberate shortcut in the repo and whether it has a removal trigger. Use when the user says "procoder debt", "what shortcuts did we take", "technical debt ledger", "outstanding procoder markers", "what did we defer", or invokes /procoder:debt. Reports the ledger; it does not fix anything.

Code & Development 202 stars 15 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 84/100

Stars 20%
77
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# procoder:debt A deliberate shortcut is fine. An undated one is rot. This is the ledger. ## Procedure 1. **Find the markers.** - Deliberate: `git grep -n "procoder:"` - Informal: `git grep -nE "TODO|FIXME|HACK|XXX|@deprecated|@Deprecated|Obsolete\("` <!-- procoder: literal alone/orphan-todo, alone/deprecated-no-trigger the doctrine names this pattern, it is not an instance of it --> 2. **Age and author each one.** `git log -1 --format="%ar %an" -S "<marker text>" -- <file>` Fall back to `git blame -L <line>,<line> -- <file>` when `-S` finds nothing. 3. **Classify each marker.** | Status | Test | |---|---| | dated | has a removal trigger — a version, a date, or a measurable condition | | undated | no removal trigger; itself a `[4 ALONE]` violation | | overdue | the trigger has passed — version shipped, date gone, condition met | Check an overdue trigger against reality: `git tag --sort=-creatordate | head` for versions, today's date for dates. 4. **Read the baseline.** If `.procoder-baseline.json` exists, report its fingerprint count as accepted debt. It is part of the ledger. ## Output One table, oldest first: | age | file:line | marker | trigger | status | |---|---|---|---|---| | 14 months | api/users.ts:42 | HACK: skip authz in dev | — | undated | <!-- procoder: literal alone/orphan-todo the doctrine names this pattern, it is not an instance of it --> | 3 months | queue/worker.go:88 | procoder: single lock | throughput > 1k/s |...

Details

Author
azrtydxb
Repository
azrtydxb/procoder
Created
3 weeks ago
Last Updated
today
Language
Go
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category