gsd-opencode 1.10.2 → 1.20.0

package/commands/gsd/{research-phase.md → gsd-research-phase.md}

@@ -2,10 +2,10 @@
 name: gsd-research-phase
 description: Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
 argument-hint: "[phase]"
-tools:
+allowed-tools:
   - read
   - bash
-
+  - task
 ---
 
 <objective>
@@ -20,51 +20,37 @@ Research how to implement a phase. Spawns gsd-phase-researcher agent with phase
 
 **Orchestrator role:** Parse phase, validate against roadmap, check existing research, gather context, spawn researcher agent, present results.
 
-**Why subagent:** Research burns context fast (webfetch, Context7 queries, source verification). Fresh 200k context for investigation. Main context stays lean for user interaction.
+**Why subagent:** Research burns context fast (websearch, Context7 queries, source verification). Fresh 200k context for investigation. Main context stays lean for user interaction.
 </objective>
 
 <context>
-Phase number: `$ARGUMENTS` (required)
+Phase number: $ARGUMENTS (required)
 
 Normalize phase input in step 1 before any directory lookups.
 </context>
 
 <process>
 
-## 0. Resolve Model Profile
-
-read model profile for agent spawning:
+## 0. Initialize Context
 
 ```bash
-MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+INIT=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs init phase-op "$ARGUMENTS")
 ```
 
-Default to "balanced" if not set.
-
-**Model lookup table:**
+Extract from init JSON: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
 
-| Agent | quality | balanced | budget |
-|-------|---------|----------|--------|
-| gsd-phase-researcher | opus | sonnet | haiku |
-
-Store resolved model for use in Task calls below.
+Resolve researcher model:
+```bash
+RESEARCHER_MODEL=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs resolve-model gsd-phase-researcher --raw)
+```
 
-## 1. Normalize and Validate Phase
+## 1. Validate Phase
 
 ```bash
-# Normalize phase number (8 → 08, but preserve decimals like 2.1 → 02.1)
-if [[ "$ARGUMENTS" =~ ^[0-9]+$ ]]; then
-  PHASE=$(printf "%02d" "$ARGUMENTS")
-elif [[ "$ARGUMENTS" =~ ^([0-9]+)\.([0-9]+)$ ]]; then
-  PHASE=$(printf "%02d.%s" "${BASH_REMATCH[1]}" "${BASH_REMATCH[2]}")
-else
-  PHASE="$ARGUMENTS"
-fi
-
-grep -A5 "Phase ${PHASE}:" .planning/ROADMAP.md 2>/dev/null
+PHASE_INFO=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs roadmap get-phase "${phase_number}")
 ```
 
-**If not found:** Error and exit. **If found:** Extract phase number, name, description.
+**If `found` is false:** Error and exit. **If `found` is true:** Extract `phase_number`, `phase_name`, `goal` from JSON.
 
 ## 2. Check Existing Research
 
@@ -78,14 +64,12 @@ ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
 
 ## 3. Gather Phase Context
 
-```bash
-grep -A20 "Phase ${PHASE}:" .planning/ROADMAP.md
-cat .planning/REQUIREMENTS.md 2>/dev/null
-cat .planning/phases/${PHASE}-*/${PHASE}-CONTEXT.md 2>/dev/null
-grep -A30 "### Decisions Made" .planning/STATE.md 2>/dev/null
-```
+Use paths from INIT (do not inline file contents in orchestrator context):
+- `requirements_path`
+- `context_path`
+- `state_path`
 
-Present summary with phase description, requirements, prior decisions.
+Present summary with phase description and what files the researcher will load.
 
 ## 4. Spawn gsd-phase-researcher Agent
 
@@ -114,20 +98,23 @@ Research implementation approach for Phase {phase_number}: {phase_name}
 Mode: ecosystem
 </objective>
 
-<context>
+<files_to_read>
+- {requirements_path} (Requirements)
+- {context_path} (Phase context from discuss-phase, if exists)
+- {state_path} (Prior project decisions and blockers)
+</files_to_read>
+
+<additional_context>
 **Phase description:** {phase_description}
-**Requirements:** {requirements_list}
-**Prior decisions:** {decisions_if_any}
-**Phase context:** {context_md_content}
-</context>
+</additional_context>
 
 <downstream_consumer>
 Your RESEARCH.md will be loaded by `/gsd-plan-phase` which uses specific sections:
 - `## Standard Stack` → Plans use these libraries
-- `## Architecture Patterns` → Task structure follows these
+- `## Architecture Patterns` → task structure follows these
 - `## Don't Hand-Roll` → Tasks NEVER build custom solutions for listed problems
 - `## Common Pitfalls` → Verification steps check for these
-- `## Code Examples` → Task actions reference these patterns
+- `## Code Examples` → task actions reference these patterns
 
 Be prescriptive, not exploratory. "Use X" not "Consider X or Y."
 </downstream_consumer>
@@ -147,9 +134,9 @@ write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
 ```
 
 ```
