get-shit-done-cc 1.2.8 → 1.2.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -163,19 +163,17 @@ Phase {N} added to current milestone:
163
163
  Roadmap updated: {roadmap-path}
164
164
  Project state updated: .planning/STATE.md
165
165
 
166
- What's next?
167
- 1. Plan this phase: /gsd:plan-phase {N}
168
- 2. Add another phase: /gsd:add-phase <description>
169
- 3. Review roadmap: cat .planning/ROADMAP.md
170
- ```
171
-
172
- **If user selects option 1:**
173
- Invoke SlashCommand("/gsd:plan-phase {N}")
166
+ ## To Continue
174
167
 
175
- **If user selects option 2:**
176
- Invoke SlashCommand("/gsd:add-phase <description>")
168
+ Run `/clear`, then paste:
169
+ ```
170
+ /gsd:plan-phase {N}
171
+ ```
177
172
 
178
- Note: Commands are shown in options above so user can see what will run.
173
+ Other options:
174
+ - Add another phase: `/gsd:add-phase <description>`
175
+ - Review roadmap: `cat .planning/ROADMAP.md`
176
+ ```
179
177
  </step>
180
178
 
181
179
  </process>
@@ -183,7 +183,7 @@ Use AskUserQuestion with appropriate options based on findings:
183
183
  4. Update STATE.md deferred issues count
184
184
 
185
185
  **If inserting urgent phase:**
186
- - Invoke: `SlashCommand("/gsd:insert-phase [after-phase] Address urgent issues ISS-XXX, ISS-YYY")`
186
+ - Display the command for user to run after clearing: `/gsd:insert-phase [after-phase] Address urgent issues ISS-XXX, ISS-YYY`
187
187
 
188
188
  **If noting for phase planning:**
189
189
  - Update issue's "Suggested phase" field with specific phase number
@@ -117,15 +117,20 @@ Roadmap created:
117
117
  - State: .planning/STATE.md
118
118
  - [N] phases defined
119
119
 
120
- What's next?
121
- 1. Discuss Phase 1 context (/gsd:discuss-phase 1)
122
- 2. Plan Phase 1 in detail (/gsd:plan-phase 1)
123
- 3. Review/adjust phases
124
- 4. Done for now
120
+ ## To Continue
121
+
122
+ Run `/clear`, then paste one of:
123
+
124
+ **To discuss Phase 1 context first:**
125
+ ```
126
+ /gsd:discuss-phase 1
125
127
  ```
126
128
 
127
- If user selects "Discuss Phase 1 context" → invoke `/gsd:discuss-phase 1`
128
- If user selects "Plan Phase 1 in detail" → invoke `/gsd:plan-phase 1`
129
+ **To plan Phase 1 directly:**
130
+ ```
131
+ /gsd:plan-phase 1
132
+ ```
133
+ ```
129
134
  </step>
130
135
 
131
136
  </process>
@@ -182,16 +182,17 @@ Phase {decimal_phase} inserted after Phase {after_phase}:
182
182
  Roadmap updated: {roadmap-path}
183
183
  Project state updated: .planning/STATE.md
184
184
 
185
- What's next?
186
- 1. Plan this phase: /gsd:plan-phase {decimal_phase}
187
- 2. Review insertion impact: Check if Phase {next_integer} dependencies still make sense
188
- 3. Review roadmap: cat .planning/ROADMAP.md
189
- ```
185
+ ## To Continue
190
186
 
191
- **If user selects option 1:**
192
- Invoke SlashCommand("/gsd:plan-phase {decimal_phase}")
187
+ Run `/clear`, then paste:
188
+ ```
189
+ /gsd:plan-phase {decimal_phase}
190
+ ```
193
191
 
