get-research-done 1.1.0

package/commands/grd/resume-work.md

@@ -0,0 +1,40 @@
+---
+name: grd:resume-work
+description: Resume work from previous session with full context restoration
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+  - SlashCommand
+---
+
+<objective>
+Restore complete project context and resume work seamlessly from previous session.
+
+Routes to the resume-project workflow which handles:
+
+- STATE.md loading (or reconstruction if missing)
+- Checkpoint detection (.continue-here files)
+- Incomplete work detection (PLAN without SUMMARY)
+- Status presentation
+- Context-aware next action routing
+  </objective>
+
+<execution_context>
+@~/.claude/get-research-done/workflows/resume-project.md
+</execution_context>
+
+<process>
+**Follow the resume-project workflow** from `@~/.claude/get-research-done/workflows/resume-project.md`.
+
+The workflow handles all resumption logic including:
+
+1. Project existence verification
+2. STATE.md loading or reconstruction
+3. Checkpoint and incomplete work detection
+4. Visual status presentation
+5. Context-aware option offering (checks CONTEXT.md before suggesting plan vs discuss)
+6. Routing to appropriate next command
+7. Session continuity updates
+   </process>

package/commands/grd/set-profile.md

@@ -0,0 +1,106 @@
+---
+name: grd:set-profile
+description: Switch model profile for GRD agents (quality/balanced/budget)
+arguments:
+  - name: profile
+    description: "Profile name: quality, balanced, or budget"
+    required: true
+---
+
+<objective>
+Switch the model profile used by GRD 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 GRD project found.
+Run /grd: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:**
+```
+/grd:set-profile budget
+
+✓ Model profile set to: budget
+
+Agents will now use:
+| Agent | Model |
+|-------|-------|
+| grd-planner | sonnet |
+| grd-executor | sonnet |
+| grd-verifier | haiku |
+| ... | ... |
+```
+
+**Switch to quality mode:**
+```
+/grd:set-profile quality
+
+✓ Model profile set to: quality
+
+Agents will now use:
+| Agent | Model |
+|-------|-------|
+| grd-planner | opus |
+| grd-executor | opus |
+| grd-verifier | sonnet |
+| ... | ... |
+```
+
+</examples>

package/commands/grd/settings.md

