pi-gsd 1.12.3 → 2.0.0

package/.gsd/harnesses/pi/get-shit-done/workflows/plant-seed.md

@@ -1,3 +1,31 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+  <arg name="idea" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Idea:** <gsd-paste name="idea" />
+
+**State:**
+<gsd-paste name="state" />
+
 <purpose>
 Capture a forward-looking idea as a structured seed file with trigger conditions.
 Seeds auto-surface during /gsd-new-milestone when trigger conditions match the

package/.gsd/harnesses/pi/get-shit-done/workflows/pr-branch.md

@@ -1,3 +1,5 @@
+<gsd-version v="1.12.4" />
+
 <purpose>
 Create a clean branch for pull requests by filtering out .planning/ commits.
 The PR branch contains only code changes - reviewers don't see GSD artifacts

package/.gsd/harnesses/pi/get-shit-done/workflows/profile-user.md

@@ -1,3 +1,54 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="scan-sessions" />
+      <arg string="--json" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="scan-result" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="profile-sample" />
+      <arg string="--json" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="sample-result" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Scan Result:**
+<gsd-paste name="scan-result" />
+
+**State:**
+<gsd-paste name="state" />
+
 <purpose>
 Orchestrate the full developer profiling flow: consent, session analysis (or questionnaire fallback), profile generation, result display, and artifact creation.
 

package/.gsd/harnesses/pi/get-shit-done/workflows/progress.md

@@ -1,3 +1,54 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="roadmap" />
+      <arg string="analyze" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="roadmap" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="config-get" />
+      <arg string="workflow.discuss_mode" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="config" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Roadmap:**
+<gsd-paste name="roadmap" />
+
+**State:**
+<gsd-paste name="state" />
+
 <purpose>
 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. Provides situational awareness before continuing work.
 </purpose>
@@ -11,10 +62,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 <step name="init_context">
 **Load progress context (paths only):**
 
-```bash
-INIT=$(pi-gsd-tools init progress)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Extract from init JSON: `project_exists`, `roadmap_exists`, `state_exists`, `phases`, `current_phase`, `next_phase`, `milestone_version`, `completed_count`, `phase_count`, `paused_at`, `state_path`, `roadmap_path`, `project_path`, `config_path`.
 

package/.gsd/harnesses/pi/get-shit-done/workflows/quick.md

@@ -1,27 +1,101 @@
-<purpose>
-Execute small, ad-hoc tasks with GSD guarantees (atomic commits, STATE.md tracking). Quick mode spawns gsd-planner (quick mode) + gsd-executor(s), tracks tasks in `.planning/quick/`, and updates STATE.md's "Quick Tasks Completed" table.
-
-With `--discuss` flag: lightweight discussion phase before planning. Surfaces assumptions, clarifies gray areas, captures decisions in CONTEXT.md so the planner treats them as locked.
-
-With `--full` flag: enables plan-checking (max 2 iterations) and post-execution verification for quality guarantees without full milestone ceremony.
-
-With `--research` flag: spawns a focused research agent before planning. Investigates implementation approaches, library options, and pitfalls. Use when you're unsure how to approach a task.
-
-Flags are composable: `--discuss --research --full` gives discussion + research + plan-checking + verification.
-</purpose>
-
-<required_reading>
-Read all files referenced by the invoking prompt's execution_context before starting.
-</required_reading>
-
-<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
-- gsd-planner - Creates detailed plans from phase scope
-- gsd-plan-checker - Reviews plan quality before execution
-- gsd-executor - Executes plan tasks, commits, creates SUMMARY.md
-- gsd-verifier - Verifies phase completion, checks quality gates
-</available_agent_types>
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="discuss" type="flag" flag="--discuss" optional />
+  <arg name="full" type="flag" flag="--full" optional />
+  <arg name="research" type="flag" flag="--research" optional />
+  <arg name="description" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="init" />
+      <arg string="quick" />
+      <arg name="description" wrap='"' />
+    </args>
+    <outs>
+      <out type="string" name="init" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="init" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="init" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="init-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="init-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="init" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="agent-skills" />
+      <arg string="gsd-planner" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="agent-skills-planner" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="agent-skills" />
+      <arg string="gsd-executor" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="agent-skills-executor" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="agent-skills" />
+      <arg string="gsd-plan-checker" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="agent-skills-checker" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="agent-skills" />
+      <arg string="gsd-verifier" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="agent-skills-verifier" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Quick Task Context (pre-injected by WXP)
+
+**Task:** <gsd-paste name="description" />
+
+**Init Data:**
+<gsd-paste name="init" />
 
 <process>
 **Step 1: Parse arguments and get task description**
@@ -115,14 +189,7 @@ If `$FULL_MODE` only:
 
 **Step 2: Initialize**
 
-```bash
-INIT=$(pi-gsd-tools init quick "$DESCRIPTION")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_PLANNER=$(pi-gsd-tools agent-skills gsd-planner 2>/dev/null)
-AGENT_SKILLS_EXECUTOR=$(pi-gsd-tools agent-skills gsd-executor 2>/dev/null)
-AGENT_SKILLS_CHECKER=$(pi-gsd-tools agent-skills gsd-checker 2>/dev/null)
-AGENT_SKILLS_VERIFIER=$(pi-gsd-tools agent-skills gsd-verifier 2>/dev/null)
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Parse JSON for: `planner_model`, `executor_model`, `checker_model`, `verifier_model`, `commit_docs`, `branch_name`, `quick_id`, `slug`, `date`, `timestamp`, `quick_dir`, `task_dir`, `roadmap_exists`, `planning_exists`.
 

