gsd-opencode 1.20.4 → 1.22.1

package/commands/gsd/gsd-health.md

@@ -2,21 +2,21 @@
 name: gsd-health
 description: Diagnose planning directory health and optionally repair issues
 argument-hint: [--repair]
-allowed-tools:
-  - read
-  - bash
-  - write
-  - question
+permissions:
+   read: true
+   bash: true
+   write: true
+   question: true
 ---
 <objective>
 Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/health.md
+@$HOME/.config/opencode/get-shit-done/workflows/health.md
 </execution_context>
 
 <process>
-Execute the health workflow from @~/.config/opencode/get-shit-done/workflows/health.md end-to-end.
+Execute the health workflow from @$HOME/.config/opencode/get-shit-done/workflows/health.md end-to-end.
 Parse --repair flag from arguments and pass to workflow.
 </process>

package/commands/gsd/gsd-help.md

@@ -13,10 +13,10 @@ Output ONLY the reference content below. Do NOT add:
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/help.md
+@$HOME/.config/opencode/get-shit-done/workflows/help.md
 </execution_context>
 
 <process>
-Output the complete GSD command reference from @~/.config/opencode/get-shit-done/workflows/help.md.
+Output the complete GSD command reference from @$HOME/.config/opencode/get-shit-done/workflows/help.md.
 Display the reference content directly — no additions or modifications.
 </process>

package/commands/gsd/gsd-insert-phase.md

@@ -2,10 +2,10 @@
 name: gsd-insert-phase
 description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
 argument-hint: <after> <description>
-allowed-tools:
-  - read
-  - write
-  - bash
+permissions:
+   read: true
+   write: true
+   bash: true
 ---
 
 <objective>
@@ -17,7 +17,7 @@ Purpose: Handle urgent work discovered during execution without renumbering enti
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/insert-phase.md
+@$HOME/.config/opencode/get-shit-done/workflows/insert-phase.md
 </execution_context>
 
 <context>
@@ -27,6 +27,6 @@ Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool
 </context>
 
 <process>
-Execute the insert-phase workflow from @~/.config/opencode/get-shit-done/workflows/insert-phase.md end-to-end.
+Execute the insert-phase workflow from @$HOME/.config/opencode/get-shit-done/workflows/insert-phase.md end-to-end.
 Preserve all validation gates (argument parsing, phase verification, decimal calculation, roadmap updates).
 </process>

package/commands/gsd/gsd-join-discord.md

@@ -12,7 +12,7 @@ Display the Discord invite link for the GSD community server.
 
 Connect with other GSD users, get help, share what you're building, and stay updated.
 
-**Invite link:** https://discord.gg/5JJgD5svVS
+**Invite link:** https://discord.gg/gsd
 
 Click the link or paste it into your browser to join.
 </output>

package/commands/gsd/gsd-list-phase-assumptions.md

@@ -2,11 +2,11 @@
 name: gsd-list-phase-assumptions
 description: Surface OpenCode's assumptions about a phase approach before planning
 argument-hint: "[phase]"
-allowed-tools:
-  - read
-  - bash
-  - grep
-  - glob
+permissions:
+   read: true
+   bash: true
+   grep: true
+   glob: true
 ---
 
 <objective>
@@ -17,7 +17,7 @@ Output: Conversational output only (no file creation) - ends with "What do you t
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/list-phase-assumptions.md
+@$HOME/.config/opencode/get-shit-done/workflows/list-phase-assumptions.md
 </execution_context>
 
 <context>

package/commands/gsd/gsd-map-codebase.md

@@ -2,13 +2,13 @@
 name: gsd-map-codebase
 description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
 argument-hint: "[optional: specific area to map, e.g., 'api' or 'auth']"
-allowed-tools:
-  - read
-  - bash
-  - glob
-  - grep
-  - write
-  - task
+permissions:
+   read: true
+   bash: true
+   glob: true
+   grep: true
+   write: true
+   task: true
 ---
 
 <objective>
@@ -20,7 +20,7 @@ Output: .planning/codebase/ folder with 7 structured documents about the codebas
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/map-codebase.md
+@$HOME/.config/opencode/get-shit-done/workflows/map-codebase.md
 </execution_context>
 
 <context>

package/commands/gsd/gsd-new-milestone.md

@@ -2,12 +2,12 @@
 name: gsd-new-milestone
 description: Start a new milestone cycle — update PROJECT.md and route to requirements
 argument-hint: "[milestone name, e.g., 'v1.1 Notifications']"
