Lex Christopherson
fa81821df4
feat: add --include flag to init commands to eliminate redundant file reads
...
Workflows were calling init commands to get parsed JSON metadata, then
immediately reading the same files again with cat to pass raw content
to agents. This wastes context tokens.
Changes:
- Add --include flag to init execute-phase, plan-phase, and progress
- Support includes: state, config, roadmap, requirements, context,
research, verification, uat, project
- Update plan-phase.md to use --include (removes 6 cat calls)
- Update execute-phase.md to use --include (removes 2 cat calls)
- Update execute-plan.md to use --include (removes 2 cat calls)
- Update progress.md to use --include (removes 4 cat calls)
- Add 7 tests for --include functionality
Token savings: ~5,000-10,000 tokens per plan-phase execution,
~1,500-3,000 per other workflow executions.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-08 01:43:22 -06:00
TÂCHES
6c537373c6
feat: add context-optimizing parsing commands to gsd-tools ( #473 )
...
Add three new commands that extract structured data from GSD files,
reducing context usage by returning only parsed fields instead of
raw file content:
- phase-plan-index: Plans grouped by wave with metadata (id, wave,
autonomous, objective, files_modified, task_count, has_summary)
- state-snapshot: Parsed STATE.md fields (current phase, decisions,
blockers, session info)
- summary-extract: Frontmatter extraction with optional --fields filter
Update workflows to use new commands:
- execute-phase: Use phase-plan-index instead of ls + grep loop
- plan-phase: Use state-snapshot for decisions
- research-phase: Use state-snapshot for decisions
- complete-milestone: Use summary-extract for one-liners
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-08 01:08:19 -06:00
TÂCHES
1b317dec45
feat: extract repetitive bash patterns into gsd-tools commands ( #472 )
...
* feat(gsd-tools): add history-digest, atomic state operations, and summary variants
Adds new performance-focused commands to gsd-tools and introduces specialized
summary templates to reduce context tax:
- history-digest: Compiles phase summaries into structured JSON for JIT loading
- state get/patch: Enables atomic STATE.md operations instead of full rewrites
- template select: Automatically chooses optimal summary template based on plan complexity
- Adds minimal, standard, and complex summary templates
Part of the "Hydra" architecture for GSD context optimization.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* chore: add project config
* docs: define v1 requirements
* docs: create roadmap (6 phases)
* feat(history-digest): fix nested YAML parsing and add tests
- Fix extractFrontmatter() to handle nested YAML structures like
dependency-graph.provides, tech-stack.added using stack-based parsing
- Add test infrastructure with Node test runner (npm test)
- Update gsd-planner to use digest fields directly instead of reading
full SUMMARY.md files
- Add 6 schema validation tests covering nested fields, merging,
malformed files, and backward compatibility
Closes: HIST-01, HIST-02, HIST-03, HIST-04
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* fix(planner): use digest for selection, full SUMMARY for understanding
The previous commit went too far by eliminating full SUMMARY reads.
The digest is an index for smart selection, not a replacement for
understanding what actually happened.
Two-step approach:
1. Digest to score/select relevant phases (2-4 typically)
2. Full SUMMARY read for selected phases (implementation details)
3. Digest-level context retained for unselected phases
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* feat(gsd-tools): add phases, roadmap, and phase commands
TDD implementation of three new commands to replace repetitive bash:
phases list [--type plans|summaries] [--phase N]
- Lists phase directories sorted numerically (handles decimals)
- Filter by file type or specific phase
- Replaces: ls -d .planning/phases/*/ | sort -V (22 occurrences)
roadmap get-phase <N>
- Extracts phase section from ROADMAP.md
- Returns name, goal, full section content
- Replaces: grep -A20 "Phase X:" ROADMAP.md (19 occurrences)
phase next-decimal <N>
- Calculates next decimal phase (06 → 06.1, 06.2 → 06.3)
- Handles gaps, normalizes input
- Replaces: complex bash math in insert-phase (3 occurrences)
16 new tests, all passing.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* refactor: migrate agents/workflows to use gsd-tools commands
Replace inline bash patterns with centralized gsd-tools commands:
phases list:
- audit-milestone.md: ls -d .planning/phases/*/ | sort -V
- plan-milestone-gaps.md: ls -d ... | sort -V | tail -1
roadmap get-phase:
- plan-phase.md: grep -A5 "Phase X:" ROADMAP.md (2 occurrences)
- research-phase.md: grep patterns (2 occurrences)
- verify-phase.md: grep -A5 pattern
- gsd-verifier.md: grep -A5 pattern
- gsd-plan-checker.md: grep -A10 pattern
- commands/gsd/research-phase.md: grep patterns (2 occurrences)
phase next-decimal:
- insert-phase.md: complex bash decimal calculation
- decimal-phase-calculation.md: reference doc rewritten
phase-argument-parsing.md: updated to reference gsd-tools
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-08 00:44:49 -06:00
TÂCHES
246d542c65
feat(gsd-tools): add compound init commands and update workflows ( #468 )
...
* feat(gsd-tools): add compound init commands for workflow setup
Adds 8 compound commands that return all context a workflow needs in
one JSON blob, replacing 5-10 atomic calls per workflow:
- init execute-phase: models, config, phase info, plan inventory
- init plan-phase: models, workflow flags, existing artifacts
- init new-project: models, brownfield detection, state checks
- init new-milestone: models, milestone info
- init quick: models, next task number, timestamps
- init resume: file existence, interrupted agent
- init verify-work: models, phase info
- init phase-op: generic phase context
Updated 8 workflows to use compound commands:
- execute-phase, plan-phase, new-project, quick
- resume-project, verify-work, discuss-phase
Token savings: ~200 lines of bash setup replaced with single init calls.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* feat(gsd-tools): add 4 new init commands and update files to use compound commands
Add new compound init commands:
- init todos - context for todo workflows
- init milestone-op - context for milestone operations
- init map-codebase - context for codebase mapping
- init progress - context for progress workflow
Update 24 files to use compound init commands instead of atomic calls:
- 4 phase operation workflows (add-phase, insert-phase, remove-phase, verify-phase)
- 5 todo/milestone workflows (add-todo, check-todos, audit-milestone, complete-milestone, new-milestone)
- 6 misc workflows (execute-plan, map-codebase, pause-work, progress, set-profile, settings)
- 6 agent files (gsd-executor, gsd-planner, gsd-phase-researcher, gsd-plan-checker, gsd-debugger, gsd-research-synthesizer)
- 2 command files (debug, research-phase)
- 1 reference file (planning-config)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* fix(gsd-tools): add init to help output
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
* fix(verify-phase): correct expected init fields
The workflow was referencing plans/summaries from init phase-op,
but those fields come from ls command. Updated to reference
has_plans and plan_count which are actually in phase-op output.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-07 22:09:07 -06:00
TÂCHES
01ae939c01
feat(gsd-tools): add CLI utility for command extraction
...
Centralizes repetitive bash patterns across 50+ GSD files.
Functions: state load/update, resolve-model, find-phase, commit,
verify-summary, generate-slug, current-timestamp, list-todos,
verify-path-exists, config-ensure-section
Enables thin orchestrator pattern. Replaces 200-400 chars per usage.
Ported from: get-shit-done-v2@ce5400f
2026-02-07 11:08:21 -06:00
