AGENTS/.pi/gsd/workflows/research-phase.md

Context (pre-injected)

Phase:

Phase Data:

Roadmap:

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.

<available_agent_types> Valid GSD subagent types (use exact names - do not fall back to 'general-purpose'):

• gsd-phase-researcher - Researches technical approaches for a phase </available_agent_types>

Step 0: Resolve Model Profile

@.pi/gsd/references/model-profile-resolution.md

Resolve model for:

• gsd-phase-researcher

Step 1: Normalize and Validate Phase

@.pi/gsd/references/phase-argument-parsing.md

Step 4: Spawn Researcher

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

<files_to_read>
- {context_path} (USER DECISIONS from /gsd-discuss-phase)
- {requirements_path} (Project requirements)
- {state_path} (Project decisions and history)
</files_to_read>

${AGENT_SKILLS_RESEARCHER}

<additional_context>
Phase description: {description}
</additional_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