msd-core/get-shit-done/workflows/research-phase.md at 7de17fca8a97f9a4eae87cbb5beaae5df5620df8

Files

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

1.8 KiB

Raw Blame History

Research how to implement a phase. Spawns gsd-phase-researcher with phase context.

Standalone research command. For most workflows, use /gsd:plan-phase which integrates research automatically.

Step 0: Resolve Model Profile

@~/.claude/get-shit-done/references/model-profile-resolution.md

Resolve model for:

gsd-phase-researcher

Step 1: Normalize and Validate Phase

@~/.claude/get-shit-done/references/phase-argument-parsing.md

PHASE_INFO=$(node ~/.claude/get-shit-done/bin/gsd-tools.js roadmap get-phase "${PHASE}")

If found is false: Error and exit.

Step 2: Check Existing Research

ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null

If exists: Offer update/view/skip options.

Step 3: Gather Phase Context

# Phase section from roadmap (already loaded in PHASE_INFO)
echo "$PHASE_INFO" | jq -r '.section'
cat .planning/REQUIREMENTS.md 2>/dev/null
cat .planning/phases/${PHASE}-*/*-CONTEXT.md 2>/dev/null
# Decisions from state-snapshot (structured JSON)
node ~/.claude/get-shit-done/bin/gsd-tools.js state-snapshot | jq '.decisions'

Step 4: Spawn Researcher

Task(
  prompt="<objective>
Research implementation approach for Phase {phase}: {name}
</objective>

<context>
Phase description: {description}
Requirements: {requirements}
Prior decisions: {decisions}
Phase context: {context_md}
</context>

<output>
Write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
</output>",
  subagent_type="gsd-phase-researcher",
  model="{researcher_model}"
)

Step 5: Handle Return

## RESEARCH COMPLETE — Display summary, offer: Plan/Dig deeper/Review/Done
## CHECKPOINT REACHED — Present to user, spawn continuation
## RESEARCH INCONCLUSIVE — Show attempts, offer: Add context/Try different mode/Manual

1.8 KiB Raw Blame History