get-shit-done-cc 1.5.30 → 1.6.1

package/README.md

@@ -374,8 +374,7 @@ You're never locked in. The system adapts.
 
 | Command | What it does |
 |---------|--------------|
-| `/gsd:new-milestone [name]` | Start next milestone |
-| `/gsd:discuss-milestone` | Gather context for next milestone |
+| `/gsd:new-milestone [name]` | Start next milestone (questioning → research → requirements → roadmap) |
 
 ### Session
 

package/agents/gsd-project-researcher.md

@@ -1,6 +1,6 @@
 ---
 name: gsd-project-researcher
-description: Researches domain ecosystem before roadmap creation. Produces multiple files in .planning/research/ consumed by /gsd:create-roadmap. Spawned by /gsd:research-project orchestrator.
+description: Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd:new-project or /gsd:new-milestone orchestrators.
 tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
 color: cyan
 ---
@@ -10,9 +10,10 @@ You are a GSD project researcher. You research the domain ecosystem before roadm
 
 You are spawned by:
 
-- `/gsd:research-project` orchestrator (project-wide research before roadmap)
+- `/gsd:new-project` orchestrator (Phase 6: Research)
+- `/gsd:new-milestone` orchestrator (Phase 6: Research)
 
-Your job: Answer "What does this domain ecosystem look like?" Produce multiple research files that inform roadmap creation.
+Your job: Answer "What does this domain ecosystem look like?" Produce research files that inform roadmap creation.
 
 **Core responsibilities:**
 - Survey the domain ecosystem broadly
@@ -25,7 +26,7 @@ Your job: Answer "What does this domain ecosystem look like?" Produce multiple r
 </role>
 
 <downstream_consumer>
-Your research files are consumed by `/gsd:create-roadmap` which uses them to:
+Your research files are consumed during roadmap creation:
 
 | File | How Roadmap Uses It |
 |------|---------------------|
@@ -807,7 +808,7 @@ When research finishes successfully:
 
 ### Ready for Roadmap
 
-Research complete. Run `/gsd:create-roadmap` to create phase structure.
+Research complete. Proceeding to roadmap creation.
 ```
 
 ## Research Blocked

package/agents/gsd-roadmapper.md

@@ -286,114 +286,23 @@ After roadmap creation, REQUIREMENTS.md gets updated with phase mappings:
 
 ## ROADMAP.md Structure
 
-```markdown
-# Roadmap
-
-**Project:** [name]
-**Created:** [date]
-**Phases:** [N]
-
-## Overview
-
-[2-3 sentences describing the roadmap approach]
-
-## Phases
-
-### Phase 1: [Name]
-
-**Goal:** [What this phase delivers - outcome, not task]
-**Depends on:** Nothing (first phase)
-**Requirements:** [REQ-IDs]
-
-**Success Criteria:**
-1. [Observable user behavior]
-2. [Observable user behavior]
-3. [Observable user behavior]
-
-**Plans:** (created by /gsd:plan-phase)
-
----
-
-### Phase 2: [Name]
-
-**Goal:** [Outcome]
-**Depends on:** Phase 1
-**Requirements:** [REQ-IDs]
-
-**Success Criteria:**
-1. [Observable user behavior]
-2. [Observable user behavior]
-
----
+Use template from `~/.claude/get-shit-done/templates/roadmap.md`.
 
-[... more phases ...]
-
-## Progress
-
-| Phase | Status | Completed |
-|-------|--------|-----------|
-| 1 - [Name] | Not started | — |
-| 2 - [Name] | Not started | — |
-| 3 - [Name] | Not started | — |
-
----
-
-*Roadmap for milestone: v1.0*
-```
+Key sections:
+- Overview (2-3 sentences)
+- Phases with Goal, Dependencies, Requirements, Success Criteria
+- Progress table
 
 ## STATE.md Structure
 
-```markdown
-# Project State
-
-## Project Reference
-
-See: .planning/PROJECT.md
-
-**Core value:** [from PROJECT.md]
-**Current focus:** Phase 1 — [name]
-
-## Current Position
-
-Phase: 1 of [N] ([name])
-Plan: Not started
-Status: Ready to plan
-Last activity: [date] — Project initialized
-
-Progress: ░░░░░░░░░░ 0%
-
-## Performance Metrics
-
-**Velocity:**
-- Total plans completed: 0
-- Average duration: —
-
-**By Phase:**
+Use template from `~/.claude/get-shit-done/templates/state.md`.
 
