feat(01-01): Split new-project to only create PROJECT.md + config.json

- Removed roadmap_and_state step from new-project command
- new-project now offers research-project or create-roadmap as next steps
- Updated help.md with new 5-step Quick Start flow
- Documented research-project and create-roadmap commands in help

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

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 <number>` - Create detailed plan for first phase
-3. `/gsd:execute-plan <path>` - 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 <number>` - Create detailed plan for first phase
+5. `/gsd:execute-plan <path>` - 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 <number>`**
@@ -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
 ```
 

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:
 ---
 
 <!--
-DESIGN NOTE: Command + Workflow Pattern
+DESIGN NOTE: Initialization Only
 
-This command handles the questioning phase directly (user interaction intensive),
-then delegates roadmap/state creation to the create-roadmap workflow.
+This command handles project initialization only:
+- Deep context gathering through questioning
+- PROJECT.md creation
+- config.json with workflow mode
 
-Architecture:
-- Command: new-project.md - questioning, PROJECT.md, config.json
-- Workflow: create-roadmap.md - domain detection, research flags, ROADMAP.md, STATE.md
+Roadmap creation is now a separate step via /gsd:create-roadmap.
+This allows optional research (/gsd:research-project) between initialization and roadmap.
 -->
 
 <objective>
@@ -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.
 </objective>
 
 <execution_context>
-@~/.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.
 </step>
 
-<step name="roadmap_and_state">
-**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
-  </step>
 
 <step name="commit">
 ```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
+)"
 ```
 </step>
 
 <step name="done">
 ```
-
 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`
 </step>
 
 </process>
 
 <output>
 - `.planning/PROJECT.md`
-- `.planning/ROADMAP.md`
-- `.planning/STATE.md`
 - `.planning/config.json`
-- `.planning/phases/XX-name/` directories
 </output>
 
 <success_criteria>
 - [ ] 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
 </success_criteria>
-```