-allowed-tools:
-  - read
-  - write
-  - bash
-  - task
-  - question
+permissions:
+   read: true
+   write: true
+   bash: true
+   task: true
+   question: true
 ---
 <objective>
 Start a new milestone: questioning → research (optional) → requirements → roadmap.
@@ -25,11 +25,11 @@ Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Ga
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/new-milestone.md
-@~/.config/opencode/get-shit-done/references/questioning.md
-@~/.config/opencode/get-shit-done/references/ui-brand.md
-@~/.config/opencode/get-shit-done/templates/project.md
-@~/.config/opencode/get-shit-done/templates/requirements.md
+@$HOME/.config/opencode/get-shit-done/workflows/new-milestone.md
+@$HOME/.config/opencode/get-shit-done/references/questioning.md
+@$HOME/.config/opencode/get-shit-done/references/ui-brand.md
+@$HOME/.config/opencode/get-shit-done/templates/project.md
+@$HOME/.config/opencode/get-shit-done/templates/requirements.md
 </execution_context>
 
 <context>
@@ -39,6 +39,6 @@ Project and milestone context files are resolved inside the workflow (`init new-
 </context>
 
 <process>
-Execute the new-milestone workflow from @~/.config/opencode/get-shit-done/workflows/new-milestone.md end-to-end.
+Execute the new-milestone workflow from @$HOME/.config/opencode/get-shit-done/workflows/new-milestone.md end-to-end.
 Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).
 </process>

package/commands/gsd/gsd-new-project.md

@@ -2,12 +2,12 @@
 name: gsd-new-project
 description: Initialize a new project with deep context gathering and PROJECT.md
 argument-hint: "[--auto]"
-allowed-tools:
-  - read
-  - bash
-  - write
-  - task
-  - question
+permissions:
+   read: true
+   bash: true
+   write: true
+   task: true
+   question: true
 ---
 <context>
 **Flags:**
@@ -29,14 +29,14 @@ Initialize a new project through unified flow: questioning → research (optiona
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/new-project.md
-@~/.config/opencode/get-shit-done/references/questioning.md
-@~/.config/opencode/get-shit-done/references/ui-brand.md
-@~/.config/opencode/get-shit-done/templates/project.md
-@~/.config/opencode/get-shit-done/templates/requirements.md
+@$HOME/.config/opencode/get-shit-done/workflows/new-project.md
+@$HOME/.config/opencode/get-shit-done/references/questioning.md
+@$HOME/.config/opencode/get-shit-done/references/ui-brand.md
+@$HOME/.config/opencode/get-shit-done/templates/project.md
+@$HOME/.config/opencode/get-shit-done/templates/requirements.md
 </execution_context>
 
 <process>
-Execute the new-project workflow from @~/.config/opencode/get-shit-done/workflows/new-project.md end-to-end.
+Execute the new-project workflow from @$HOME/.config/opencode/get-shit-done/workflows/new-project.md end-to-end.
 Preserve all workflow gates (validation, approvals, commits, routing).
 </process>

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

@@ -1,10 +1,10 @@
 ---
 name: gsd-pause-work
 description: Create context handoff when pausing work mid-phase
-allowed-tools:
-  - read
-  - write
-  - bash
+permissions:
+   read: true
+   write: true
+   bash: true
 ---
 
 <objective>
@@ -19,7 +19,7 @@ Routes to the pause-work workflow which handles:
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/pause-work.md
+@$HOME/.config/opencode/get-shit-done/workflows/pause-work.md
 </execution_context>
 
 <context>
@@ -27,7 +27,7 @@ State and phase progress are gathered in-workflow with targeted reads.
 </context>
 
 <process>
-**Follow the pause-work workflow** from `@~/.config/opencode/get-shit-done/workflows/pause-work.md`.
+**Follow the pause-work workflow** from `@$HOME/.config/opencode/get-shit-done/workflows/pause-work.md`.
 
 The workflow handles all logic including:
 1. Phase directory detection

package/commands/gsd/gsd-plan-milestone-gaps.md

@@ -1,13 +1,13 @@
 ---
 name: gsd-plan-milestone-gaps
 description: Create phases to close all gaps identified by milestone audit
-allowed-tools:
-  - read
-  - write
-  - bash
-  - glob
-  - grep
-  - question
+permissions:
+   read: true
+   write: true
+   bash: true
+   glob: true
+   grep: true
+   question: true
 ---
 <objective>
 Create all phases necessary to close gaps identified by `/gsd-audit-milestone`.
@@ -18,7 +18,7 @@ One command creates all fix phases — no manual `/gsd-add-phase` per gap.
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/plan-milestone-gaps.md
+@$HOME/.config/opencode/get-shit-done/workflows/plan-milestone-gaps.md
 </execution_context>
 
 <context>
@@ -29,6 +29,6 @@ Original intent and current planning state are loaded on demand inside the workf
 </context>
 
 <process>
-Execute the plan-milestone-gaps workflow from @~/.config/opencode/get-shit-done/workflows/plan-milestone-gaps.md end-to-end.
+Execute the plan-milestone-gaps workflow from @$HOME/.config/opencode/get-shit-done/workflows/plan-milestone-gaps.md end-to-end.
 Preserve all workflow gates (audit loading, prioritization, phase grouping, user confirmation, roadmap updates).
 </process>

package/commands/gsd/gsd-plan-phase.md

@@ -1,17 +1,17 @@
 ---
 name: gsd-plan-phase
 description: Create detailed phase plan (PLAN.md) with verification loop
-argument-hint: "[phase] [--auto] [--research] [--skip-research] [--gaps] [--skip-verify]"
+argument-hint: "[phase] [--auto] [--research] [--skip-research] [--gaps] [--skip-verify] [--prd <file>]"
 agent: gsd-planner
-allowed-tools:
-  - read
-  - write
-  - bash
-  - glob
-  - grep
-  - task
-  - webfetch
-  - mcp__context7__*
+permissions:
+   read: true
+   write: true
+   bash: true
+   glob: true
+   grep: true
+   task: true
+   webfetch: true
+   mcp__context7__*: true
 ---
 <objective>
 Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification.
@@ -22,8 +22,8 @@ Create executable phase prompts (PLAN.md files) for a roadmap phase with integra
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/plan-phase.md
-@~/.config/opencode/get-shit-done/references/ui-brand.md
+@$HOME/.config/opencode/get-shit-done/workflows/plan-phase.md
+@$HOME/.config/opencode/get-shit-done/references/ui-brand.md
 </execution_context>
 
 <context>
@@ -34,11 +34,12 @@ Phase number: $ARGUMENTS (optional — auto-detects next unplanned phase if omit
 - `--skip-research` — Skip research, go straight to planning
 - `--gaps` — Gap closure mode (reads VERIFICATION.md, skips research)
 - `--skip-verify` — Skip verification loop
+- `--prd <file>` — Use a PRD/acceptance criteria file instead of discuss-phase. Parses requirements into CONTEXT.md automatically. Skips discuss-phase entirely.
 
 Normalize phase input in step 2 before any directory lookups.
 </context>
 
 <process>
-Execute the plan-phase workflow from @~/.config/opencode/get-shit-done/workflows/plan-phase.md end-to-end.
+Execute the plan-phase workflow from @$HOME/.config/opencode/get-shit-done/workflows/plan-phase.md end-to-end.
 Preserve all workflow gates (validation, research, planning, verification loop, routing).
 </process>

package/commands/gsd/gsd-progress.md

@@ -1,12 +1,12 @@
 ---
 name: gsd-progress
 description: Check project progress, show context, and route to next action (execute or plan)
-allowed-tools:
-  - read
-  - bash
-  - grep
-  - glob
-  - command
+permissions:
+   read: true
+   bash: true
+   grep: true
+   glob: true
+   task: true
 ---
 <objective>
 Check project progress, summarize recent work and what's ahead, then intelligently route to the next action - either executing an existing plan or creating the next one.
@@ -15,10 +15,10 @@ Provides situational awareness before continuing work.
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/progress.md
+@$HOME/.config/opencode/get-shit-done/workflows/progress.md
 </execution_context>
 
 <process>
-Execute the progress workflow from @~/.config/opencode/get-shit-done/workflows/progress.md end-to-end.
+Execute the progress workflow from @$HOME/.config/opencode/get-shit-done/workflows/progress.md end-to-end.
 Preserve all routing logic (Routes A through F) and edge case handling.
 </process>

package/commands/gsd/gsd-quick.md

@@ -1,16 +1,16 @@
 ---
 name: gsd-quick
 description: Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
-argument-hint: "[--full]"
-allowed-tools:
-  - read
-  - write
-  - edit
-  - glob
-  - grep
-  - bash
-  - task
-  - question
+argument-hint: "[--full] [--discuss]"
+permissions:
+   read: true
+   write: true
+   edit: true
+   glob: true
+   grep: true
+   bash: true
+   task: true
+   question: true
 ---
 <objective>
 Execute small, ad-hoc tasks with GSD guarantees (atomic commits, STATE.md tracking).
@@ -20,13 +20,17 @@ Quick mode is the same system with a shorter path:
 - Quick tasks live in `.planning/quick/` separate from planned phases
 - Updates STATE.md "Quick Tasks Completed" table (NOT ROADMAP.md)
 
-**Default:** Skips research, plan-checker, verifier. Use when you know exactly what to do.
+**Default:** Skips research, discussion, plan-checker, verifier. Use when you know exactly what to do.
+
+**`--discuss` flag:** Lightweight discussion phase before planning. Surfaces assumptions, clarifies gray areas, captures decisions in CONTEXT.md. Use when the task has ambiguity worth resolving upfront.
 
 **`--full` flag:** Enables plan-checking (max 2 iterations) and post-execution verification. Use when you want quality guarantees without full milestone ceremony.
+
+Flags are composable: `--discuss --full` gives discussion + plan-checking + verification.
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/quick.md
+@$HOME/.config/opencode/get-shit-done/workflows/quick.md
 </execution_context>
 
 <context>
@@ -36,6 +40,6 @@ Context files are resolved inside the workflow (`init quick`) and delegated via
 </context>
 
 <process>
-Execute the quick workflow from @~/.config/opencode/get-shit-done/workflows/quick.md end-to-end.
+Execute the quick workflow from @$HOME/.config/opencode/get-shit-done/workflows/quick.md end-to-end.
 Preserve all workflow gates (validation, task description, planning, execution, state updates, commits).
 </process>

package/commands/gsd/gsd-reapply-patches.md

@@ -1,15 +1,13 @@
 ---
 name: gsd-reapply-patches
 description: Reapply local modifications after a GSD update
-allowed-tools: read, write, edit, bash, glob, grep, question
+permissions: read, write, edit, bash, glob, grep, question
 ---
 
 <objective>
-Reapply user's local modifications to GSD files after an update overwrites them.
+Reapply user's local modifications to files after a GSD update reinstalls clean versions.
 
-Purpose: After a GSD update wipes and reinstalls files, this command merges user's previously saved local modifications back into the new version using intelligent comparison to handle cases where the upstream file also changed.
-
-Output: A report showing which patches were merged, skipped (already upstream), or had conflicts that required user resolution.
+When GSD performs updates, it backs up user modifications to a patches directory. This command intelligently merges those modifications back into the new file versions, handling cases where both the upstream code and user modifications may have changed.
 </objective>
 
 <purpose>
@@ -23,11 +21,24 @@ After a GSD update wipes and reinstalls files, this command merges user's previo
 Check for local patches directory:
 
 ```bash
-# Global install (path templated at install time)
-PATCHES_DIR=~/.config/opencode/gsd-local-patches
-# Local install fallback
+# Global install — detect runtime config directory
+if [ -d "$HOME/.config/opencode/gsd-local-patches" ]; then
+  PATCHES_DIR="$HOME/.config/opencode/gsd-local-patches"
+elif [ -d "$HOME/.opencode/gsd-local-patches" ]; then
+  PATCHES_DIR="$HOME/.opencode/gsd-local-patches"
+elif [ -d "$HOME/.gemini/gsd-local-patches" ]; then
+  PATCHES_DIR="$HOME/.gemini/gsd-local-patches"
+else
+  PATCHES_DIR="$HOME/.OpenCode/gsd-local-patches"
+fi
+# Local install fallback — check all runtime directories
 if [ ! -d "$PATCHES_DIR" ]; then
-  PATCHES_DIR=./.OpenCode/gsd-local-patches
+  for dir in .config/opencode .opencode .gemini .OpenCode; do
+    if [ -d "./$dir/gsd-local-patches" ]; then
+      PATCHES_DIR="./$dir/gsd-local-patches"
+      break
+    fi
+  done
 fi
 ```
 

package/commands/gsd/gsd-remove-phase.md

@@ -2,11 +2,11 @@
 name: gsd-remove-phase
 description: Remove a future phase from roadmap and renumber subsequent phases
 argument-hint: <phase-number>
-allowed-tools:
-  - read
-  - write
-  - bash
-  - glob
+permissions:
+   read: true
+   write: true
+   bash: true
+   glob: true
 ---
 <objective>
 Remove an unstarted future phase from the roadmap and renumber all subsequent phases to maintain a clean, linear sequence.
@@ -16,7 +16,7 @@ Output: Phase deleted, all subsequent phases renumbered, git commit as historica
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/remove-phase.md
+@$HOME/.config/opencode/get-shit-done/workflows/remove-phase.md
 </execution_context>
 
 <context>
@@ -26,6 +26,6 @@ Roadmap and state are resolved in-workflow via `init phase-op` and targeted read
 </context>
 
 <process>
-Execute the remove-phase workflow from @~/.config/opencode/get-shit-done/workflows/remove-phase.md end-to-end.
+Execute the remove-phase workflow from @$HOME/.config/opencode/get-shit-done/workflows/remove-phase.md end-to-end.
 Preserve all validation gates (future phase check, work check), renumbering logic, and commit.
 </process>

package/commands/gsd/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]"
-allowed-tools:
-  - read
-  - bash
-  - task
+permissions:
+   read: true
+   bash: true
+   task: true
 ---
 
 <objective>
@@ -34,20 +34,21 @@ Normalize phase input in step 1 before any directory lookups.
 ## 0. Initialize Context
 
 ```bash
-INIT=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs init phase-op "$ARGUMENTS")
+INIT=$(node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" init phase-op "$ARGUMENTS")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
 Extract from init JSON: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
 
 Resolve researcher model:
 ```bash
-RESEARCHER_MODEL=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs resolve-model gsd-phase-researcher --raw)
+RESEARCHER_MODEL=$(node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" resolve-model gsd-phase-researcher --raw)
 ```
 
 ## 1. Validate Phase
 
 ```bash
-PHASE_INFO=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs roadmap get-phase "${phase_number}")
+PHASE_INFO=$(node "$HOME/.config/opencode/get-shit-done/bin/gsd-tools.cjs" roadmap get-phase "${phase_number}")
 ```
 
 **If `found` is false:** Error and exit. **If `found` is true:** Extract `phase_number`, `phase_name`, `goal` from JSON.
@@ -135,8 +136,8 @@ write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
 
 ```
 task(
-  prompt="First, read ~/.config/opencode/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + filled_prompt,
-  subagent_type="general",
+  prompt=filled_prompt,
+  subagent_type="gsd-phase-researcher",
   model="{researcher_model}",
   description="Research Phase {phase}"
 )
@@ -171,8 +172,8 @@ Continue research for Phase {phase_number}: {phase_name}
 
 ```
 task(
-  prompt="First, read ~/.config/opencode/agents/gsd-phase-researcher.md for your role and instructions.\n\n" + continuation_prompt,
-  subagent_type="general",
+  prompt=continuation_prompt,
+  subagent_type="gsd-phase-researcher",
   model="{researcher_model}",
   description="Continue research Phase {phase}"
 )

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

@@ -1,12 +1,12 @@
 ---
 name: gsd-resume-work
 description: Resume work from previous session with full context restoration
-allowed-tools:
-  - read
-  - bash
-  - write
-  - question
-  - command
+permissions:
+   read: true
+   bash: true
+   write: true
+   question: true
+   task: true
 ---
 
 <objective>
@@ -22,11 +22,11 @@ Routes to the resume-project workflow which handles:
   </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/resume-project.md
+@$HOME/.config/opencode/get-shit-done/workflows/resume-project.md
 </execution_context>
 
 <process>
-**Follow the resume-project workflow** from `@~/.config/opencode/get-shit-done/workflows/resume-project.md`.
+**Follow the resume-project workflow** from `@$HOME/.config/opencode/get-shit-done/workflows/resume-project.md`.
 
 The workflow handles all resumption logic including:
 

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

@@ -2,10 +2,10 @@
 name: gsd-set-profile
 description: Switch model profile for GSD agents (simple/smart/genius)
 argument-hint: <profile>
-allowed-tools:
-  - read
-  - write
-  - bash
+permissions:
+   read: true
+   write: true
+   bash: true
 ---
 
 <objective>
@@ -19,11 +19,11 @@ Routes to the set-profile workflow which handles:
 </objective>
 
 <execution_context>
-@~/.config/opencode/get-shit-done/workflows/oc-set-profile.md
+@$HOME/.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`.
+**Follow the set-profile workflow** from `@$HOME/.config/opencode/get-shit-done/workflows/oc-set-profile.md`.
 
 The workflow handles all logic including:
 1. Profile argument validation