CalvinBackup/gstack
1
0
Fork 0
mirror of https://github.com/garrytan/gstack.git synced 2026-08-31 02:10:51 +02:00
Code Issues Packages Projects Releases Wiki Activity

feat(retro,preamble): gstack-shortcut debt ledger — accepted shortcuts leave a joined trail

Browse Source 
When the user accepts an option that is BOTH Completeness <= 7 AND a
durable-scope call, the decision ledger entry (gstack-decision-log, ceiling +
upgrade trigger in the rationale) is the source of truth, and the agent marks
each cut corner in code with gstack-shortcut(dec-<id>): <ceiling>, upgrade
when <trigger> — same edit, no follow-up question, never agent-initiated.

/retro Step 11.5 harvests markers into a debt ledger (grep || true — zero
matches is the healthy case; skill installs and docs excluded), joins on the
decision id so nothing double-counts, tags unlinked and no-trigger rot risks,
and closes with 'N markers, M with no trigger.'

/review suppressions: a marker with ceiling+trigger downgrades a would-be
Completeness Gaps finding to acknowledged debt. Redaction test pins that the
marker ships untouched (the ledger is the point) — it does not match the
TODO(owner) hygiene shape.

Format from dietrichgebert/ponytail's ponytail-debt; store inverted to gstack's
existing decision ledger.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-08-28 01:50:31 +00:00
co-authored by Claude Fable 5
parent 86530fe320
commit 80ae2b59fa
44 changed files with 144 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
retro/SKILL.md.tmpl
+26
View File
@@ -309,6 +309,32 @@ If the time window is 14 days or more, use the `WEEK:` lines (w0 = the week cont
- If the anchor date is today or yesterday, the streak is live: "Team shipping streak: 47 consecutive days" / "Your shipping streak: 32 consecutive days"
- If the anchor is older, the streak is broken: report 0 days and note the last shipping day.
### Step 11.5: Shortcut Debt Ledger
Harvest deliberate `gstack-shortcut(...)` markers — the trail left when the user
accepted a Completeness ≤ 7 option (see the AskUserQuestion Format section). Zero
matches is the healthy case, not a failure:
```bash
grep -rn "gstack-shortcut(" . \
--exclude-dir=.git --exclude-dir=node_modules --exclude-dir=vendor \
--exclude-dir=.claude --exclude-dir=dist \
--exclude="SKILL.md" --exclude="*.md.tmpl" 2>/dev/null || true
```
(The exclusions keep docs that merely document the convention — generated
SKILL.md, templates, skill installs — out of the ledger.)
For each hit, one ledger row: `<file>:<line>, <what was simplified>. ceiling: <X>. upgrade: <Y>.`
- Markers carry a decision id (`dec-<id>`): join against `gstack-decision-search`
output — the ledger entry is the source of truth; never double-count a marker
against its resurfaced decision.
- Markers WITHOUT an id: tag `unlinked`.
- Markers naming no upgrade trigger: tag `no-trigger` — those are the ones that
silently rot.
End the section with: `N markers, M with no trigger.` If none: `No shortcut debt. Clean ledger.`
### Step 12: Load History & Compare
Before saving the new snapshot, check for prior retro history: