8f26bfa478
Pattern: Command → workflow → gsd-tools Token savings: ~150 chars per command Ported from: get-shit-done-v2@213392b
179 lines
4.3 KiB
Markdown
179 lines
4.3 KiB
Markdown
<purpose>
|
|
Add a new integer phase to the end of the current milestone in the roadmap. Automatically calculates next phase number, creates phase directory, and updates roadmap structure.
|
|
</purpose>
|
|
|
|
<required_reading>
|
|
Read all files referenced by the invoking prompt's execution_context before starting.
|
|
</required_reading>
|
|
|
|
<process>
|
|
|
|
<step name="parse_arguments">
|
|
Parse the command arguments:
|
|
- All arguments become the phase description
|
|
- Example: `/gsd:add-phase Add authentication` → description = "Add authentication"
|
|
- Example: `/gsd:add-phase Fix critical performance issues` → description = "Fix critical performance issues"
|
|
|
|
If no arguments provided:
|
|
|
|
```
|
|
ERROR: Phase description required
|
|
Usage: /gsd:add-phase <description>
|
|
Example: /gsd:add-phase Add authentication system
|
|
```
|
|
|
|
Exit.
|
|
</step>
|
|
|
|
<step name="load_roadmap">
|
|
Load the roadmap file:
|
|
|
|
```bash
|
|
node ~/.claude/get-shit-done/bin/gsd-tools.js verify-path-exists .planning/ROADMAP.md --raw
|
|
```
|
|
|
|
If false:
|
|
```
|
|
ERROR: No roadmap found (.planning/ROADMAP.md)
|
|
Run /gsd:new-project to initialize.
|
|
```
|
|
Exit.
|
|
|
|
Read roadmap content for parsing.
|
|
</step>
|
|
|
|
<step name="find_current_milestone">
|
|
Parse the roadmap to find the current milestone section:
|
|
|
|
1. Locate the "## Current Milestone:" heading
|
|
2. Extract milestone name and version
|
|
3. Identify all phases under this milestone (before next "---" separator or next milestone heading)
|
|
4. Parse existing phase numbers (including decimals if present)
|
|
|
|
Example structure:
|
|
|
|
```
|
|
## Current Milestone: v1.0 Foundation
|
|
|
|
### Phase 4: Focused Command System
|
|
### Phase 5: Path Routing & Validation
|
|
### Phase 6: Documentation & Distribution
|
|
```
|
|
</step>
|
|
|
|
<step name="calculate_next_phase">
|
|
Find the highest integer phase number in the current milestone:
|
|
|
|
1. Extract all phase numbers from phase headings (### Phase N:)
|
|
2. Filter to integer phases only (ignore decimals like 4.1, 4.2)
|
|
3. Find the maximum integer value
|
|
4. Add 1 to get the next phase number
|
|
|
|
Example: If phases are 4, 5, 5.1, 6 → next is 7
|
|
|
|
Format as two-digit: `printf "%02d" $next_phase`
|
|
</step>
|
|
|
|
<step name="generate_slug">
|
|
Convert the phase description to a kebab-case slug:
|
|
|
|
```bash
|
|
slug=$(node ~/.claude/get-shit-done/bin/gsd-tools.js generate-slug "$description" --raw)
|
|
```
|
|
|
|
Phase directory name: `{two-digit-phase}-{slug}`
|
|
Example: `07-add-authentication`
|
|
</step>
|
|
|
|
<step name="create_phase_directory">
|
|
Create the phase directory structure:
|
|
|
|
```bash
|
|
phase_dir=".planning/phases/${phase_num}-${slug}"
|
|
mkdir -p "$phase_dir"
|
|
```
|
|
|
|
Confirm: "Created directory: $phase_dir"
|
|
</step>
|
|
|
|
<step name="update_roadmap">
|
|
Add the new phase entry to the roadmap:
|
|
|
|
1. Find the insertion point (after last phase in current milestone, before "---" separator)
|
|
2. Insert new phase heading:
|
|
|
|
```
|
|
### Phase {N}: {Description}
|
|
|
|
**Goal:** [To be planned]
|
|
**Depends on:** Phase {N-1}
|
|
**Plans:** 0 plans
|
|
|
|
Plans:
|
|
- [ ] TBD (run /gsd:plan-phase {N} to break down)
|
|
|
|
**Details:**
|
|
[To be added during planning]
|
|
```
|
|
|
|
3. Write updated roadmap back to file
|
|
|
|
Preserve all other content exactly (formatting, spacing, other phases).
|
|
</step>
|
|
|
|
<step name="update_project_state">
|
|
Update STATE.md to reflect the new phase:
|
|
|
|
1. Read `.planning/STATE.md`
|
|
2. Under "## Current Position" → "**Next Phase:**" add reference to new phase
|
|
3. Under "## Accumulated Context" → "### Roadmap Evolution" add entry:
|
|
```
|
|
- Phase {N} added: {description}
|
|
```
|
|
|
|
If "Roadmap Evolution" section doesn't exist, create it.
|
|
</step>
|
|
|
|
<step name="completion">
|
|
Present completion summary:
|
|
|
|
```
|
|
Phase {N} added to current milestone:
|
|
- Description: {description}
|
|
- Directory: .planning/phases/{phase-num}-{slug}/
|
|
- Status: Not planned yet
|
|
|
|
Roadmap updated: .planning/ROADMAP.md
|
|
Project state updated: .planning/STATE.md
|
|
|
|
---
|
|
|
|
## ▶ Next Up
|
|
|
|
**Phase {N}: {description}**
|
|
|
|
`/gsd:plan-phase {N}`
|
|
|
|
<sub>`/clear` first → fresh context window</sub>
|
|
|
|
---
|
|
|
|
**Also available:**
|
|
- `/gsd:add-phase <description>` — add another phase
|
|
- Review roadmap
|
|
|
|
---
|
|
```
|
|
</step>
|
|
|
|
</process>
|
|
|
|
<success_criteria>
|
|
- [ ] Phase directory created: `.planning/phases/{NN}-{slug}/`
|
|
- [ ] Roadmap updated with new phase entry
|
|
- [ ] STATE.md updated with roadmap evolution note
|
|
- [ ] New phase appears at end of current milestone
|
|
- [ ] Next phase number calculated correctly (ignoring decimals)
|
|
- [ ] User informed of next steps
|
|
</success_criteria>
|