get-shit-done-cc 1.7.1 → 1.9.0

package/commands/gsd/remove-phase.md

@@ -252,6 +252,17 @@ Update any internal references to reflect new numbering.
 <step name="commit">
 Stage and commit the removal:
 
+**Check planning config:**
+
+```bash
+COMMIT_PLANNING_DOCS=$(cat .planning/config.json 2>/dev/null | grep -o '"commit_docs"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
+git check-ignore -q .planning 2>/dev/null && COMMIT_PLANNING_DOCS=false
+```
+
+**If `COMMIT_PLANNING_DOCS=false`:** Skip git operations
+
+**If `COMMIT_PLANNING_DOCS=true` (default):**
+
 ```bash
 git add .planning/
 git commit -m "chore: remove phase {target} ({original-phase-name})"

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>

package/get-shit-done/references/model-profiles.md

@@ -0,0 +1,73 @@
+# Model Profiles
+
+Model profiles control which Claude model each GSD agent uses. This allows balancing quality vs token spend.
+
+## Profile Definitions
+
+| Agent | `quality` | `balanced` | `budget` |
+|-------|-----------|------------|----------|
+| gsd-planner | opus | opus | sonnet |
+| gsd-roadmapper | opus | sonnet | sonnet |
+| gsd-executor | opus | sonnet | sonnet |
+| gsd-phase-researcher | opus | sonnet | haiku |
+| gsd-project-researcher | opus | sonnet | haiku |
+| gsd-research-synthesizer | sonnet | sonnet | haiku |
+| gsd-debugger | opus | sonnet | sonnet |
+| gsd-codebase-mapper | sonnet | haiku | haiku |
+| gsd-verifier | sonnet | sonnet | haiku |
+| gsd-plan-checker | sonnet | sonnet | haiku |
+| gsd-integration-checker | sonnet | sonnet | haiku |
+
+## Profile Philosophy
+
+**quality** - Maximum reasoning power
+- Opus for all decision-making agents
+- Sonnet for read-only verification
+- Use when: quota available, critical architecture work
+
+**balanced** (default) - Smart allocation
+- Opus only for planning (where architecture decisions happen)
+- Sonnet for execution and research (follows explicit instructions)
+- Sonnet for verification (needs reasoning, not just pattern matching)
+- Use when: normal development, good balance of quality and cost
+
+**budget** - Minimal Opus usage
+- Sonnet for anything that writes code
+- Haiku for research and verification
+- Use when: conserving quota, high-volume work, less critical phases
+
+## Resolution Logic
+
+Orchestrators resolve model before spawning:
+
+```
+1. Read .planning/config.json
+2. Get model_profile (default: "balanced")
+3. Look up agent in table above
+4. Pass model parameter to Task call
+```
+
+## Switching Profiles
+
+Runtime: `/gsd:set-profile <profile>`
+
+Per-project default: Set in `.planning/config.json`:
+```json
+{
+  "model_profile": "balanced"
+}
+```
+
+## Design Rationale
+
+**Why Opus for gsd-planner?**
+Planning involves architecture decisions, goal decomposition, and task design. This is where model quality has the highest impact.
+
+**Why Sonnet for gsd-executor?**
+Executors follow explicit PLAN.md instructions. The plan already contains the reasoning; execution is implementation.
+
+**Why Sonnet (not Haiku) for verifiers in balanced?**
+Verification requires goal-backward reasoning - checking if code *delivers* what the phase promised, not just pattern matching. Sonnet handles this well; Haiku may miss subtle gaps.
+
+**Why Haiku for gsd-codebase-mapper?**
+Read-only exploration and pattern extraction. No reasoning required, just structured output from file contents.

package/get-shit-done/references/planning-config.md

@@ -0,0 +1,94 @@
+<planning_config>
+
+Configuration options for `.planning/` directory behavior.
+
+<config_schema>
+```json
+"planning": {
+  "commit_docs": true,
+  "search_gitignored": false
+}
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `commit_docs` | `true` | Whether to commit planning artifacts to git |
+| `search_gitignored` | `false` | Add `--no-ignore` to broad rg searches |
+</config_schema>
+
+<commit_docs_behavior>
+
+**When `commit_docs: true` (default):**
+- Planning files committed normally
+- SUMMARY.md, STATE.md, ROADMAP.md tracked in git
+- Full history of planning decisions preserved
+
+**When `commit_docs: false`:**
+- Skip all `git add`/`git commit` for `.planning/` files
+- User must add `.planning/` to `.gitignore`
+- Useful for: OSS contributions, client projects, keeping planning private
+
+**Checking the config:**
+
+```bash
+# Check config.json first
+COMMIT_DOCS=$(cat .planning/config.json 2>/dev/null | grep -o '"commit_docs"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
+
+# Auto-detect gitignored (overrides config)
+git check-ignore -q .planning 2>/dev/null && COMMIT_DOCS=false
+```
+
+**Auto-detection:** If `.planning/` is gitignored, `commit_docs` is automatically `false` regardless of config.json. This prevents git errors when users have `.planning/` in `.gitignore`.
+
+**Conditional git operations:**
+
+```bash
+if [ "$COMMIT_DOCS" = "true" ]; then
+  git add .planning/STATE.md
+  git commit -m "docs: update state"
+fi
+```
+
+</commit_docs_behavior>
+
+<search_behavior>
+
+**When `search_gitignored: false` (default):**
+- Standard rg behavior (respects .gitignore)
+- Direct path searches work: `rg "pattern" .planning/` finds files
+- Broad searches skip gitignored: `rg "pattern"` skips `.planning/`
+
+**When `search_gitignored: true`:**
+- Add `--no-ignore` to broad rg searches that should include `.planning/`
+- Only needed when searching entire repo and expecting `.planning/` matches
+
+**Note:** Most GSD operations use direct file reads or explicit paths, which work regardless of gitignore status.
+
+</search_behavior>
+
+<setup_uncommitted_mode>
+
+To use uncommitted mode:
+
+1. **Set config:**
+   ```json
+   "planning": {
+     "commit_docs": false,
+     "search_gitignored": true
+   }
+   ```
+
+2. **Add to .gitignore:**
+   ```
+   .planning/
+   ```
+
+3. **Existing tracked files:** If `.planning/` was previously tracked:
+   ```bash
+   git rm -r --cached .planning/
+   git commit -m "chore: stop tracking planning docs"
+   ```
+
+</setup_uncommitted_mode>
+
+</planning_config>