194
- Note: Command is shown in option 1 above so user can see what will run.
192
+ Other options:
193
+ - Review insertion impact: Check if Phase {next_integer} dependencies still make sense
194
+ - Review roadmap: `cat .planning/ROADMAP.md`
195
+ ```
195
196
  </step>
196
197
 
197
198
  </process>
@@ -24,22 +24,30 @@ Creates `.planning/` with PROJECT.md and config.json.
24
24
 
25
25
  <context>
26
26
  !`[ -d .planning ] && echo "PLANNING_EXISTS" || echo "NO_PLANNING"`
27
- !`[ -d .git ] && echo "GIT_EXISTS" || echo "NO_GIT"`
28
27
  </context>
29
28
 
30
29
  <process>
31
30
 
32
- <step name="setup" silent="true">
33
- Silent setup - execute before any user output:
34
-
35
- ```bash
36
- # Abort if project exists
37
- [ -d .planning ] && echo "Project already initialized. Use /gsd:progress" && exit 1
38
-
39
- # Initialize git
40
- [ -d .git ] || git init
41
- ```
42
-
31
+ <step name="setup">
32
+ **MANDATORY FIRST STEP Execute these checks before ANY user interaction:**
33
+
34
+ 1. **Abort if project exists:**
35
+ ```bash
36
+ [ -d .planning ] && echo "ERROR: Project already initialized. Use /gsd:progress" && exit 1
37
+ ```
38
+
39
+ 2. **Initialize git repo in THIS directory** (required even if inside a parent repo):
40
+ ```bash
41
+ # Check if THIS directory is already a git repo root (handles .git file for worktrees too)
42
+ if [ -d .git ] || [ -f .git ]; then
43
+ echo "Git repo exists in current directory"
44
+ else
45
+ git init
46
+ echo "Initialized new git repo"
47
+ fi
48
+ ```
49
+
50
+ **You MUST run both bash commands above using the Bash tool before proceeding.**
43
51
  </step>
44
52
 
45
53
  <step name="question">
@@ -139,17 +147,20 @@ Project initialized:
139
147
  - Project: .planning/PROJECT.md
140
148
  - Config: .planning/config.json (mode: [chosen mode])
141
149
 
142
- What's next?
150
+ ## To Continue
143
151
 
144
- 1. Research domain ecosystem (/gsd:research-project) - For niche/complex domains
145
- 2. Create roadmap (/gsd:create-roadmap) - Skip research, go straight to planning
146
- 3. Done for now
147
- ```
152
+ Run `/clear`, then paste one of:
148
153
 
149
- Note: Commands are shown in the options above so the user can see what to run in a fresh context.
154
+ **For niche/complex domains (recommended):**
155
+ ```
156
+ /gsd:research-project
157
+ ```
150
158
 
151
- **If user selects option 1:** invoke `/gsd:research-project`
152
- **If user selects option 2:** invoke `/gsd:create-roadmap`
159
+ **To skip research and go straight to planning:**
160
+ ```
161
+ /gsd:create-roadmap
162
+ ```
163
+ ```
153
164
  </step>
154
165
 
155
166
  </process>
@@ -107,12 +107,15 @@ Check if `{phase}-{plan}-PLAN.md` exists for that number.
107
107
 
108
108
  - Read its `<objective>` section
109
109
  - Show: "Ready to execute: [path] - [objective summary]"
110
- - Ask: "Execute? (y/n)"
111
- - **CRITICAL: If user responds "y", "yes", or affirmatively, immediately invoke:**
110
+ - Display:
111
+ ```
112
+ ## To Continue
113
+
114
+ Run `/clear`, then paste:
115
+ ```
116
+ /gsd:execute-plan [full-path-to-PLAN.md]
112
117
  ```
113
- SlashCommand("/gsd:execute-plan [full-path-to-PLAN.md]")
114
118
  ```
115
- Do NOT describe what you would do. INVOKE THE TOOL.
116
119
 
117
120
  **If PLAN.md does NOT exist:**
118
121
 
@@ -123,41 +126,45 @@ Check if `{phase}-{plan}-PLAN.md` exists for that number.
123
126
  **If CONTEXT.md exists:**
124
127
 
125
128
  - Display: "✓ Context gathered, ready to plan"
126
- - Ask: "Create this plan? (y/n)"
127
- - **CRITICAL: If user responds "y", "yes", or affirmatively, immediately invoke:**
129
+ - Display:
130
+ ```
131
+ ## To Continue
132
+
133
+ Run `/clear`, then paste:
134
+ ```
135
+ /gsd:plan-phase [phase-number]
128
136
  ```
