diff --git a/commands/gsd/help.md b/commands/gsd/help.md index aee09a1bf..d7dfc645f 100644 --- a/commands/gsd/help.md +++ b/commands/gsd/help.md @@ -20,9 +20,11 @@ Output ONLY the reference content below. Do NOT add: ## Quick Start -1. `/gsd:new-project` - Initialize project with brief and roadmap -2. `/gsd:plan-phase ` - Create detailed plan for first phase -3. `/gsd:execute-plan ` - Execute the plan +1. `/gsd:new-project` - Initialize project with brief +2. `/gsd:research-project` - (Optional) Research domain ecosystem +3. `/gsd:create-roadmap` - Create roadmap and phases +4. `/gsd:plan-phase ` - Create detailed plan for first phase +5. `/gsd:execute-plan ` - Execute the plan ## Core Workflow @@ -33,17 +35,35 @@ Initialization → Planning → Execution → Milestone Completion ### Project Initialization **`/gsd:new-project`** -Initialize new project with brief, roadmap, and state tracking. +Initialize new project with brief and configuration. - Creates `.planning/PROJECT.md` (vision and requirements) -- Creates `.planning/ROADMAP.md` (phase breakdown) -- Creates `.planning/STATE.md` (project memory) - Creates `.planning/config.json` (workflow mode) - Asks for workflow mode (interactive/yolo) upfront -- Commits all initialization files to git +- Commits initialization files to git Usage: `/gsd:new-project` +**`/gsd:research-project`** +Research domain ecosystem before creating roadmap. + +- Spawns batched subagents to research domain patterns +- Creates `.planning/research/` with ecosystem findings +- Optional step for niche/complex domains +- Run after new-project, before create-roadmap + +Usage: `/gsd:research-project` + +**`/gsd:create-roadmap`** +Create roadmap and state tracking for initialized project. + +- Creates `.planning/ROADMAP.md` (phase breakdown) +- Creates `.planning/STATE.md` (project memory) +- Creates `.planning/phases/` directories +- Incorporates research findings if present + +Usage: `/gsd:create-roadmap` + ### Phase Planning **`/gsd:discuss-phase `** @@ -242,6 +262,7 @@ Change anytime by editing `.planning/config.json` ``` /gsd:new-project +/gsd:create-roadmap /gsd:plan-phase 1 /gsd:execute-plan .planning/phases/01-foundation/01-01-PLAN.md ``` @@ -250,8 +271,9 @@ Change anytime by editing `.planning/config.json` ``` /gsd:new-project -/gsd:research-phase 1 # Learn how experts build this -/gsd:plan-phase 1 # Plan using research findings +/gsd:research-project # Research domain ecosystem before roadmap +/gsd:create-roadmap # Roadmap incorporates research findings +/gsd:plan-phase 1 /gsd:execute-plan .planning/phases/01-foundation/01-01-PLAN.md ``` diff --git a/commands/gsd/new-project.md b/commands/gsd/new-project.md index 2a9930f29..bc7eb0083 100644 --- a/commands/gsd/new-project.md +++ b/commands/gsd/new-project.md @@ -1,5 +1,5 @@ --- -description: Initialize a new project with deep context gathering, PROJECT.md, roadmap, and state tracking +description: Initialize a new project with deep context gathering and PROJECT.md allowed-tools: - Read - Bash @@ -8,14 +8,15 @@ allowed-tools: --- @@ -23,11 +24,10 @@ Initialize a new project through comprehensive context gathering. This is the most leveraged moment in any project. Deep questioning here means better plans, better execution, better outcomes. -Creates `.planning/` with PROJECT.md, ROADMAP.md, STATE.md, and config.json. +Creates `.planning/` with PROJECT.md and config.json. -@~/.claude/get-shit-done/workflows/create-roadmap.md @~/.claude/get-shit-done/references/principles.md @~/.claude/get-shit-done/references/questioning.md @~/.claude/get-shit-done/templates/project.md @@ -95,83 +95,47 @@ Use AskUserQuestion: Create `.planning/config.json` with chosen mode using `templates/config.json` structure. - -**Follow the create-roadmap workflow** from `@~/.claude/get-shit-done/workflows/create-roadmap.md`. - -This handles: - -1. Domain expertise detection (scan for applicable skills) -2. Phase identification (3-6 phases based on PROJECT.md) -3. Research needs detection (flag phases needing investigation) -4. Phase confirmation (respects yolo/interactive mode) -5. ROADMAP.md creation with research flags -6. STATE.md initialization -7. Phase directory creation - -The workflow will create: - -- `.planning/ROADMAP.md` -- `.planning/STATE.md` -- `.planning/phases/XX-name/` directories - ```bash -git add .planning/ +git add .planning/PROJECT.md .planning/config.json git commit -m "$(cat <<'EOF' -docs: initialize [project-name] ([N] phases) +docs: initialize [project-name] [One-liner from PROJECT.md] -Phases: - -1. [phase-name]: [goal] -2. [phase-name]: [goal] -3. [phase-name]: [goal] - EOF - )" - +Creates PROJECT.md with vision and requirements. +EOF +)" ``` ``` - Project initialized: - - Project: .planning/PROJECT.md -- Roadmap: .planning/ROADMAP.md ([N] phases) -- State: .planning/STATE.md - Config: .planning/config.json (mode: [chosen mode]) What's next? - -1. Plan Phase 1 (/gsd:plan-phase 01) -2. Review project setup +1. Research domain ecosystem (/gsd:research-project) - For niche/complex domains +2. Create roadmap (/gsd:create-roadmap) - Skip research, go straight to planning 3. Done for now - ``` -If user selects "Plan Phase 1" → invoke `/gsd:plan-phase 01` +If user selects "Research domain ecosystem" → invoke `/gsd:research-project` +If user selects "Create roadmap" → invoke `/gsd:create-roadmap` - `.planning/PROJECT.md` -- `.planning/ROADMAP.md` -- `.planning/STATE.md` - `.planning/config.json` -- `.planning/phases/XX-name/` directories - [ ] Deep questioning completed (not rushed) - [ ] PROJECT.md captures full context - [ ] config.json has workflow mode -- [ ] ROADMAP.md has 3-6 phases with research flags -- [ ] STATE.md initialized with project summary -- [ ] Phase directories created - [ ] All committed to git -```