package/get-shit-done/templates/config.json

@@ -1,6 +1,15 @@
 {
   "mode": "interactive",
   "depth": "standard",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true
+  },
+  "planning": {
+    "commit_docs": true,
+    "search_gitignored": false
+  },
   "parallelization": {
     "enabled": true,
     "plan_level": true,

package/get-shit-done/templates/entity.md

@@ -0,0 +1,173 @@
+# Entity Template
+
+Template for `.planning/codebase/{entity-slug}.md` - file-level intelligence documentation.
+
+---
+
+## File Template
+
+```markdown
+---
+path: {path}
+type: {type}
+updated: {updated}
+status: {status}
+---
+
+# {filename}
+
+## Purpose
+
+{purpose}
+
+## Exports
+
+{exports}
+
+## Dependencies
+
+{dependencies}
+
+## Used By
+
+{used_by}
+
+## Notes
+
+{notes}
+```
+
+---
+
+## Field Reference
+
+### Frontmatter
+
+| Field | Values | Description |
+|-------|--------|-------------|
+| `path` | Absolute path | Full path to the file |
+| `type` | module, component, util, config, test, api, hook | Primary classification |
+| `updated` | YYYY-MM-DD | Last time this entity was updated |
+| `status` | active, deprecated, stub | Current state |
+
+### Sections
+
+**Purpose** (required)
+1-3 sentences covering:
+- What this file does
+- Why it exists
+- Who/what uses it (high-level)
+
+**Exports** (required for modules with exports)
+List each export with signature and description:
+```markdown
+- `functionName(arg: Type): ReturnType` - What it does
+- `ClassName` - What it represents
+- `CONSTANT_NAME` - What value it holds
+```
+
+For files without exports (config, tests), write "None" or describe what the file defines.
+
+**Dependencies** (required)
+Internal dependencies use wiki-links (slugified paths):
+```markdown
+- [[src-lib-db]] - Database client
+- [[src-types-user]] - User type definitions
+```
+
+External dependencies use plain text:
+```markdown
+- react - Component framework
+- jose - JWT handling
+```
+
+**Used By** (grows over time)
+Files that import this one, using wiki-links:
+```markdown
+- [[src-app-api-auth-route]]
+- [[src-components-dashboard]]
+```
+
+Initially may be empty or incomplete. Updated as Claude encounters imports.
+
+**Notes** (optional)
+Patterns, gotchas, or context:
+```markdown
+- Uses singleton pattern for connection pooling
+- WARNING: Must call `init()` before any other method
+- Related: See [[src-lib-cache]] for caching layer
+```
+
+---
+
+## Slug Convention
+
+Entity slugs are derived from file paths:
+- `src/lib/db.ts` becomes `src-lib-db`
+- `src/app/api/auth/route.ts` becomes `src-app-api-auth-route`
+
+Rule: Replace `/` and `.` with `-`, drop file extension.
+
+---
+
+## Example
+
+```markdown
+---
+path: /project/src/lib/auth.ts
+type: util
+updated: 2025-01-15
+status: active
+---
+
+# auth.ts
+
+## Purpose
+
+JWT token management using jose library. Handles token creation, verification, and refresh rotation. Used by all protected API routes via middleware.
+
+## Exports
+
+- `createAccessToken(userId: string): Promise<string>` - Creates 15-min access token
+- `createRefreshToken(userId: string): Promise<string>` - Creates 7-day refresh token
+- `verifyToken(token: string): Promise<TokenPayload>` - Validates and decodes token
+- `rotateRefresh(oldToken: string): Promise<TokenPair>` - Issues new token pair
+
+## Dependencies
+
+- [[src-lib-db]] - Stores refresh tokens for revocation
+- [[src-types-auth]] - TokenPayload, TokenPair types
+- jose - JWT signing and verification
+- bcrypt - Password hashing
+
+## Used By
+
+- [[src-middleware]]
+- [[src-app-api-auth-login-route]]
+- [[src-app-api-auth-logout-route]]
+- [[src-app-api-auth-refresh-route]]
+
+## Notes
+
+- Access tokens are stateless; refresh tokens stored in DB for revocation
+- Uses RS256 algorithm with keys from environment
+- WARNING: Never log token values, even in debug mode
+```
+
+---
+
+## Guidelines
+
+**When to create/update:**
+- After modifying a file during plan execution
+- When encountering a file that lacks documentation
+- When relationships change (new imports, exports)
+
+**Minimal viable entity:**
+At minimum, an entity needs frontmatter + Purpose. Other sections can be "TBD" if unknown.
+
+**Accuracy over completeness:**
+Better to have partial accurate info than complete guesses. Mark unknowns explicitly.
+
+**Link discovery:**
+The hook that processes entities extracts all `[[wiki-links]]` to build the relationship graph. Ensure links use correct slug format.

package/get-shit-done/workflows/complete-milestone.md

@@ -620,6 +620,17 @@ git push origin v[X.Y]
 
 Commit milestone completion including archive files and deletions.
 
+**Check planning config:**
+
+```bash
+COMMIT_PLANNING_DOCS=$(cat .planning/config.json 2>/dev/null | grep -o '"commit_docs"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
+git check-ignore -q .planning 2>/dev/null && COMMIT_PLANNING_DOCS=false
+```
+
+**If `COMMIT_PLANNING_DOCS=false`:** Skip git operations
+
+**If `COMMIT_PLANNING_DOCS=true` (default):**
+
 ```bash
 # Stage archive files (new)
 git add .planning/milestones/v[X.Y]-ROADMAP.md

package/get-shit-done/workflows/diagnose-issues.md

@@ -156,6 +156,17 @@ For each gap in the Gaps section, add artifacts and missing fields:
 
 Update status in frontmatter to "diagnosed".
 
+**Check planning config:**
+
+```bash
+COMMIT_PLANNING_DOCS=$(cat .planning/config.json 2>/dev/null | grep -o '"commit_docs"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
+git check-ignore -q .planning 2>/dev/null && COMMIT_PLANNING_DOCS=false
+```
+
+**If `COMMIT_PLANNING_DOCS=false`:** Skip git operations
+
+**If `COMMIT_PLANNING_DOCS=true` (default):**
+
 Commit the updated UAT.md:
 ```bash
 git add ".planning/phases/XX-name/{phase}-UAT.md"