129
- SlashCommand("/gsd:plan-phase [phase-number]")
130
137
  ```
131
- Do NOT describe what you would do. INVOKE THE TOOL.
132
138
 
133
139
  **If CONTEXT.md does NOT exist:**
134
140
 
135
- - Display options:
141
+ - Display:
136
142
  ```
137
- Options for Phase [N]:
138
- 1. See assumptions (/gsd:list-phase-assumptions [phase]) - What Claude thinks about this phase
139
- 2. Discuss context (/gsd:discuss-phase [phase]) - Gather your context through questions
140
- 3. Plan directly (/gsd:plan-phase [phase]) - Skip to planning
143
+ ## To Continue
144
+
145
+ Run `/clear`, then paste one of:
146
+
147
+ **See Claude's assumptions:**
141
148
  ```
142
- - Ask: "Which approach? (assumptions/discuss/plan)"
143
- - **If user responds "assumptions":**
149
+ /gsd:list-phase-assumptions [phase]
144
150
  ```
145
- SlashCommand("/gsd:list-phase-assumptions [phase-number]")
151
+
152
+ **Discuss context first:**
146
153
  ```
147
- - **If user responds "discuss":**
154
+ /gsd:discuss-phase [phase]
148
155
  ```
149
- SlashCommand("/gsd:discuss-phase [phase-number]")
156
+
157
+ **Plan directly:**
150
158
  ```
151
- - **If user responds "plan":**
159
+ /gsd:plan-phase [phase]
152
160
  ```
153
- SlashCommand("/gsd:plan-phase [phase-number]")
154
161
  ```
155
162
 
156
163
  **If all plans complete for current phase:**
157
164
 
158
165
  - Check if more phases exist in ROADMAP
159
- - If yes: Offer to plan next phase with `/gsd:plan-phase [next-phase]`
160
- - If no (milestone 100% complete): Offer to complete milestone
166
+ - If yes: Show `/gsd:plan-phase [next-phase]` command to paste
167
+ - If no (milestone 100% complete): Show `/gsd:complete-milestone` command to paste
161
168
  </step>
162
169
 
163
170
  <step name="edge_cases">
@@ -160,13 +160,16 @@ Key implementation context:
160
160
  Open questions remaining:
161
161
  - [Any questions research couldn't answer]
162
162
 
163
- What's next?
164
- 1. Create roadmap (/gsd:create-roadmap) - Incorporates research
165
- 2. Review research files
166
- 3. Done for now
163
+ ## To Continue
164
+
165
+ Run `/clear`, then paste:
166
+ ```
167
+ /gsd:create-roadmap
167
168
  ```
168
169
 
169
- If user selects "Create roadmap" → invoke `/gsd:create-roadmap`
170
+ Other options:
171
+ - Review research files before continuing
172
+ ```
170
173
  </step>
171
174
 
172
175
  </process>
@@ -424,20 +424,20 @@ Shipped:
424
424
  Summary: .planning/MILESTONES.md
425
425
  Tag: v[X.Y]
426
426
 
427
- Next steps:
427
+ ## To Continue
428
428
 
429
- 1. Discuss next milestone scope (/gsd:discuss-milestone)
430
- 2. Create next milestone directly (/gsd:new-milestone)
431
- 3. Done for now
429
+ Run `/clear`, then paste one of:
432
430
 
431
+ **To discuss next milestone scope:**
432
+ ```
433
+ /gsd:discuss-milestone
433
434
  ```
434
435
 