package/.gsd/harnesses/pi/get-shit-done/workflows/remove-phase.md

@@ -1,3 +1,68 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+  <arg name="phase" type="number" />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="phase-op" />
+    </args>
+    <outs>
+      <out type="string" name="init" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="init" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="init" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="init-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="init-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="init" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Phase:** <gsd-paste name="phase" />
+
+**Phase Data:**
+<gsd-paste name="init" />
+
 <purpose>
 Remove an unstarted future phase from the project roadmap, delete its directory, renumber all subsequent phases to maintain a clean linear sequence, and commit the change. The git commit serves as the historical record of removal.
 </purpose>
@@ -28,10 +93,7 @@ Exit.
 <step name="init_context">
 Load phase operation context:
 
-```bash
-INIT=$(pi-gsd-tools init phase-op "${target}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Extract: `phase_found`, `phase_dir`, `phase_number`, `commit_docs`, `roadmap_exists`.
 

package/.gsd/harnesses/pi/get-shit-done/workflows/remove-workspace.md

@@ -1,3 +1,57 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+  <arg name="name" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="remove-workspace" />
+    </args>
+    <outs>
+      <out type="string" name="workspace-data" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="workspace-data" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="workspace-data" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="workspace-data-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="workspace-data-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="workspace-data" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Workspace:** <gsd-paste name="name" />
+
+**Data:**
+<gsd-paste name="workspace-data" />
+
 <purpose>
 Remove a GSD workspace, cleaning up git worktrees and deleting the workspace directory.
 </purpose>
@@ -12,10 +66,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 
 Extract workspace name from $ARGUMENTS.
 
-```bash
-INIT=$(pi-gsd-tools init remove-workspace "$WORKSPACE_NAME")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Parse JSON for: `workspace_name`, `workspace_path`, `has_manifest`, `strategy`, `repos`, `repo_count`, `dirty_repos`, `has_dirty_repos`.
 

package/.gsd/harnesses/pi/get-shit-done/workflows/research-phase.md

@@ -1,3 +1,81 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+  <arg name="phase" type="number" />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="phase-op" />
+    </args>
+    <outs>
+      <out type="string" name="init" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="init" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="init" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="init-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="init-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="init" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="roadmap" />
+      <arg string="get-phase" />
+    </args>
+    <outs>
+      <out type="string" name="roadmap-phase" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="agent-skills" />
+      <arg string="gsd-phase-researcher" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="agent-skills-researcher" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Phase:** <gsd-paste name="phase" />
+
+**Phase Data:**
+<gsd-paste name="init" />
+
+**Roadmap:**
+<gsd-paste name="roadmap-phase" />
+
 <purpose>
 Research how to implement a phase. Spawns gsd-phase-researcher with phase context.
 
@@ -22,28 +100,7 @@ Resolve model for:
 
 @.pi/gsd/references/phase-argument-parsing.md
 
-```bash
-PHASE_INFO=$(pi-gsd-tools roadmap get-phase "${PHASE}")
-```
-
-If `found` is false: Error and exit.
-
-## Step 2: Check Existing Research
-
-```bash
-ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null || true
-```
-
-If exists: Offer update/view/skip options.
-
-## Step 3: Gather Phase Context
-
-```bash
-INIT=$(pi-gsd-tools init phase-op "${PHASE}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-# Extract: phase_dir, padded_phase, phase_number, state_path, requirements_path, context_path
-AGENT_SKILLS_RESEARCHER=$(pi-gsd-tools agent-skills gsd-researcher 2>/dev/null)
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 ## Step 4: Spawn Researcher
 

package/.gsd/harnesses/pi/get-shit-done/workflows/resume-project.md

@@ -1,3 +1,68 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="resume" />
+    </args>
+    <outs>
+      <out type="string" name="resume-data" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="resume-data" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="resume-data" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="resume-data-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="resume-data-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="resume-data" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Resume Context (pre-injected)
+
+**Resume Data:**
+<gsd-paste name="resume-data" />
+
+**State:**
+<gsd-paste name="state" />
+
 <trigger>
 Use this workflow when:
 - Starting a new session on an existing project
@@ -19,10 +84,7 @@ Instantly restore full project context so "Where were we?" has an immediate, com
 <step name="initialize">
 Load all context in one call:
 
-```bash
-INIT=$(pi-gsd-tools init resume)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Parse JSON for: `state_exists`, `roadmap_exists`, `project_exists`, `planning_exists`, `has_interrupted_agent`, `interrupted_agent_id`, `commit_docs`.