CalvinBackup/gstack
1
0
Fork 0
mirror of https://github.com/garrytan/gstack.git synced 2026-09-09 14:38:59 +02:00
Code Issues Packages Projects Releases Wiki Activity

fix(retro): shortcut harvest drops placeholder markers and convention docs

Browse Source 
The Step 11.5 grep matched documentation mentions (dec-<id>, dec-*) in
checklists, resolver sources, and convention tests, reporting phantom debt
rows on gstack itself. A trailing filter kills placeholder forms; prose
tells the agent to discard convention-quoting hits.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-08-29 05:18:34 +00:00
co-authored by Claude Fable 5
parent b677b29c47
commit 385ca73283
2 changed files with 14 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
retro/SKILL.md
+7 -2
View File
@@ -795,11 +795,16 @@ matches is the healthy case, not a failure:
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
--exclude="SKILL.md" --exclude="*.md.tmpl" 2>/dev/null \
| grep -vE "gstack-shortcut\(dec-(<|\*)" || true
```
(The exclusions keep docs that merely document the convention — generated
SKILL.md, templates, skill installs — out of the ledger.)
SKILL.md, templates, skill installs — out of the ledger, and the trailing
filter drops placeholder forms like `dec-<id>` / `dec-*` that documentation
uses. Judgment call on what survives: discard any hit that quotes or tests
the convention itself — a sample marker in a checklist, resolver source, or
convention test — rather than marking a real cut corner in this repo's code.)
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`
retro/SKILL.md.tmpl
+7 -2
View File
@@ -319,11 +319,16 @@ matches is the healthy case, not a failure:
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
--exclude="SKILL.md" --exclude="*.md.tmpl" 2>/dev/null \
| grep -vE "gstack-shortcut\(dec-(<|\*)" || true
```
(The exclusions keep docs that merely document the convention — generated
SKILL.md, templates, skill installs — out of the ledger.)
SKILL.md, templates, skill installs — out of the ledger, and the trailing
filter drops placeholder forms like `dec-<id>` / `dec-*` that documentation
uses. Judgment call on what survives: discard any hit that quotes or tests
the convention itself — a sample marker in a checklist, resolver source, or
convention test — rather than marking a real cut corner in this repo's code.)
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`