435
- Wait for user decision.
436
-
437
- If "1": Invoke SlashCommand("/gsd:discuss-milestone")
438
- If "2": Invoke SlashCommand("/gsd:new-milestone")
439
-
440
- Note: Commands are shown in options above so user can see what will run.
436
+ **To create next milestone directly:**
437
+ ```
438
+ /gsd:new-milestone
439
+ ```
440
+ ```
441
441
  </step>
442
442
 
443
443
  </process>
@@ -323,20 +323,23 @@ Milestone v[X.Y] [Name] created:
323
323
  - ROADMAP.md updated
324
324
  - STATE.md reset for new milestone
325
325
 
326
- What's next?
326
+ ## To Continue
327
327
 
328
- 1. Discuss Phase [N] context (/gsd:discuss-phase [N])
329
- 2. Plan Phase [N] directly (/gsd:plan-phase [N])
330
- 3. Review roadmap
331
- 4. Done for now
328
+ Run `/clear`, then paste one of:
332
329
 
330
+ **To discuss Phase [N] context first:**
331
+ ```
332
+ /gsd:discuss-phase [N]
333
333
  ```
334
334
 
335
- **If user selects option 1:**
336
- Invoke SlashCommand("/gsd:discuss-phase [N]")
335
+ **To plan Phase [N] directly:**
336
+ ```
337
+ /gsd:plan-phase [N]
338
+ ```
337
339
 
338
- **If user selects option 2:**
339
- Invoke SlashCommand("/gsd:plan-phase [N]")
340
+ Other options:
341
+ - Review roadmap before continuing
342
+ ```
340
343
  </step>
341
344
 
342
345
  </process>
@@ -487,20 +487,20 @@ Project initialized:
487
487
  - State: .planning/STATE.md
488
488
  - Committed as: docs: initialize [project] ([N] phases)
489
489
 
490
- What's next?
490
+ ## To Continue
491
491
 
492
- 1. Discuss Phase 1 context (/gsd:discuss-phase 1)
493
- 2. Plan Phase 1 in detail (/gsd:plan-phase 1)
494
- 3. Review/adjust phases
495
- 4. Done for now
492
+ Run `/clear`, then paste one of:
496
493
 
494
+ **To discuss Phase 1 context first:**
495
+ ```
496
+ /gsd:discuss-phase 1
497
497
  ```
498
498
 
499
- **If user selects "Discuss Phase 1 context":**
500
- Exit and invoke SlashCommand("/gsd:discuss-phase 1")
501
-
502
- **If user selects "Plan Phase 1 in detail":**
503
- Exit and invoke SlashCommand("/gsd:plan-phase 1")
499
+ **To plan Phase 1 directly:**
500
+ ```
501
+ /gsd:plan-phase 1
502
+ ```
503
+ ```
504
504
  </step>
505
505
 
506
506
  </process>
@@ -137,9 +137,14 @@ Milestone scope defined:
137
137
  **Estimated phases:** [N]
138
138
 
139
139
  Ready to create the milestone structure.
140
- ```
141
140
 
142
- **Invoke:** SlashCommand("/gsd:new-milestone")
141
+ ## To Continue
142
+
143
+ Run `/clear`, then paste:
144
+ ```
145
+ /gsd:new-milestone
146
+ ```
147
+ ```
143
148
 
144
149
  Pass context forward by summarizing:
145
150
  - Features to build (the substance)
@@ -194,11 +194,22 @@ Created: .planning/phases/${PHASE}-${SLUG}/${PHASE}-CONTEXT.md
194
194
  ## Boundaries
195
195
  [What's out of scope]
196
196
 
197
- What's next?
198
- 1. Research this phase (/gsd:research-phase ${PHASE}) - Investigate codebase, identify patterns and risks
199
- 2. Plan this phase (/gsd:plan-phase ${PHASE}) - Skip research, go straight to planning
200
- 3. Review/edit CONTEXT.md - Make adjustments
201
- 4. Done for now
197
+ ## To Continue
198
+
199
+ Run `/clear`, then paste one of:
200
+
201
+ **To research this phase first:**
202
+ ```
203
+ /gsd:research-phase ${PHASE}
204
+ ```
205
+
206
+ **To plan this phase directly:**
207
+ ```
208
+ /gsd:plan-phase ${PHASE}
209
+ ```
210
+
211
+ Other options:
212
+ - Review/edit CONTEXT.md before continuing
202
213
  ```