-Task(
-  prompt=filled_prompt,
-  subagent_type="gsd-phase-researcher",
+task(
+  prompt="First, read ~/.config/opencode/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + filled_prompt,
+  subagent_type="task",
   model="{researcher_model}",
   description="Research Phase {phase}"
 )
@@ -171,7 +158,9 @@ Continue research for Phase {phase_number}: {phase_name}
 </objective>
 
 <prior_state>
-Research file: @.planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
+<files_to_read>
+- .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Existing research)
+</files_to_read>
 </prior_state>
 
 <checkpoint_response>
@@ -181,9 +170,9 @@ Research file: @.planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
 ```
 
 ```
-Task(
-  prompt=continuation_prompt,
-  subagent_type="gsd-phase-researcher",
+task(
+  prompt="First, read ~/.config/opencode/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + continuation_prompt,
+  subagent_type="task",
   model="{researcher_model}",
   description="Continue research Phase {phase}"
 )

package/commands/gsd/{resume-work.md → gsd-resume-work.md}

@@ -1,12 +1,12 @@
 ---
 name: gsd-resume-work
 description: Resume work from previous session with full context restoration
-tools:
+allowed-tools:
   - read
   - bash
   - write
   - question
-  - Command
+  - command
 ---
 
 <objective>

package/commands/gsd/gsd-set-profile.md

@@ -0,0 +1,34 @@
+---
+name: gsd-set-profile
+description: Switch model profile for GSD agents (simple/smart/genius)
+argument-hint: <profile>
+allowed-tools:
+  - read
+  - write
+  - bash
+---
+
+<objective>
+Switch the model profile used by GSD agents. Controls which OpenCode model each agent uses, balancing quality vs token spend.
+
+Routes to the set-profile workflow which handles:
+- Argument validation (simple/smart/genius)
+- Config file creation if missing
+- Profile update in config.json
+- Confirmation with model table display
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/oc-set-profile.md
+</execution_context>
+
+<process>
+**Follow the set-profile workflow** from `@~/.config/opencode/get-shit-done/workflows/oc-set-profile.md`.
+
+The workflow handles all logic including:
+1. Profile argument validation
+2. Config file ensuring
+3. Config reading and updating
+4. Model table generation from MODEL_PROFILES
+5. Confirmation display
+</process>

package/commands/gsd/gsd-settings.md

@@ -0,0 +1,36 @@
+---
+name: gsd-settings
+description: Configure GSD workflow toggles and model profile
+allowed-tools:
+  - read
+  - write
+  - bash
+  - question
+---
+
+<objective>
+Interactive configuration of GSD workflow agents and model profile via multi-question prompt.
+
+Routes to the settings workflow which handles:
+- Config existence ensuring
+- Current settings reading and parsing
+- Interactive 5-question prompt (model, research, plan_check, verifier, branching)
+- Config merging and writing
+- Confirmation display with quick command references
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/settings.md
+</execution_context>
+
+<process>
+**Follow the settings workflow** from `@~/.config/opencode/get-shit-done/workflows/settings.md`.
+
+The workflow handles all logic including:
+1. Config file creation with defaults if missing
+2. Current config reading
+3. Interactive settings presentation with pre-selection
+4. Answer parsing and config merging
+5. File writing
+6. Confirmation display
+</process>

package/commands/gsd/gsd-update.md

@@ -0,0 +1,37 @@
+---
+name: gsd-update
+description: Update GSD to latest version with changelog display
+allowed-tools:
+  - bash
+  - question
+---
+
+<objective>
+Check for GSD updates, install if available, and display what changed.
+
+Routes to the update workflow which handles:
+- Version detection (local vs global installation)
+- npm version checking
+- Changelog fetching and display
+- User confirmation with clean install warning
+- Update execution and cache clearing
+- Restart reminder
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/update.md
+</execution_context>
+
+<process>
+**Follow the update workflow** from `@~/.config/opencode/get-shit-done/workflows/update.md`.
+
+The workflow handles all logic including:
+1. Installed version detection (local/global)
+2. Latest version checking via npm
+3. Version comparison
+4. Changelog fetching and extraction
+5. Clean install warning display
+6. User confirmation
+7. Update execution
+8. Cache clearing
+</process>

package/commands/gsd/gsd-verify-work.md

@@ -0,0 +1,38 @@
+---
+name: gsd-verify-work
+description: Validate built features through conversational UAT
+argument-hint: "[phase number, e.g., '4']"
+allowed-tools:
+  - read
+  - bash
+  - glob
+  - grep
+  - edit
+  - write
+  - task
+---
+<objective>
+Validate built features through conversational testing with persistent state.
+
+Purpose: Confirm what OpenCode built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
+
+Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd-execute-phase
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/verify-work.md
+@~/.config/opencode/get-shit-done/templates/UAT.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS (optional)
+- If provided: Test specific phase (e.g., "4")
+- If not provided: Check for active sessions or prompt for phase
+
+Context files are resolved inside the workflow (`init verify-work`) and delegated via `<files_to_read>` blocks.
+</context>
+
+<process>
+Execute the verify-work workflow from @~/.config/opencode/get-shit-done/workflows/verify-work.md end-to-end.
+Preserve all workflow gates (session management, test presentation, diagnosis, fix planning, routing).
+</process>