get-shit-done-cc 1.8.0 → 1.9.0

package/commands/gsd/plan-phase.md

@@ -42,7 +42,7 @@ Normalize phase input in step 2 before any directory lookups.
 
 <process>
 
-## 1. Validate Environment
+## 1. Validate Environment and Resolve Model Profile
 
 ```bash
 ls .planning/ 2>/dev/null
@@ -50,6 +50,24 @@ ls .planning/ 2>/dev/null
 
 **If not found:** Error - user should run `/gsd:new-project` first.
 
+**Resolve model profile for agent spawning:**
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+Default to "balanced" if not set.
+
+**Model lookup table:**
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| gsd-phase-researcher | opus | sonnet | haiku |
+| gsd-planner | opus | opus | sonnet |
+| gsd-plan-checker | sonnet | sonnet | haiku |
+
+Store resolved models for use in Task calls below.
+
 ## 2. Parse and Normalize Arguments
 
 Extract from $ARGUMENTS:
@@ -107,6 +125,14 @@ fi
 
 **If `--skip-research` flag:** Skip to step 6.
 
+**Check config for research setting:**
+
+```bash
+WORKFLOW_RESEARCH=$(cat .planning/config.json 2>/dev/null | grep -o '"research"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
+```
+
+**If `workflow.research` is `false` AND `--research` flag NOT set:** Skip to step 6.
+
 **Otherwise:**
 
 Check for existing research:
@@ -182,6 +208,7 @@ Write research findings to: {phase_dir}/{phase}-RESEARCH.md
 Task(
   prompt=research_prompt,
   subagent_type="gsd-phase-researcher",
+  model="{researcher_model}",
   description="Research Phase {phase}"
 )
 ```
@@ -205,21 +232,26 @@ ls "${PHASE_DIR}"/*-PLAN.md 2>/dev/null
 
 **If exists:** Offer: 1) Continue planning (add more plans), 2) View existing, 3) Replan from scratch. Wait for response.
 
-## 7. Gather Context Paths
+## 7. Read Context Files
 
-Identify context files for the planner agent:
+Read and store context file contents for the planner agent. The `@` syntax does not work across Task() boundaries - content must be inlined.
 
 ```bash
-# Required
-STATE=.planning/STATE.md
-ROADMAP=.planning/ROADMAP.md
-REQUIREMENTS=.planning/REQUIREMENTS.md
-
-# Optional (created by earlier steps or commands)
-CONTEXT="${PHASE_DIR}/${PHASE}-CONTEXT.md"
-RESEARCH="${PHASE_DIR}/${PHASE}-RESEARCH.md"
-VERIFICATION="${PHASE_DIR}/${PHASE}-VERIFICATION.md"
-UAT="${PHASE_DIR}/${PHASE}-UAT.md"
+# Read required files
+STATE_CONTENT=$(cat .planning/STATE.md)
+ROADMAP_CONTENT=$(cat .planning/ROADMAP.md)
+
+# Read optional files (empty string if missing)
+REQUIREMENTS_CONTENT=$(cat .planning/REQUIREMENTS.md 2>/dev/null)
+CONTEXT_CONTENT=$(cat "${PHASE_DIR}"/*-CONTEXT.md 2>/dev/null)
+RESEARCH_CONTENT=$(cat "${PHASE_DIR}"/*-RESEARCH.md 2>/dev/null)
+
+# Gap closure files (only if --gaps mode)
+VERIFICATION_CONTENT=$(cat "${PHASE_DIR}"/*-VERIFICATION.md 2>/dev/null)
+UAT_CONTENT=$(cat "${PHASE_DIR}"/*-UAT.md 2>/dev/null)
+
+# Codebase intelligence (if exists)
+INTEL_CONTENT=$(cat .planning/intel/summary.md 2>/dev/null)
 ```
 
 ## 8. Spawn gsd-planner Agent
@@ -233,7 +265,7 @@ Display stage banner:
 ◆ Spawning planner...
 ```
 
-Fill prompt and spawn:
+Fill prompt with inlined content and spawn:
 
 ```markdown
 <planning_context>
@@ -242,23 +274,28 @@ Fill prompt and spawn:
 **Mode:** {standard | gap_closure}
 
 **Project State:**
-@.planning/STATE.md
+{state_content}
 
 **Roadmap:**
-@.planning/ROADMAP.md
+{roadmap_content}
 
 **Requirements (if exists):**
-@.planning/REQUIREMENTS.md
+{requirements_content}
 
 **Phase Context (if exists):**
-@.planning/phases/{phase_dir}/{phase}-CONTEXT.md
+{context_content}
 
 **Research (if exists):**
-@.planning/phases/{phase_dir}/{phase}-RESEARCH.md
+{research_content}
 
 **Gap Closure (if --gaps mode):**
-@.planning/phases/{phase_dir}/{phase}-VERIFICATION.md
-@.planning/phases/{phase_dir}/{phase}-UAT.md
+{verification_content}
+{uat_content}
+
+**Codebase Intel (if exists):**
+<codebase-intel>
+{intel_content}
+</codebase-intel>
 
 </planning_context>
 
@@ -288,6 +325,7 @@ Before returning PLANNING COMPLETE:
 Task(
   prompt=filled_prompt,
   subagent_type="gsd-planner",
+  model="{planner_model}",
   description="Plan Phase {phase}"
 )
 ```
@@ -299,6 +337,8 @@ Parse planner output:
 **`## PLANNING COMPLETE`:**
 - Display: `Planner created {N} plan(s). Files on disk.`
 - If `--skip-verify`: Skip to step 13
+- Check config: `WORKFLOW_PLAN_CHECK=$(cat .planning/config.json 2>/dev/null | grep -o '"plan_check"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")`
+- If `workflow.plan_check` is `false`: Skip to step 13
 - Otherwise: Proceed to step 10
 
 **`## CHECKPOINT REACHED`:**
@@ -320,7 +360,17 @@ Display:
 ◆ Spawning plan checker...
 ```
 
-Fill checker prompt and spawn:
+Read plans and requirements for the checker:
+
+```bash
+# Read all plans in phase directory
+PLANS_CONTENT=$(cat "${PHASE_DIR}"/*-PLAN.md 2>/dev/null)
+
+# Read requirements (reuse from step 7 if available)
+REQUIREMENTS_CONTENT=$(cat .planning/REQUIREMENTS.md 2>/dev/null)
+```
+
+Fill checker prompt with inlined content and spawn:
 
 ```markdown
 <verification_context>
@@ -329,10 +379,10 @@ Fill checker prompt and spawn:
 **Phase Goal:** {goal from ROADMAP}
 
 **Plans to verify:**
-@.planning/phases/{phase_dir}/*-PLAN.md
+{plans_content}
 
 **Requirements (if exists):**
-@.planning/REQUIREMENTS.md
+{requirements_content}
 
 </verification_context>
 
@@ -347,6 +397,7 @@ Return one of:
 Task(
   prompt=checker_prompt,
   subagent_type="gsd-plan-checker",
+  model="{checker_model}",
   description="Verify Phase {phase} plans"
 )
 ```
@@ -371,6 +422,12 @@ Track: `iteration_count` (starts at 1 after initial plan + check)
 
 Display: `Sending back to planner for revision... (iteration {N}/3)`
 
+Read current plans for revision context:
+
+```bash
+PLANS_CONTENT=$(cat "${PHASE_DIR}"/*-PLAN.md 2>/dev/null)
+```
+
 Spawn gsd-planner with revision prompt:
 
 ```markdown
@@ -380,7 +437,7 @@ Spawn gsd-planner with revision prompt:
 **Mode:** revision
 
 **Existing plans:**
-@.planning/phases/{phase_dir}/*-PLAN.md
+{plans_content}
 
 **Checker issues:**
 {structured_issues_from_checker}
@@ -388,7 +445,7 @@ Spawn gsd-planner with revision prompt:
 </revision_context>
 
 <instructions>
-Read existing PLAN.md files. Make targeted updates to address checker issues.
+Make targeted updates to address checker issues.
 Do NOT replan from scratch unless issues are fundamental.
 Return what changed.
 </instructions>
@@ -398,6 +455,7 @@ Return what changed.
 Task(
   prompt=revision_prompt,
   subagent_type="gsd-planner",
+  model="{planner_model}",
   description="Revise Phase {phase} plans"
 )
 ```

package/commands/gsd/progress.md

@@ -52,6 +52,7 @@ If missing both ROADMAP.md and PROJECT.md: suggest `/gsd:new-project`.
 - Read `.planning/STATE.md` for living memory (position, decisions, issues)
 - Read `.planning/ROADMAP.md` for phase structure and objectives
 - Read `.planning/PROJECT.md` for current state (What This Is, Core Value, Requirements)
+- Read `.planning/config.json` for settings (model_profile, workflow toggles)
   </step>
 
 <step name="recent">
@@ -80,6 +81,7 @@ If missing both ROADMAP.md and PROJECT.md: suggest `/gsd:new-project`.
 # [Project Name]
 
 **Progress:** [████████░░] 8/10 plans complete
+**Profile:** [quality/balanced/budget]
 
 ## Recent Work
 - [Phase X, Plan Y]: [what was accomplished - 1 line]

package/commands/gsd/query-intel.md

@@ -0,0 +1,128 @@
+---
+name: gsd:query-intel
+description: Query codebase intelligence graph for dependencies and hotspots
+argument-hint: "<dependents|hotspots> [file-path]"
+allowed-tools:
+  - Bash
+---
+
+<objective>
+Query the codebase intelligence graph database for relationship information.
+
+**Query types:**
+- `dependents <file>` — What files depend on this file? (blast radius)
+- `hotspots` — Which files have the most dependents? (change carefully)
+
+Output: Formatted query results from graph.db
+</objective>
+
+<context>
+This command exposes the graph query capabilities built by Phase 4 (Semantic Intelligence).
+
+**Use for:**
+- Checking blast radius before refactoring a core file
+- Identifying high-impact files that need careful changes
+- Understanding dependency relationships in the codebase
+
+**Requires:** `.planning/intel/graph.db` (created by `/gsd:analyze-codebase` with entity generation)
+
+If graph.db doesn't exist, the command will return an error suggesting to run analyze-codebase first.
+</context>
+
+<process>
+
+## Step 1: Parse arguments
+
+Extract query type and optional file path from arguments.
+
+**Arguments:** $ARGUMENTS
+
+**Expected formats:**
+- `dependents src/lib/db.ts` — query what depends on this file
+- `hotspots` — query most-depended-on files
+- `hotspots 10` — query top 10 hotspots (default: 5)
+
+## Step 2: Convert file path to entity ID
+
+For `dependents` queries, convert the file path to entity ID format:
+- `src/lib/db.ts` → `src-lib-db`
+- Replace `/` with `-`, remove extension
+
+```bash
+# Example conversion
+FILE_PATH="src/lib/db.ts"
+ENTITY_ID=$(echo "$FILE_PATH" | sed 's/\.[^.]*$//' | tr '/' '-')
+```
+
+## Step 3: Execute query
+
+Run the appropriate query against the graph database:
+
+**For dependents:**
+```bash
+echo '{"action":"query","type":"dependents","target":"'$ENTITY_ID'","limit":20}' | node hooks/gsd-intel-index.js
+```
+
+**For hotspots:**
+```bash
+echo '{"action":"query","type":"hotspots","limit":5}' | node hooks/gsd-intel-index.js
+```
+
+## Step 4: Format and present results
+
+Parse the JSON response and present in readable format.
+
+**For dependents:**
+```
+## Files that depend on {file-path}
+
+Found {count} dependents:
+
+1. src/api/users.ts
+2. src/api/auth.ts
+3. src/services/payment.ts
+...
+
+**Blast radius:** {count} files would be affected by changes.
+```
+
+**For hotspots:**
+```
+## Dependency Hotspots
+
+These files have the most dependents — change carefully:
+
+| Rank | File | Dependents |
+|------|------|------------|
+| 1 | src/lib/db.ts | 42 |
+| 2 | src/types/user.ts | 35 |
+| 3 | src/utils/format.ts | 28 |
+```
+
+## Step 5: Handle errors
+
+**If graph.db doesn't exist:**
+```
+No graph database found at .planning/intel/graph.db
+
+Run /gsd:analyze-codebase first to build the dependency graph.
+```
+
+**If entity not found:**
+```
+No entity found for: {file-path}
+
+The file may not be indexed yet. Try:
+- /gsd:analyze-codebase to rebuild the index
+- Check the file path is correct
+```
+
+</process>
+
+<success_criteria>
+- [ ] Query type parsed from arguments
+- [ ] File path converted to entity ID (for dependents)
+- [ ] Query executed against graph.db
+- [ ] Results formatted in readable markdown
+- [ ] Errors handled gracefully with helpful messages
+</success_criteria>

package/commands/gsd/quick.md

@@ -34,6 +34,27 @@ Orchestration is inline - no separate workflow file. Quick mode is deliberately
 </context>
 
 <process>
+**Step 0: Resolve Model Profile**
+
+Read model profile for agent spawning:
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+Default to "balanced" if not set.
+
+**Model lookup table:**
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| gsd-planner | opus | opus | sonnet |
+| gsd-executor | opus | sonnet | sonnet |
+
+Store resolved models for use in Task calls below.
+
+---
+
 **Step 1: Pre-flight validation**
 
 Check that an active GSD project exists:
@@ -145,6 +166,7 @@ Return: ## PLANNING COMPLETE with plan path
 </output>
 ",
   subagent_type="gsd-planner",
+  model="{planner_model}",
   description="Quick plan: ${DESCRIPTION}"
 )
 ```
@@ -178,6 +200,7 @@ Project state: @.planning/STATE.md
 </constraints>
 ",
   subagent_type="gsd-executor",
+  model="{executor_model}",
   description="Execute: ${DESCRIPTION}"
 )
 ```

package/commands/gsd/research-phase.md

@@ -31,6 +31,24 @@ Normalize phase input in step 1 before any directory lookups.
 
 <process>
 
+## 0. Resolve Model Profile
+
+Read model profile for agent spawning:
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+Default to "balanced" if not set.
+
+**Model lookup table:**
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| gsd-phase-researcher | opus | sonnet | haiku |
+
+Store resolved model for use in Task calls below.
+
 ## 1. Normalize and Validate Phase
 
 ```bash
@@ -132,6 +150,7 @@ Write to: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
 Task(
   prompt=filled_prompt,
   subagent_type="gsd-phase-researcher",
+  model="{researcher_model}",
   description="Research Phase {phase}"
 )
 ```
@@ -165,6 +184,7 @@ Research file: @.planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
 Task(
   prompt=continuation_prompt,
   subagent_type="gsd-phase-researcher",
+  model="{researcher_model}",
   description="Continue research Phase {phase}"
 )
 ```

package/commands/gsd/set-profile.md

@@ -0,0 +1,106 @@
+---
+name: set-profile
+description: Switch model profile for GSD agents (quality/balanced/budget)
+arguments:
+  - name: profile
+    description: "Profile name: quality, balanced, or budget"
+    required: true
+---
+
+<objective>
+Switch the model profile used by GSD agents. This controls which Claude model each agent uses, balancing quality vs token spend.
+</objective>
+
+<profiles>
+| Profile | Description |
+|---------|-------------|
+| **quality** | Opus everywhere except read-only verification |
+| **balanced** | Opus for planning, Sonnet for execution/verification (default) |
+| **budget** | Sonnet for writing, Haiku for research/verification |
+</profiles>
+
+<process>
+
+## 1. Validate argument
+
+```
+if $ARGUMENTS.profile not in ["quality", "balanced", "budget"]:
+  Error: Invalid profile "$ARGUMENTS.profile"
+  Valid profiles: quality, balanced, budget
+  STOP
+```
+
+## 2. Check for project
+
+```bash
+ls .planning/config.json 2>/dev/null
+```
+
+If no `.planning/` directory:
+```
+Error: No GSD project found.
+Run /gsd:new-project first to initialize a project.
+```
+
+## 3. Update config.json
+
+Read current config:
+```bash
+cat .planning/config.json
+```
+
+Update `model_profile` field (or add if missing):
+```json
+{
+  "model_profile": "$ARGUMENTS.profile"
+}
+```
+
+Write updated config back to `.planning/config.json`.
+
+## 4. Confirm
+
+```
+✓ Model profile set to: $ARGUMENTS.profile
+
+Agents will now use:
+[Show table from model-profiles.md for selected profile]
+
+Next spawned agents will use the new profile.
+```
+
+</process>
+
+<examples>
+
+**Switch to budget mode:**
+```
+/gsd:set-profile budget
+
+✓ Model profile set to: budget
+
+Agents will now use:
+| Agent | Model |
+|-------|-------|
+| gsd-planner | sonnet |
+| gsd-executor | sonnet |
+| gsd-verifier | haiku |
+| ... | ... |
+```
+
+**Switch to quality mode:**
+```
+/gsd:set-profile quality
+
+✓ Model profile set to: quality
+
+Agents will now use:
+| Agent | Model |
+|-------|-------|
+| gsd-planner | opus |
+| gsd-executor | opus |
+| gsd-verifier | sonnet |
+| ... | ... |
+```
+
+</examples>

package/commands/gsd/settings.md

@@ -0,0 +1,136 @@
+---
+name: gsd:settings
+description: Configure GSD workflow toggles and model profile
+allowed-tools:
+  - Read
+  - Write
+  - AskUserQuestion
+---
+
+<objective>
+Allow users to toggle workflow agents on/off and select model profile via interactive settings.
+
+Updates `.planning/config.json` with workflow preferences and model profile selection.
+</objective>
+
+<process>
+
+## 1. Validate Environment
+
+```bash
+ls .planning/config.json 2>/dev/null
+```
+
+**If not found:** Error - run `/gsd:new-project` first.
+
+## 2. Read Current Config
+
+```bash
+cat .planning/config.json
+```
+
+Parse current values (default to `true` if not present):
+- `workflow.research` — spawn researcher during plan-phase
+- `workflow.plan_check` — spawn plan checker during plan-phase
+- `workflow.verifier` — spawn verifier during execute-phase
+- `model_profile` — which model each agent uses (default: `balanced`)
+
+## 3. Present Settings
+
+Use AskUserQuestion with current values shown:
+
+```
+AskUserQuestion([
+  {
+    question: "Which model profile for agents?",
+    header: "Model",
+    multiSelect: false,
+    options: [
+      { label: "Quality", description: "Opus everywhere except verification (highest cost)" },
+      { label: "Balanced (Recommended)", description: "Opus for planning, Sonnet for execution/verification" },
+      { label: "Budget", description: "Sonnet for writing, Haiku for research/verification (lowest cost)" }
+    ]
+  },
+  {
+    question: "Spawn Plan Researcher? (researches domain before planning)",
+    header: "Research",
+    multiSelect: false,
+    options: [
+      { label: "Yes", description: "Research phase goals before planning" },
+      { label: "No", description: "Skip research, plan directly" }
+    ]
+  },
+  {
+    question: "Spawn Plan Checker? (verifies plans before execution)",
+    header: "Plan Check",
+    multiSelect: false,
+    options: [
+      { label: "Yes", description: "Verify plans meet phase goals" },
+      { label: "No", description: "Skip plan verification" }
+    ]
+  },
+  {
+    question: "Spawn Execution Verifier? (verifies phase completion)",
+    header: "Verifier",
+    multiSelect: false,
+    options: [
+      { label: "Yes", description: "Verify must-haves after execution" },
+      { label: "No", description: "Skip post-execution verification" }
+    ]
+  }
+])
+```
+
+**Pre-select based on current config values.**
+
+## 4. Update Config
+
+Merge new settings into existing config.json:
+
+```json
+{
+  ...existing_config,
+  "model_profile": "quality" | "balanced" | "budget",
+  "workflow": {
+    "research": true/false,
+    "plan_check": true/false,
+    "verifier": true/false
+  }
+}
+```
+
+Write updated config to `.planning/config.json`.
+
+## 5. Confirm Changes
+
+Display:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► SETTINGS UPDATED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+| Setting              | Value |
+|----------------------|-------|
+| Model Profile        | {quality/balanced/budget} |
+| Plan Researcher      | {On/Off} |
+| Plan Checker         | {On/Off} |
+| Execution Verifier   | {On/Off} |
+
+These settings apply to future /gsd:plan-phase and /gsd:execute-phase runs.
+
+Quick commands:
+- /gsd:set-profile <profile> — switch model profile
+- /gsd:plan-phase --research — force research
+- /gsd:plan-phase --skip-research — skip research
+- /gsd:plan-phase --skip-verify — skip plan check
+```
+
+</process>
+
+<success_criteria>
+- [ ] Current config read
+- [ ] User presented with 4 settings (profile + 3 toggles)
+- [ ] Config updated with model_profile and workflow section
+- [ ] Changes confirmed to user
+</success_criteria>