203
214
 
204
215
  </step>
@@ -1210,13 +1210,18 @@ Summary: .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md
1210
1210
 
1211
1211
  [X] of [Y] plans complete for Phase Z.
1212
1212
 
1213
- What's next?
1214
- 1. Execute next plan (/gsd:execute-plan .planning/phases/XX-name/{phase}-{next-plan}-PLAN.md)
1215
- 2. Review what was built
1216
- 3. Done for now
1213
+ ## To Continue
1214
+
1215
+ Run `/clear`, then paste:
1216
+ ```
1217
+ /gsd:execute-plan .planning/phases/XX-name/{phase}-{next-plan}-PLAN.md
1218
+ ```
1219
+
1220
+ Other options:
1221
+ - Review what was built before continuing
1217
1222
  ```
1218
1223
 
1219
- Wait for user selection.
1224
+ Wait for user to clear and run next command.
1220
1225
  </if>
1221
1226
 
1222
1227
  **If phase complete (last plan done):**
@@ -1252,11 +1257,16 @@ All [N] phases complete!
1252
1257
  This milestone is 100% done.
1253
1258
  ════════════════════════════════════════
1254
1259
 
1255
- What's next?
1256
- 1. Complete milestone (/gsd:complete-milestone) - Archive and start fresh
1257
- 2. Add another phase (/gsd:add-phase) - Extend this milestone
1258
- 3. Review accomplishments - See what was built
1259
- 4. Done for now
1260
+ ## To Continue
1261
+
1262
+ Run `/clear`, then paste:
1263
+ ```
1264
+ /gsd:complete-milestone
1265
+ ```
1266
+
1267
+ Other options:
1268
+ - Add another phase: `/gsd:add-phase <description>`
1269
+ - Review accomplishments before archiving
1260
1270
  ```
1261
1271
 
1262
1272
  **If phase complete but more phases remain:**
@@ -1267,11 +1277,22 @@ Summary: .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md
1267
1277
 
1268
1278
  Phase [Z]: [Name] COMPLETE - all [Y] plans finished.
1269
1279
 
1270
- What's next?
1271
- 1. Discuss Phase [X+1] context (/gsd:discuss-phase [X+1])
1272
- 2. Plan Phase [X+1] in detail (/gsd:plan-phase [X+1])
1273
- 3. Review phase accomplishments
1274
- 4. Done for now
1280
+ ## To Continue
1281
+
1282
+ Run `/clear`, then paste one of:
1283
+
1284
+ **To discuss Phase [X+1] context first:**
1285
+ ```
1286
+ /gsd:discuss-phase [X+1]
1287
+ ```
1288
+
1289
+ **To plan Phase [X+1] directly:**
1290
+ ```
1291
+ /gsd:plan-phase [X+1]
1292
+ ```
1293
+
1294
+ Other options:
1295
+ - Review phase accomplishments before continuing
1275
1296
  ```
1276
1297
 
1277
1298
  </step>
@@ -717,18 +717,16 @@ After completion, create `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
717
717
  Phase plan created: .planning/phases/XX-name/{phase}-01-PLAN.md
718
718
  [X] tasks defined.
719
719
 
720
- What's next?
721
-
722
- 1. Execute plan (/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md)
723
- 2. Review/adjust tasks
724
- 3. Done for now
720
+ ## To Continue
725
721
 
722
+ Run `/clear`, then paste:
723
+ ```
724
+ /gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md
726
725
  ```
727
726
 
728
- **If user selects "Execute plan":**
729
- Exit skill and invoke SlashCommand("/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md")
730
-
731
- Note: Command is shown in the options above so user can see what will run.
727
+ Other options:
728
+ - Review/adjust tasks before executing
729
+ ```
732
730
 
733
731
  **If multiple plans:**
734
732
  ```
@@ -741,18 +739,16 @@ Phase plans created:
741
739
 