@@ -0,0 +1,136 @@
+---
+name: grd:settings
+description: Configure GRD 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 `/grd: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:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► 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 /grd:plan-phase and /grd:execute-phase runs.
+
+Quick commands:
+- /grd:set-profile <profile> — switch model profile
+- /grd:plan-phase --research — force research
+- /grd:plan-phase --skip-research — skip research
+- /grd: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/commands/grd/update.md

@@ -0,0 +1,172 @@
+---
+name: grd:update
+description: Update GSD to latest version with changelog display
+---
+
+<objective>
+Check for GSD updates, install if available, and display what changed.
+
+Provides a better update experience than raw `npx get-research-done-cc` by showing version diff and changelog entries.
+</objective>
+
+<process>
+
+<step name="get_installed_version">
+Read installed version:
+
+```bash
+cat ~/.claude/get-research-done/VERSION 2>/dev/null
+```
+
+**If VERSION file missing:**
+```
+## GSD Update
+
+**Installed version:** Unknown
+
+Your installation doesn't include version tracking.
+
+Running fresh install...
+```
+
+Proceed to install step (treat as version 0.0.0 for comparison).
+</step>
+
+<step name="check_latest_version">
+Check npm for latest version:
+
+```bash
+npm view get-research-done-cc version 2>/dev/null
+```
+
+**If npm check fails:**
+```
+Couldn't check for updates (offline or npm unavailable).
+
+To update manually: `npx get-research-done-cc --global`
+```
+
+STOP here if npm unavailable.
+</step>
+
+<step name="compare_versions">
+Compare installed vs latest:
+
+**If installed == latest:**
+```
+## GSD Update
+
+**Installed:** X.Y.Z
+**Latest:** X.Y.Z
+
+You're already on the latest version.
+```
+
+STOP here if already up to date.
+
+**If installed > latest:**
+```
+## GSD Update
+
+**Installed:** X.Y.Z
+**Latest:** A.B.C
+
+You're ahead of the latest release (development version?).
+```
+
+STOP here if ahead.
+</step>
+
+<step name="show_changes_and_confirm">
+**If update available**, fetch and show what's new BEFORE updating:
+
+1. Fetch changelog (same as fetch_changelog step)
+2. Extract entries between installed and latest versions
+3. Display preview and ask for confirmation:
+
+```
+## GSD Update Available
+
+**Installed:** 1.5.10
+**Latest:** 1.5.15
+
+### What's New
+────────────────────────────────────────────────────────────
+
+## [1.5.15] - 2026-01-20
+
+### Added
+- Feature X
+
+## [1.5.14] - 2026-01-18
+
+### Fixed
+- Bug fix Y
+
+────────────────────────────────────────────────────────────
+
+⚠️  **Note:** The installer performs a clean install of GSD folders:
+- `~/.claude/commands/gsd/` will be wiped and replaced
+- `~/.claude/get-research-done/` will be wiped and replaced
+- `~/.claude/agents/grd-*` files will be replaced
+
+Your custom files in other locations are preserved:
+- Custom commands in `~/.claude/commands/your-stuff/` ✓
+- Custom agents not prefixed with `grd-` ✓
+- Custom hooks ✓
+- Your CLAUDE.md files ✓
+
+If you've modified any GSD files directly, back them up first.
+```
+
+Use AskUserQuestion:
+- Question: "Proceed with update?"
+- Options:
+  - "Yes, update now"
+  - "No, cancel"
+
+**If user cancels:** STOP here.
+</step>
+
+<step name="run_update">
+Run the update:
+
+```bash
+npx get-research-done-cc --global
+```
+
+Capture output. If install fails, show error and STOP.
+
+Clear the update cache so statusline indicator disappears:
+
+```bash
+rm -f ~/.claude/cache/grd-update-check.json
+```
+</step>
+
+<step name="display_result">
+Format completion message (changelog was already shown in confirmation step):
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║  GSD Updated: v1.5.10 → v1.5.15                           ║
+╚═══════════════════════════════════════════════════════════╝
+
+⚠️  Restart Claude Code to pick up the new commands.
+
+[View full changelog](https://github.com/glittercowboy/get-research-done/blob/main/CHANGELOG.md)
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Installed version read correctly
+- [ ] Latest version checked via npm
+- [ ] Update skipped if already current
+- [ ] Changelog fetched and displayed BEFORE update
+- [ ] Clean install warning shown
+- [ ] User confirmation obtained
+- [ ] Update executed successfully
+- [ ] Restart reminder shown
+</success_criteria>

package/commands/grd/verify-work.md

@@ -0,0 +1,219 @@
+---
+name: grd: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 Claude 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}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /grd:execute-phase
+</objective>
+
+<execution_context>
+@~/.claude/get-research-done/workflows/verify-work.md
+@~/.claude/get-research-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
+
+@.planning/STATE.md
+@.planning/ROADMAP.md
+</context>
+
+<process>
+1. Check for active UAT sessions (resume or start new)
+2. Find SUMMARY.md files for the phase
+3. Extract testable deliverables (user-observable outcomes)
+4. Create {phase}-UAT.md with test list
+5. Present tests one at a time:
+   - Show expected behavior
+   - Wait for plain text response
+   - "yes/y/next" = pass, anything else = issue (severity inferred)
+6. Update UAT.md after each response
+7. On completion: commit, present summary
+8. If issues found:
+   - Spawn parallel debug agents to diagnose root causes
+   - Spawn grd-planner in --gaps mode to create fix plans
+   - Spawn grd-plan-checker to verify fix plans
+   - Iterate planner ↔ checker until plans pass (max 3)
+   - Present ready status with `/clear` then `/grd:execute-phase`
+</process>
+
+<anti_patterns>
+- Don't use AskUserQuestion for test responses — plain text conversation
+- Don't ask severity — infer from description
+- Don't present full checklist upfront — one test at a time
+- Don't run automated tests — this is manual user validation
+- Don't fix issues during testing — log as gaps, diagnose after all tests complete
+</anti_patterns>
+
+<offer_next>
+Output this markdown directly (not as a code block). Route based on UAT results:
+
+| Status | Route |
+|--------|-------|
+| All tests pass + more phases | Route A (next phase) |
+| All tests pass + last phase | Route B (milestone complete) |
+| Issues found + fix plans ready | Route C (execute fixes) |
+| Issues found + planning blocked | Route D (manual intervention) |
+
+---
+
+**Route A: All tests pass, more phases remain**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► PHASE {Z} VERIFIED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{N} tests passed
+UAT complete ✓
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
+
+/grd:discuss-phase {Z+1} — gather context and clarify approach
+
+<sub>/clear first → fresh context window</sub>
+
+───────────────────────────────────────────────────────────────
+
+**Also available:**
+- /grd:plan-phase {Z+1} — skip discussion, plan directly
+- /grd:execute-phase {Z+1} — skip to execution (if already planned)
+
+───────────────────────────────────────────────────────────────
+
+---
+
+**Route B: All tests pass, milestone complete**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► PHASE {Z} VERIFIED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{N} tests passed
+Final phase verified ✓
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Audit milestone** — verify requirements, cross-phase integration, E2E flows
+
+/grd:audit-milestone
+
+<sub>/clear first → fresh context window</sub>
+
+───────────────────────────────────────────────────────────────
+
+**Also available:**
+- /grd:complete-milestone — skip audit, archive directly
+
+───────────────────────────────────────────────────────────────
+
+---
+
+**Route C: Issues found, fix plans ready**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► PHASE {Z} ISSUES FOUND ⚠
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{M} tests passed
+{X} issues diagnosed
+Fix plans verified ✓
+
+### Issues Found
+
+{List issues with severity from UAT.md}
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Execute fix plans** — run diagnosed fixes
+
+/grd:execute-phase {Z} --gaps-only
+
+<sub>/clear first → fresh context window</sub>
+
+───────────────────────────────────────────────────────────────
+
+**Also available:**
+- cat .planning/phases/{phase_dir}/*-PLAN.md — review fix plans
+- /grd:plan-phase {Z} --gaps — regenerate fix plans
+
+───────────────────────────────────────────────────────────────
+
+---
+
+**Route D: Issues found, planning blocked**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► PHASE {Z} BLOCKED ✗
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{M} tests passed
+Fix planning blocked after {X} iterations
+
+### Unresolved Issues
+
+{List blocking issues from planner/checker output}
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Manual intervention required**
+
+Review the issues above and either:
+1. Provide guidance for fix planning
+2. Manually address blockers
+3. Accept current state and continue
+
+───────────────────────────────────────────────────────────────
+
+**Options:**
+- /grd:plan-phase {Z} --gaps — retry fix planning with guidance
+- /grd:discuss-phase {Z} — gather more context before replanning
+
+───────────────────────────────────────────────────────────────
+</offer_next>
+
+<success_criteria>
+- [ ] UAT.md created with tests from SUMMARY.md
+- [ ] Tests presented one at a time with expected behavior
+- [ ] Plain text responses (no structured forms)
+- [ ] Severity inferred, never asked
+- [ ] Batched writes: on issue, every 5 passes, or completion
+- [ ] Committed on completion
+- [ ] If issues: parallel debug agents diagnose root causes
+- [ ] If issues: grd-planner creates fix plans from diagnosed gaps
+- [ ] If issues: grd-plan-checker verifies fix plans (max 3 iterations)
+- [ ] Ready for `/grd:execute-phase` when complete
+</success_criteria>

package/get-research-done/config/default.json

@@ -0,0 +1,15 @@
+{
+  "workflow": {
+    "commit_planning_docs": true,
+    "auto_execute": false,
+    "checkpoint_verification": true
+  },
+  "agents": {
+    "default_profile": "balanced",
+    "spawn_timeout": 600000
+  },
+  "state": {
+    "track_research_loops": true,
+    "session_restoration": true
+  }
+}