-| Phase | Plans | Total | Avg/Plan |
-|-------|-------|-------|----------|
-| — | — | — | — |
-
-## Accumulated Context
-
-### Decisions
-
-(None yet)
-
-### Pending Todos
-
-(None yet)
-
-### Blockers/Concerns
-
-(None yet)
-
-## Session Continuity
-
-Last session: [date]
-Stopped at: Project initialization
-Resume file: None
-```
+Key sections:
+- Project Reference (core value, current focus)
+- Current Position (phase, plan, status, progress bar)
+- Performance Metrics
+- Accumulated Context (decisions, todos, blockers)
+- Session Continuity
 
 ## Draft Presentation Format
 

package/bin/install.js

@@ -123,8 +123,13 @@ function writeSettings(settingsPath, settings) {
 
 /**
  * Recursively copy directory, replacing paths in .md files
+ * Deletes existing destDir first to remove orphaned files from previous versions
  */
 function copyWithPathReplacement(srcDir, destDir, pathPrefix) {
+  // Clean install: remove existing destination to prevent orphaned files
+  if (fs.existsSync(destDir)) {
+    fs.rmSync(destDir, { recursive: true });
+  }
   fs.mkdirSync(destDir, { recursive: true });
 
   const entries = fs.readdirSync(srcDir, { withFileTypes: true });
@@ -187,10 +192,30 @@ function install(isGlobal) {
   console.log(`  ${green}✓${reset} Installed get-shit-done`);
 
   // Copy agents to ~/.claude/agents (subagents must be at root level)
+  // Only delete gsd-*.md files to preserve user's custom agents
   const agentsSrc = path.join(src, 'agents');
   if (fs.existsSync(agentsSrc)) {
     const agentsDest = path.join(claudeDir, 'agents');
-    copyWithPathReplacement(agentsSrc, agentsDest, pathPrefix);
+    fs.mkdirSync(agentsDest, { recursive: true });
+
+    // Remove old GSD agents (gsd-*.md) before copying new ones
+    if (fs.existsSync(agentsDest)) {
+      for (const file of fs.readdirSync(agentsDest)) {
+        if (file.startsWith('gsd-') && file.endsWith('.md')) {
+          fs.unlinkSync(path.join(agentsDest, file));
+        }
+      }
+    }
+
+    // Copy new agents (don't use copyWithPathReplacement which would wipe the folder)
+    const agentEntries = fs.readdirSync(agentsSrc, { withFileTypes: true });
+    for (const entry of agentEntries) {
+      if (entry.isFile() && entry.name.endsWith('.md')) {
+        let content = fs.readFileSync(path.join(agentsSrc, entry.name), 'utf8');
+        content = content.replace(/~\/\.claude\//g, pathPrefix);
+        fs.writeFileSync(path.join(agentsDest, entry.name), content);
+      }
+    }
     console.log(`  ${green}✓${reset} Installed agents`);
   }
 

package/commands/gsd/complete-milestone.md

@@ -108,8 +108,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
    - Ask about pushing tag
 
 8. **Offer next steps:**
-   - `/gsd:discuss-milestone` — thinking partner, creates context file
-   - Then `/gsd:new-milestone` — update PROJECT.md with new goals
+   - `/gsd:new-milestone` — start next milestone (questioning → research → requirements → roadmap)
 
 </process>
 
@@ -133,5 +132,5 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 - **Archive before deleting:** Always create archive files before updating/deleting originals
 - **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
 - **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
-- **Fresh requirements:** Next milestone starts with `/gsd:define-requirements`, not reusing old file
+- **Fresh requirements:** Next milestone starts with `/gsd:new-milestone` which includes requirements definition
   </critical_rules>

package/commands/gsd/help.md

@@ -76,14 +76,6 @@ Map an existing codebase for brownfield projects.
 
 Usage: `/gsd:map-codebase`
 
-### Standalone Commands (deprecated, kept for mid-project use)
-
-These commands are now integrated into `/gsd:new-project` but remain available for mid-project adjustments:
-
-**`/gsd:research-project`** — Re-research a domain (integrated into new-project Phase 6)
-**`/gsd:define-requirements`** — Redefine requirements (integrated into new-project Phase 7)
-**`/gsd:create-roadmap`** — Recreate roadmap (integrated into new-project Phase 8)
-
 ### Phase Planning
 
 **`/gsd:discuss-phase <number>`**
@@ -171,21 +163,15 @@ Result: Phase 17 deleted, phases 18-20 become 17-19
 
 ### Milestone Management
 
-**`/gsd:discuss-milestone`**
-Figure out what you want to build in the next milestone.
-
-- Reviews what shipped in previous milestone
-- Helps you identify features to add, improve, or fix
-- Routes to /gsd:new-milestone when ready
-
-Usage: `/gsd:discuss-milestone`
-
 **`/gsd:new-milestone <name>`**
-Create a new milestone with phases for an existing project.
+Start a new milestone through unified flow.
+
+- Deep questioning to understand what you're building next
+- Optional domain research (spawns 4 parallel researcher agents)
+- Requirements definition with scoping
+- Roadmap creation with phase breakdown
 
-- Adds milestone section to ROADMAP.md
-- Creates phase directories
-- Updates STATE.md for new milestone
+Mirrors `/gsd:new-project` flow for brownfield projects (existing PROJECT.md).
 
 Usage: `/gsd:new-milestone "v2.0 Features"`
 
@@ -366,7 +352,8 @@ Change anytime by editing `.planning/config.json`
 
 ```
 /gsd:complete-milestone 1.0.0
-/gsd:new-milestone  # Start next milestone
+/clear
+/gsd:new-milestone  # Start next milestone (questioning → research → requirements → roadmap)
 ```
 
 **Capturing ideas during work:**