742
740
  Total: [X] tasks across [Y] focused plans.
743
741
 
744
- What's next?
745
-
746
- 1. Execute first plan (/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md)
747
- 2. Review/adjust tasks
748
- 3. Done for now
742
+ ## To Continue
749
743
 
744
+ Run `/clear`, then paste:
745
+ ```
746
+ /gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md
750
747
  ```
751
748
 
752
- **If user selects "Execute first plan":**
753
- Exit skill and invoke SlashCommand("/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md")
754
-
755
- Note: Command is shown in the options above so user can see what will run.
749
+ Other options:
750
+ - Review/adjust tasks before executing
751
+ ```
756
752
  </step>
757
753
 
758
754
  </process>
@@ -174,14 +174,28 @@ Wait for user selection.
174
174
  <step name="route_to_workflow">
175
175
  Based on user selection, route to appropriate workflow:
176
176
 
177
- - **Execute plan** → EXIT and invoke SlashCommand("/gsd:execute-plan [path]")
178
- - **Plan phase** → EXIT and invoke SlashCommand("/gsd:plan-phase [phase-number]")
177
+ - **Execute plan** → Show command for user to run after clearing:
178
+ ```
179
+ ## To Continue
180
+
181
+ Run `/clear`, then paste:
182
+ ```
183
+ /gsd:execute-plan [path]
184
+ ```
185
+ ```
186
+ - **Plan phase** → Show command for user to run after clearing:
187
+ ```
188
+ ## To Continue
189
+
190
+ Run `/clear`, then paste:
191
+ ```
192
+ /gsd:plan-phase [phase-number]
193
+ ```
194
+ ```
179
195
  - **Transition** → ./transition.md
180
196
  - **Review issues** → Read ISSUES.md, present summary
181
197
  - **Review alignment** → Read PROJECT.md, compare to current state
182
198
  - **Something else** → Ask what they need
183
-
184
- Note: Commands are shown in the presented options so user can see what will run.
185
199
  </step>
186
200
 
187
201
  <step name="update_session">
@@ -393,14 +393,23 @@ Phase [X] marked complete.
393
393
 
394
394
  Next: Phase [X+1] - [Name]
395
395
 
396
- What would you like to do?
397
- 1. Discuss Phase [X+1] context (/gsd:discuss-phase [X+1])
398
- 2. Plan Phase [X+1] in detail (/gsd:plan-phase [X+1])
399
- 3. Review roadmap
400
- 4. Take a break (done for now)
396
+ ## To Continue
397
+
398
+ Run `/clear`, then paste one of:
399
+
400
+ **To discuss Phase [X+1] context first:**
401
+ ```
402
+ /gsd:discuss-phase [X+1]
403
+ ```
404
+
405
+ **To plan Phase [X+1] directly:**
406
+ ```
407
+ /gsd:plan-phase [X+1]
401
408
  ```
402
409
 
403
- Wait for user selection.
410
+ Other options:
411
+ - Review roadmap before continuing
412
+ ```
404
413
  </if>
405
414
 
406
415
  **If no next phase (milestone 100% complete):**
@@ -423,13 +432,16 @@ Phase [X] marked complete.
423
432
 
424
433
  🎉 Milestone [version] is 100% complete - all phases finished!
425
434
 
426
- What would you like to do?
427
- 1. Complete milestone and archive (/gsd:complete-milestone [version])
428
- 2. Review accomplishments
429
- 3. Take a break (done for now)
435
+ ## To Continue
436
+
437
+ Run `/clear`, then paste:
438
+ ```
439
+ /gsd:complete-milestone [version]
430
440
  ```
431
441
 
432
- Wait for user selection.
442
+ Other options:
443
+ - Review accomplishments before archiving
444
+ ```
433
445
  </if>
434
446
 
435
447
  </step>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "get-shit-done-cc",
3
- "version": "1.2.8",
3
+ "version": "1.2.10",
4
4
  "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.",
5
5
  "bin": {
6
6
  "get-shit-done-cc": "bin/install.js"