get-shit-done-cc 1.4.22 → 1.4.23
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.
- package/README.md +0 -2
- package/commands/gsd/_archive/execute-phase.md +0 -1
- package/commands/gsd/execute-phase.md +0 -1
- package/commands/gsd/help.md +0 -14
- package/commands/gsd/progress.md +3 -3
- package/get-shit-done/templates/UAT.md +0 -12
- package/get-shit-done/templates/state.md +1 -16
- package/get-shit-done/templates/summary.md +2 -17
- package/get-shit-done/workflows/_archive/execute-phase.md +0 -1
- package/get-shit-done/workflows/complete-milestone.md +0 -1
- package/get-shit-done/workflows/create-milestone.md +1 -1
- package/get-shit-done/workflows/create-roadmap.md +2 -2
- package/get-shit-done/workflows/discuss-milestone.md +3 -3
- package/get-shit-done/workflows/execute-phase.md +0 -1
- package/get-shit-done/workflows/execute-plan.md +4 -92
- package/get-shit-done/workflows/plan-phase.md +7 -7
- package/get-shit-done/workflows/resume-project.md +7 -7
- package/get-shit-done/workflows/transition.md +0 -16
- package/package.json +1 -1
- package/commands/gsd/consider-issues.md +0 -202
- package/get-shit-done/templates/issues.md +0 -32
package/README.md
CHANGED
|
@@ -251,7 +251,6 @@ GSD handles it for you:
|
|
|
251
251
|
| `STATE.md` | Decisions, blockers, position — memory across sessions |
|
|
252
252
|
| `PLAN.md` | Atomic task with XML structure, verification steps |
|
|
253
253
|
| `SUMMARY.md` | What happened, what changed, committed to history |
|
|
254
|
-
| `ISSUES.md` | Deferred enhancements tracked across sessions |
|
|
255
254
|
| `todos/` | Captured ideas and tasks for later work |
|
|
256
255
|
|
|
257
256
|
Size limits based on where Claude's quality degrades. Stay under, get consistent excellence.
|
|
@@ -342,7 +341,6 @@ You're never locked in. The system adapts.
|
|
|
342
341
|
| `/gsd:list-phase-assumptions [N]` | See what Claude thinks before you correct it |
|
|
343
342
|
| `/gsd:pause-work` | Create handoff file when stopping mid-phase |
|
|
344
343
|
| `/gsd:resume-work` | Restore from last session |
|
|
345
|
-
| `/gsd:consider-issues` | Review deferred issues, close resolved, identify urgent |
|
|
346
344
|
| `/gsd:add-todo [desc]` | Capture idea or task from conversation for later |
|
|
347
345
|
| `/gsd:check-todos [area]` | List pending todos, select one to work on |
|
|
348
346
|
| `/gsd:debug [desc]` | Systematic debugging with persistent state across `/clear` |
|
|
@@ -81,7 +81,6 @@ During execution, handle discoveries automatically:
|
|
|
81
81
|
2. **Auto-add critical** - Security/correctness gaps, add and document
|
|
82
82
|
3. **Auto-fix blockers** - Can't proceed without fix, do it and document
|
|
83
83
|
4. **Ask about architectural** - Major structural changes, stop and ask user
|
|
84
|
-
5. **Log enhancements** - Nice-to-haves, log to ISSUES.md, continue
|
|
85
84
|
|
|
86
85
|
Only rule 4 requires user intervention.
|
|
87
86
|
</deviation_rules>
|
|
@@ -99,7 +99,6 @@ During execution, handle discoveries automatically:
|
|
|
99
99
|
2. **Auto-add critical** - Security/correctness gaps, add and document
|
|
100
100
|
3. **Auto-fix blockers** - Can't proceed without fix, do it and document
|
|
101
101
|
4. **Ask about architectural** - Major structural changes, stop and ask user
|
|
102
|
-
5. **Log enhancements** - Nice-to-haves, log to ISSUES.md, continue
|
|
103
102
|
|
|
104
103
|
Only rule 4 requires user intervention.
|
|
105
104
|
</deviation_rules>
|
package/commands/gsd/help.md
CHANGED
|
@@ -235,19 +235,6 @@ Create context handoff when pausing work mid-phase.
|
|
|
235
235
|
|
|
236
236
|
Usage: `/gsd:pause-work`
|
|
237
237
|
|
|
238
|
-
### Issue Management
|
|
239
|
-
|
|
240
|
-
**`/gsd:consider-issues`**
|
|
241
|
-
Review deferred issues with codebase context.
|
|
242
|
-
|
|
243
|
-
- Analyzes all open issues against current codebase state
|
|
244
|
-
- Identifies resolved issues (can close)
|
|
245
|
-
- Identifies urgent issues (should address now)
|
|
246
|
-
- Identifies natural fits for upcoming phases
|
|
247
|
-
- Offers batch actions (close, insert phase, note for planning)
|
|
248
|
-
|
|
249
|
-
Usage: `/gsd:consider-issues`
|
|
250
|
-
|
|
251
238
|
### Debugging
|
|
252
239
|
|
|
253
240
|
**`/gsd:debug [issue description]`**
|
|
@@ -300,7 +287,6 @@ Show this command reference.
|
|
|
300
287
|
├── PROJECT.md # Project vision
|
|
301
288
|
├── ROADMAP.md # Current phase breakdown
|
|
302
289
|
├── STATE.md # Project memory & context
|
|
303
|
-
├── ISSUES.md # Deferred enhancements (created when needed)
|
|
304
290
|
├── config.json # Workflow mode & gates
|
|
305
291
|
├── todos/ # Captured ideas and tasks
|
|
306
292
|
│ ├── pending/ # Todos waiting to be worked on
|
package/commands/gsd/progress.md
CHANGED
|
@@ -55,7 +55,7 @@ If missing STATE.md or ROADMAP.md: inform what's missing, suggest running `/gsd:
|
|
|
55
55
|
|
|
56
56
|
- From STATE.md: current phase, plan number, status
|
|
57
57
|
- Calculate: total plans, completed plans, remaining plans
|
|
58
|
-
- Note any blockers
|
|
58
|
+
- Note any blockers or concerns
|
|
59
59
|
- Check for CONTEXT.md: For phases without PLAN.md files, check if `{phase}-CONTEXT.md` exists in phase directory
|
|
60
60
|
- Count pending todos: `ls .planning/todos/pending/*.md 2>/dev/null | wc -l`
|
|
61
61
|
- Check for active debug sessions: `ls .planning/debug/*.md 2>/dev/null | grep -v resolved | wc -l`
|
|
@@ -82,8 +82,8 @@ CONTEXT: [✓ if CONTEXT.md exists | - if not]
|
|
|
82
82
|
- [decision 1 from STATE.md]
|
|
83
83
|
- [decision 2]
|
|
84
84
|
|
|
85
|
-
##
|
|
86
|
-
- [any
|
|
85
|
+
## Blockers/Concerns
|
|
86
|
+
- [any blockers or concerns from STATE.md]
|
|
87
87
|
|
|
88
88
|
## Pending Todos
|
|
89
89
|
- [count] pending — /gsd:check-todos to review
|
|
@@ -243,15 +243,3 @@ skipped: 0
|
|
|
243
243
|
root_cause: useEffect in CommentList.tsx missing commentCount dependency
|
|
244
244
|
```
|
|
245
245
|
</good_example>
|
|
246
|
-
|
|
247
|
-
<difference_from_issues_md>
|
|
248
|
-
|
|
249
|
-
| UAT.md | ISSUES.md (global) |
|
|
250
|
-
|--------|-------------------|
|
|
251
|
-
| Created by /gsd:verify-work | Created by deviation rule 5 during execution |
|
|
252
|
-
| Tracks test session state | Tracks deferred enhancements |
|
|
253
|
-
| Phase-scoped, one per phase | Global, one per project |
|
|
254
|
-
| Feeds into /gsd:plan-fix | Feeds into /gsd:consider-issues |
|
|
255
|
-
| Contains pass/fail/skip results | Contains only deferred items |
|
|
256
|
-
|
|
257
|
-
</difference_from_issues_md>
|
|
@@ -54,12 +54,6 @@ Recent decisions affecting current work:
|
|
|
54
54
|
- [Phase X]: [Decision summary]
|
|
55
55
|
- [Phase Y]: [Decision summary]
|
|
56
56
|
|
|
57
|
-
### Deferred Issues
|
|
58
|
-
|
|
59
|
-
[From ISSUES.md — list open items with phase of origin]
|
|
60
|
-
|
|
61
|
-
None yet.
|
|
62
|
-
|
|
63
57
|
### Pending Todos
|
|
64
58
|
|
|
65
59
|
[From .planning/todos/pending/ — ideas captured during sessions]
|
|
@@ -110,7 +104,6 @@ STATE.md is the project's short-term memory spanning all phases and sessions.
|
|
|
110
104
|
- execute: After SUMMARY.md created
|
|
111
105
|
- Update position (phase, plan, status)
|
|
112
106
|
- Note new decisions (detail in PROJECT.md)
|
|
113
|
-
- Update deferred issues list
|
|
114
107
|
- Add blockers/concerns
|
|
115
108
|
- transition: After phase marked complete
|
|
116
109
|
- Update progress bar
|
|
@@ -152,12 +145,6 @@ Updated after each plan completion.
|
|
|
152
145
|
|
|
153
146
|
**Decisions:** Reference to PROJECT.md Key Decisions table, plus recent decisions summary for quick access. Full decision log lives in PROJECT.md.
|
|
154
147
|
|
|
155
|
-
**Deferred Issues:** Open items from ISSUES.md
|
|
156
|
-
- Brief description with ISS-XXX number
|
|
157
|
-
- Phase where discovered
|
|
158
|
-
- Effort estimate if known
|
|
159
|
-
- Helps phase planning identify what to address
|
|
160
|
-
|
|
161
148
|
**Pending Todos:** Ideas captured via /gsd:add-todo
|
|
162
149
|
- Count of pending todos
|
|
163
150
|
- Reference to .planning/todos/pending/
|
|
@@ -182,7 +169,6 @@ Keep STATE.md under 100 lines.
|
|
|
182
169
|
|
|
183
170
|
It's a DIGEST, not an archive. If accumulated context grows too large:
|
|
184
171
|
- Keep only 3-5 recent decisions in summary (full log in PROJECT.md)
|
|
185
|
-
- Reference ISSUES.md instead of listing all: "12 open issues — see ISSUES.md"
|
|
186
172
|
- Keep only active blockers, remove resolved ones
|
|
187
173
|
|
|
188
174
|
The goal is "read once, know where we are" — if it's too long, that fails.
|
|
@@ -208,14 +194,13 @@ The goal is "read once, know where we are" — if it's too long, that fails.
|
|
|
208
194
|
**Size management:**
|
|
209
195
|
- Keep under 100 lines total
|
|
210
196
|
- Recent decisions only in STATE.md (full log in PROJECT.md)
|
|
211
|
-
- Reference ISSUES.md instead of listing all issues
|
|
212
197
|
- Keep only active blockers
|
|
213
198
|
|
|
214
199
|
**Sections:**
|
|
215
200
|
- Project Reference: Pointer to PROJECT.md with core value
|
|
216
201
|
- Current Position: Where we are now (phase, plan, status)
|
|
217
202
|
- Performance Metrics: Velocity tracking
|
|
218
|
-
- Accumulated Context: Recent decisions,
|
|
203
|
+
- Accumulated Context: Recent decisions, pending todos, blockers
|
|
219
204
|
- Session Continuity: Resume information
|
|
220
205
|
|
|
221
206
|
</guidelines>
|
|
@@ -38,8 +38,6 @@ patterns-established:
|
|
|
38
38
|
- "Pattern 1: description"
|
|
39
39
|
- "Pattern 2: description"
|
|
40
40
|
|
|
41
|
-
issues-created: [ISS-XXX, ISS-YYY] # From ISSUES.md if any
|
|
42
|
-
|
|
43
41
|
# Metrics
|
|
44
42
|
duration: Xmin
|
|
45
43
|
completed: YYYY-MM-DD
|
|
@@ -99,15 +97,9 @@ _Note: TDD tasks may have multiple commits (test → feat → refactor)_
|
|
|
99
97
|
|
|
100
98
|
[... repeat for each auto-fix ...]
|
|
101
99
|
|
|
102
|
-
### Deferred Enhancements
|
|
103
|
-
|
|
104
|
-
Logged to .planning/ISSUES.md for future consideration:
|
|
105
|
-
- ISS-XXX: [Brief description] (discovered in Task [N])
|
|
106
|
-
- ISS-XXX: [Brief description] (discovered in Task [N])
|
|
107
|
-
|
|
108
100
|
---
|
|
109
101
|
|
|
110
|
-
**Total deviations:** [N] auto-fixed ([breakdown by rule])
|
|
102
|
+
**Total deviations:** [N] auto-fixed ([breakdown by rule])
|
|
111
103
|
**Impact on plan:** [Brief assessment - e.g., "All auto-fixes necessary for correctness/security. No scope creep."]
|
|
112
104
|
|
|
113
105
|
## Issues Encountered
|
|
@@ -211,15 +203,9 @@ The one-liner should tell someone what actually shipped.
|
|
|
211
203
|
- **Verification:** Import succeeds, build passes
|
|
212
204
|
- **Committed in:** def456g (Task 4 commit)
|
|
213
205
|
|
|
214
|
-
### Deferred Enhancements
|
|
215
|
-
|
|
216
|
-
Logged to .planning/ISSUES.md for future consideration:
|
|
217
|
-
- ISS-001: Add rate limiting to login endpoint (discovered in Task 2)
|
|
218
|
-
- ISS-002: Improve token refresh UX with auto-retry on 401 (discovered in Task 5)
|
|
219
|
-
|
|
220
206
|
---
|
|
221
207
|
|
|
222
|
-
**Total deviations:** 2 auto-fixed (1 missing critical, 1 blocking)
|
|
208
|
+
**Total deviations:** 2 auto-fixed (1 missing critical, 1 blocking)
|
|
223
209
|
**Impact on plan:** Both auto-fixes essential for security and functionality. No scope creep.
|
|
224
210
|
|
|
225
211
|
## Issues Encountered
|
|
@@ -259,7 +245,6 @@ Logged to .planning/ISSUES.md for future consideration:
|
|
|
259
245
|
- Documents unplanned work handled via deviation rules
|
|
260
246
|
- Separate from "Issues Encountered" (which is planned work problems)
|
|
261
247
|
- Auto-fixed issues: What was wrong, how fixed, verification
|
|
262
|
-
- Deferred enhancements: Logged to ISSUES.md with ISS-XXX numbers
|
|
263
248
|
|
|
264
249
|
**Decisions section:**
|
|
265
250
|
- Key decisions made during execution
|
|
@@ -34,7 +34,6 @@ cat .planning/STATE.md 2>/dev/null
|
|
|
34
34
|
|
|
35
35
|
- Current position (phase, plan, status)
|
|
36
36
|
- Accumulated decisions (constraints on this execution)
|
|
37
|
-
- Deferred issues (context for deviations)
|
|
38
37
|
- Blockers/concerns (things to watch for)
|
|
39
38
|
|
|
40
39
|
**If file missing but .planning/ exists:**
|
|
@@ -437,7 +437,6 @@ Extract completed milestone details and create archive file.
|
|
|
437
437
|
- {{PHASES_SECTION}} — Full phase details extracted
|
|
438
438
|
- {{DECISIONS_FROM_PROJECT}} — Key decisions from PROJECT.md
|
|
439
439
|
- {{ISSUES_RESOLVED_DURING_MILESTONE}} — From summaries
|
|
440
|
-
- {{ISSUES_DEFERRED_TO_LATER}} — From ISSUES.md
|
|
441
440
|
|
|
442
441
|
6. Write filled template to `.planning/milestones/v[X.Y]-ROADMAP.md`
|
|
443
442
|
|
|
@@ -29,7 +29,7 @@ Extract:
|
|
|
29
29
|
|
|
30
30
|
- Previous milestone version (e.g., v1.0)
|
|
31
31
|
- Last phase number used
|
|
32
|
-
-
|
|
32
|
+
- Pending todos from STATE.md
|
|
33
33
|
- Project context from PROJECT.md (What This Is, Core Value)
|
|
34
34
|
|
|
35
35
|
**Check for milestone context from discuss-milestone:**
|
|
@@ -130,7 +130,7 @@ Use decimal phases (2.1, 2.2) for urgent insertions:
|
|
|
130
130
|
- Urgent work that can't wait for next milestone
|
|
131
131
|
- Critical bugs blocking progress
|
|
132
132
|
- Security patches needing immediate attention
|
|
133
|
-
- NOT for scope creep or "nice to haves" (
|
|
133
|
+
- NOT for scope creep or "nice to haves" (capture with /gsd:add-todo instead)
|
|
134
134
|
|
|
135
135
|
**Phase execution order:**
|
|
136
136
|
Numeric sort: 1 → 1.1 → 1.2 → 2 → 2.1 → 3
|
|
@@ -368,7 +368,7 @@ Recent decisions affecting current work:
|
|
|
368
368
|
|
|
369
369
|
(None yet)
|
|
370
370
|
|
|
371
|
-
###
|
|
371
|
+
### Pending Todos
|
|
372
372
|
|
|
373
373
|
None yet.
|
|
374
374
|
|
|
@@ -56,7 +56,7 @@ The primary question is: **What do you want to build/add/fix?**
|
|
|
56
56
|
Everything else (scope, priority, constraints) is secondary and derived from features.
|
|
57
57
|
|
|
58
58
|
Check for inputs:
|
|
59
|
-
-
|
|
59
|
+
- Pending todos from STATE.md (potential features)
|
|
60
60
|
- Known gaps or pain points from usage
|
|
61
61
|
- User's ideas for what's next
|
|
62
62
|
|
|
@@ -65,7 +65,7 @@ Check for inputs:
|
|
|
65
65
|
Use AskUserQuestion:
|
|
66
66
|
- header: "Next"
|
|
67
67
|
- question: "What do you want to add, improve, or fix in this milestone?"
|
|
68
|
-
- options: [
|
|
68
|
+
- options: [Pending todos from STATE.md if any] + ["New features", "Improvements to existing", "Bug fixes", "Let me describe"]
|
|
69
69
|
|
|
70
70
|
**2. Explore features:**
|
|
71
71
|
|
|
@@ -84,7 +84,7 @@ If they described a general direction:
|
|
|
84
84
|
If they're not sure:
|
|
85
85
|
- header: "Starting Points"
|
|
86
86
|
- question: "What's been frustrating or missing?"
|
|
87
|
-
- options: [
|
|
87
|
+
- options: [Pending todos from STATE.md + pain point categories + "Let me think about it"]
|
|
88
88
|
|
|
89
89
|
**3. Prioritize:**
|
|
90
90
|
|
|
@@ -22,7 +22,6 @@ cat .planning/STATE.md 2>/dev/null
|
|
|
22
22
|
**If file exists:** Parse and internalize:
|
|
23
23
|
- Current position (phase, plan, status)
|
|
24
24
|
- Accumulated decisions (constraints on this execution)
|
|
25
|
-
- Deferred issues (context for deviations)
|
|
26
25
|
- Blockers/concerns (things to watch for)
|
|
27
26
|
|
|
28
27
|
**If file missing but .planning/ exists:**
|
|
@@ -19,7 +19,6 @@ cat .planning/STATE.md 2>/dev/null
|
|
|
19
19
|
|
|
20
20
|
- Current position (phase, plan, status)
|
|
21
21
|
- Accumulated decisions (constraints on this execution)
|
|
22
|
-
- Deferred issues (context for deviations)
|
|
23
22
|
- Blockers/concerns (things to watch for)
|
|
24
23
|
- Brief alignment status
|
|
25
24
|
|
|
@@ -804,60 +803,28 @@ Proceed with proposed change? (yes / different approach / defer)
|
|
|
804
803
|
3. WAIT for user response
|
|
805
804
|
4. If approved: implement, track as `[Rule 4 - Architectural] [description]`
|
|
806
805
|
5. If different approach: discuss and implement
|
|
807
|
-
6. If deferred:
|
|
806
|
+
6. If deferred: note in Summary and continue without change
|
|
808
807
|
|
|
809
808
|
**User decision required.** These changes affect system design.
|
|
810
809
|
|
|
811
810
|
---
|
|
812
811
|
|
|
813
|
-
**RULE 5: Log non-critical enhancements**
|
|
814
|
-
|
|
815
|
-
**Trigger:** Improvement that would enhance code but isn't essential now
|
|
816
|
-
|
|
817
|
-
**Action:** Add to .planning/ISSUES.md automatically, continue task
|
|
818
|
-
|
|
819
|
-
**Examples:**
|
|
820
|
-
|
|
821
|
-
- Performance optimization (works correctly, just slower than ideal)
|
|
822
|
-
- Code refactoring (works, but could be cleaner/DRY-er)
|
|
823
|
-
- Better naming (works, but variables could be clearer)
|
|
824
|
-
- Organizational improvements (works, but file structure could be better)
|
|
825
|
-
- Nice-to-have UX improvements (works, but could be smoother)
|
|
826
|
-
- Additional test coverage beyond basics (basics exist, could be more thorough)
|
|
827
|
-
- Documentation improvements (code works, docs could be better)
|
|
828
|
-
- Accessibility enhancements beyond minimum
|
|
829
|
-
|
|
830
|
-
**Process:**
|
|
831
|
-
|
|
832
|
-
1. Create .planning/ISSUES.md if doesn't exist (use `~/.claude/get-shit-done/templates/issues.md`)
|
|
833
|
-
2. Add entry with ISS-XXX number (auto-increment)
|
|
834
|
-
3. Brief notification: `📋 Logged enhancement: [brief] (ISS-XXX)`
|
|
835
|
-
4. Continue task without implementing
|
|
836
|
-
|
|
837
|
-
**No user permission needed.** Logging for future consideration.
|
|
838
|
-
|
|
839
|
-
---
|
|
840
|
-
|
|
841
812
|
**RULE PRIORITY (when multiple could apply):**
|
|
842
813
|
|
|
843
814
|
1. **If Rule 4 applies** → STOP and ask (architectural decision)
|
|
844
815
|
2. **If Rules 1-3 apply** → Fix automatically, track for Summary
|
|
845
|
-
3. **If
|
|
846
|
-
4. **If genuinely unsure which rule** → Apply Rule 4 (ask user)
|
|
816
|
+
3. **If genuinely unsure which rule** → Apply Rule 4 (ask user)
|
|
847
817
|
|
|
848
818
|
**Edge case guidance:**
|
|
849
819
|
|
|
850
820
|
- "This validation is missing" → Rule 2 (critical for security)
|
|
851
|
-
- "This validation could be better" → Rule 5 (enhancement)
|
|
852
821
|
- "This crashes on null" → Rule 1 (bug)
|
|
853
|
-
- "This could be faster" → Rule 5 (enhancement) UNLESS actually timing out → Rule 2 (critical)
|
|
854
822
|
- "Need to add table" → Rule 4 (architectural)
|
|
855
823
|
- "Need to add column" → Rule 1 or 2 (depends: fixing bug or adding critical field)
|
|
856
824
|
|
|
857
825
|
**When in doubt:** Ask yourself "Does this affect correctness, security, or ability to complete task?"
|
|
858
826
|
|
|
859
827
|
- YES → Rules 1-3 (fix automatically)
|
|
860
|
-
- NO → Rule 5 (log it)
|
|
861
828
|
- MAYBE → Rule 4 (ask user)
|
|
862
829
|
|
|
863
830
|
</deviation_rules>
|
|
@@ -901,16 +868,9 @@ None - plan executed exactly as written.
|
|
|
901
868
|
- **Verification:** Expired token test passes - properly rejects with 401
|
|
902
869
|
- **Commit:** def456g
|
|
903
870
|
|
|
904
|
-
### Deferred Enhancements
|
|
905
|
-
|
|
906
|
-
Logged to .planning/ISSUES.md for future consideration:
|
|
907
|
-
|
|
908
|
-
- ISS-001: Refactor UserService into smaller modules (discovered in Task 3)
|
|
909
|
-
- ISS-002: Add connection pooling for Redis (discovered in Task 6)
|
|
910
|
-
|
|
911
871
|
---
|
|
912
872
|
|
|
913
|
-
**Total deviations:** 4 auto-fixed (1 bug, 1 missing critical, 1 blocking, 1 architectural with approval)
|
|
873
|
+
**Total deviations:** 4 auto-fixed (1 bug, 1 missing critical, 1 blocking, 1 architectural with approval)
|
|
914
874
|
**Impact on plan:** All auto-fixes necessary for correctness/security/performance. No scope creep.
|
|
915
875
|
```
|
|
916
876
|
|
|
@@ -1307,10 +1267,7 @@ Before writing summary content, populate frontmatter fields from execution conte
|
|
|
1307
1267
|
5. **Decisions:**
|
|
1308
1268
|
- key-decisions: Extract from "Decisions Made" section
|
|
1309
1269
|
|
|
1310
|
-
6. **
|
|
1311
|
-
- issues-created: Check if ISSUES.md was updated during execution
|
|
1312
|
-
|
|
1313
|
-
7. **Metrics:**
|
|
1270
|
+
6. **Metrics:**
|
|
1314
1271
|
- duration: From $DURATION variable
|
|
1315
1272
|
- completed: From $PLAN_END_TIME (date only, format YYYY-MM-DD)
|
|
1316
1273
|
|
|
@@ -1405,12 +1362,6 @@ Extract decisions, issues, and concerns from SUMMARY.md into STATE.md accumulate
|
|
|
1405
1362
|
- Add each decision to STATE.md Decisions table
|
|
1406
1363
|
- Format: `| [phase number] | [decision summary] | [rationale] |`
|
|
1407
1364
|
|
|
1408
|
-
**Deferred Issues:**
|
|
1409
|
-
|
|
1410
|
-
- Read SUMMARY.md to check if new issues were logged to ISSUES.md
|
|
1411
|
-
- If new ISS-XXX entries created:
|
|
1412
|
-
- Update STATE.md "Deferred Issues" section
|
|
1413
|
-
|
|
1414
1365
|
**Blockers/Concerns:**
|
|
1415
1366
|
|
|
1416
1367
|
- Read SUMMARY.md "## Next Phase Readiness" section
|
|
@@ -1585,45 +1536,6 @@ git commit --amend --no-edit # Include in metadata commit
|
|
|
1585
1536
|
Skip this step.
|
|
1586
1537
|
</step>
|
|
1587
1538
|
|
|
1588
|
-
<step name="check_phase_issues">
|
|
1589
|
-
**Check if issues were created during this phase:**
|
|
1590
|
-
|
|
1591
|
-
```bash
|
|
1592
|
-
# Check if ISSUES.md exists and has issues from current phase
|
|
1593
|
-
if [ -f .planning/ISSUES.md ]; then
|
|
1594
|
-
grep -E "Phase ${PHASE}.*Task" .planning/ISSUES.md | grep -v "^#" || echo "NO_ISSUES_THIS_PHASE"
|
|
1595
|
-
fi
|
|
1596
|
-
```
|
|
1597
|
-
|
|
1598
|
-
**If issues were created during this phase:**
|
|
1599
|
-
|
|
1600
|
-
```
|
|
1601
|
-
📋 Issues logged during this phase:
|
|
1602
|
-
- ISS-XXX: [brief description]
|
|
1603
|
-
- ISS-YYY: [brief description]
|
|
1604
|
-
|
|
1605
|
-
Review these now?
|
|
1606
|
-
```
|
|
1607
|
-
|
|
1608
|
-
Use AskUserQuestion:
|
|
1609
|
-
- header: "Phase Issues"
|
|
1610
|
-
- question: "[N] issues were logged during this phase. Review now?"
|
|
1611
|
-
- options:
|
|
1612
|
-
- "Review issues" - Analyze with /gsd:consider-issues
|
|
1613
|
-
- "Continue" - Address later, proceed to next work
|
|
1614
|
-
|
|
1615
|
-
**If "Review issues" selected:**
|
|
1616
|
-
- Invoke: `SlashCommand("/gsd:consider-issues")`
|
|
1617
|
-
- After consider-issues completes, return to offer_next
|
|
1618
|
-
|
|
1619
|
-
**If "Continue" selected or no issues found:**
|
|
1620
|
-
- Proceed to offer_next step
|
|
1621
|
-
|
|
1622
|
-
**In YOLO mode:**
|
|
1623
|
-
- Note issues were logged but don't prompt: `📋 [N] issues logged this phase (review later with /gsd:consider-issues)`
|
|
1624
|
-
- Continue to offer_next automatically
|
|
1625
|
-
</step>
|
|
1626
|
-
|
|
1627
1539
|
<step name="offer_next">
|
|
1628
1540
|
**MANDATORY: Verify remaining work before presenting next steps.**
|
|
1629
1541
|
|
|
@@ -55,7 +55,7 @@ PLAN.md IS the prompt that Claude executes. Plans are grouped into execution wav
|
|
|
55
55
|
Read `.planning/STATE.md` and parse:
|
|
56
56
|
- Current position (which phase we're planning)
|
|
57
57
|
- Accumulated decisions (constraints on this phase)
|
|
58
|
-
-
|
|
58
|
+
- Pending todos (candidates for inclusion)
|
|
59
59
|
- Blockers/concerns (things this phase may address)
|
|
60
60
|
- Brief alignment status
|
|
61
61
|
|
|
@@ -186,19 +186,19 @@ Only now open and read complete SUMMARY.md files for the selected relevant phase
|
|
|
186
186
|
- "Issues Encountered" that might affect current phase
|
|
187
187
|
- "Deviations from Plan" for patterns
|
|
188
188
|
|
|
189
|
-
**From STATE.md:** Decisions → constrain approach.
|
|
189
|
+
**From STATE.md:** Decisions → constrain approach. Pending todos → candidates. Blockers → may need to address.
|
|
190
190
|
|
|
191
|
-
**From
|
|
191
|
+
**From pending todos:**
|
|
192
192
|
|
|
193
193
|
```bash
|
|
194
|
-
|
|
194
|
+
ls .planning/todos/pending/*.md 2>/dev/null
|
|
195
195
|
```
|
|
196
196
|
|
|
197
|
-
Assess each
|
|
197
|
+
Assess each pending todo - relevant to this phase? Natural to address now?
|
|
198
198
|
|
|
199
199
|
**Answer before proceeding:**
|
|
200
200
|
- Q1: What decisions from previous phases constrain this phase?
|
|
201
|
-
- Q2: Are there
|
|
201
|
+
- Q2: Are there pending todos that should become tasks?
|
|
202
202
|
- Q3: Are there concerns from "Next Phase Readiness" that apply?
|
|
203
203
|
- Q4: Given all context, does the roadmap's description still make sense?
|
|
204
204
|
|
|
@@ -208,7 +208,7 @@ Assess each open issue - relevant to this phase? Waiting long enough? Natural to
|
|
|
208
208
|
- Established patterns (from frontmatter)
|
|
209
209
|
- Key files to reference (from frontmatter)
|
|
210
210
|
- Applicable decisions (from frontmatter + full summary)
|
|
211
|
-
-
|
|
211
|
+
- Todos being addressed (from pending todos)
|
|
212
212
|
- Concerns being verified (from "Next Phase Readiness")
|
|
213
213
|
</step>
|
|
214
214
|
|
|
@@ -44,7 +44,7 @@ cat .planning/PROJECT.md
|
|
|
44
44
|
- **Current Position**: Phase X of Y, Plan A of B, Status
|
|
45
45
|
- **Progress**: Visual progress bar
|
|
46
46
|
- **Recent Decisions**: Key decisions affecting current work
|
|
47
|
-
- **
|
|
47
|
+
- **Pending Todos**: Ideas captured during sessions
|
|
48
48
|
- **Blockers/Concerns**: Issues carried forward
|
|
49
49
|
- **Session Continuity**: Where we left off, any resume files
|
|
50
50
|
|
|
@@ -123,8 +123,8 @@ Present complete project status to user:
|
|
|
123
123
|
|
|
124
124
|
Resume with: /gsd:resume-task
|
|
125
125
|
|
|
126
|
-
[If
|
|
127
|
-
📋 [N]
|
|
126
|
+
[If pending todos exist:]
|
|
127
|
+
📋 [N] pending todos — /gsd:check-todos to review
|
|
128
128
|
|
|
129
129
|
[If blockers exist:]
|
|
130
130
|
⚠️ Carried concerns:
|
|
@@ -190,7 +190,7 @@ What would you like to do?
|
|
|
190
190
|
|
|
191
191
|
[Secondary options:]
|
|
192
192
|
2. Review current phase status
|
|
193
|
-
3. Check
|
|
193
|
+
3. Check pending todos ([N] pending)
|
|
194
194
|
4. Review brief alignment
|
|
195
195
|
5. Something else
|
|
196
196
|
```
|
|
@@ -244,7 +244,7 @@ Based on user selection, route to appropriate workflow:
|
|
|
244
244
|
---
|
|
245
245
|
```
|
|
246
246
|
- **Transition** → ./transition.md
|
|
247
|
-
- **
|
|
247
|
+
- **Check todos** → Read .planning/todos/pending/, present summary
|
|
248
248
|
- **Review alignment** → Read PROJECT.md, compare to current state
|
|
249
249
|
- **Something else** → Ask what they need
|
|
250
250
|
</step>
|
|
@@ -274,8 +274,8 @@ If STATE.md is missing but other artifacts exist:
|
|
|
274
274
|
|
|
275
275
|
1. Read PROJECT.md → Extract "What This Is" and Core Value
|
|
276
276
|
2. Read ROADMAP.md → Determine phases, find current position
|
|
277
|
-
3. Scan \*-SUMMARY.md files → Extract decisions,
|
|
278
|
-
4.
|
|
277
|
+
3. Scan \*-SUMMARY.md files → Extract decisions, concerns
|
|
278
|
+
4. Count pending todos in .planning/todos/pending/
|
|
279
279
|
5. Check for .continue-here files → Session continuity
|
|
280
280
|
|
|
281
281
|
Reconstruct and write STATE.md, then proceed normally.
|
|
@@ -342,12 +342,6 @@ Review and update Accumulated Context section in STATE.md.
|
|
|
342
342
|
- If still relevant for future: Keep with "Phase X" prefix
|
|
343
343
|
- Add any new concerns from completed phase's summaries
|
|
344
344
|
|
|
345
|
-
**Deferred Issues:**
|
|
346
|
-
|
|
347
|
-
- Count open issues in ISSUES.md
|
|
348
|
-
- Update count: "[N] open issues — see ISSUES.md"
|
|
349
|
-
- If many accumulated, note: "Consider addressing ISS-XXX, ISS-YYY in next phase"
|
|
350
|
-
|
|
351
345
|
**Example:**
|
|
352
346
|
|
|
353
347
|
Before:
|
|
@@ -357,10 +351,6 @@ Before:
|
|
|
357
351
|
|
|
358
352
|
- ⚠️ [Phase 1] Database schema not indexed for common queries
|
|
359
353
|
- ⚠️ [Phase 2] WebSocket reconnection behavior on flaky networks unknown
|
|
360
|
-
|
|
361
|
-
### Deferred Issues
|
|
362
|
-
|
|
363
|
-
- ISS-001: Rate limiting on sync endpoint (Phase 2) — Medium
|
|
364
354
|
```
|
|
365
355
|
|
|
366
356
|
After (if database indexing was addressed in Phase 2):
|
|
@@ -369,11 +359,6 @@ After (if database indexing was addressed in Phase 2):
|
|
|
369
359
|
### Blockers/Concerns
|
|
370
360
|
|
|
371
361
|
- ⚠️ [Phase 2] WebSocket reconnection behavior on flaky networks unknown
|
|
372
|
-
|
|
373
|
-
### Deferred Issues
|
|
374
|
-
|
|
375
|
-
- ISS-001: Rate limiting on sync endpoint (Phase 2) — Medium
|
|
376
|
-
- ISS-002: Better sync error messages (Phase 2) — Quick
|
|
377
362
|
```
|
|
378
363
|
|
|
379
364
|
**Step complete when:**
|
|
@@ -382,7 +367,6 @@ After (if database indexing was addressed in Phase 2):
|
|
|
382
367
|
- [ ] Resolved blockers removed from list
|
|
383
368
|
- [ ] Unresolved blockers kept with phase prefix
|
|
384
369
|
- [ ] New concerns from completed phase added
|
|
385
|
-
- [ ] Deferred issues count updated
|
|
386
370
|
|
|
387
371
|
</step>
|
|
388
372
|
|
package/package.json
CHANGED
|
@@ -1,202 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: gsd:consider-issues
|
|
3
|
-
description: Review deferred issues with codebase context, close resolved ones, identify urgent ones
|
|
4
|
-
allowed-tools:
|
|
5
|
-
- Read
|
|
6
|
-
- Bash
|
|
7
|
-
- Grep
|
|
8
|
-
- Glob
|
|
9
|
-
- Edit
|
|
10
|
-
- AskUserQuestion
|
|
11
|
-
- SlashCommand
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
<objective>
|
|
15
|
-
Review all open issues from ISSUES.md with current codebase context. Identify which issues are resolved (can close), which are now urgent (should address), and which can continue waiting.
|
|
16
|
-
|
|
17
|
-
This prevents issue pile-up by providing a triage mechanism with codebase awareness.
|
|
18
|
-
</objective>
|
|
19
|
-
|
|
20
|
-
<context>
|
|
21
|
-
@.planning/ISSUES.md
|
|
22
|
-
@.planning/STATE.md
|
|
23
|
-
@.planning/ROADMAP.md
|
|
24
|
-
</context>
|
|
25
|
-
|
|
26
|
-
<process>
|
|
27
|
-
|
|
28
|
-
<step name="verify">
|
|
29
|
-
**Verify issues file exists:**
|
|
30
|
-
|
|
31
|
-
If no `.planning/ISSUES.md`:
|
|
32
|
-
```
|
|
33
|
-
No issues file found.
|
|
34
|
-
|
|
35
|
-
This means no enhancements have been deferred yet (Rule 5 hasn't triggered).
|
|
36
|
-
|
|
37
|
-
Nothing to review.
|
|
38
|
-
```
|
|
39
|
-
Exit.
|
|
40
|
-
|
|
41
|
-
If ISSUES.md exists but has no open issues (only template or empty "Open Enhancements"):
|
|
42
|
-
```
|
|
43
|
-
No open issues to review.
|
|
44
|
-
|
|
45
|
-
All clear - continue with current work.
|
|
46
|
-
```
|
|
47
|
-
Exit.
|
|
48
|
-
</step>
|
|
49
|
-
|
|
50
|
-
<step name="parse">
|
|
51
|
-
**Parse all open issues:**
|
|
52
|
-
|
|
53
|
-
Extract from "## Open Enhancements" section:
|
|
54
|
-
- ISS number (ISS-001, ISS-002, etc.)
|
|
55
|
-
- Brief description
|
|
56
|
-
- Discovered phase/date
|
|
57
|
-
- Type (Performance/Refactoring/UX/Testing/Documentation/Accessibility)
|
|
58
|
-
- Description details
|
|
59
|
-
- Effort estimate
|
|
60
|
-
|
|
61
|
-
Build list of issues to analyze.
|
|
62
|
-
</step>
|
|
63
|
-
|
|
64
|
-
<step name="analyze">
|
|
65
|
-
**For each open issue, perform codebase analysis:**
|
|
66
|
-
|
|
67
|
-
1. **Check if still relevant:**
|
|
68
|
-
- Search codebase for related code/files mentioned in issue
|
|
69
|
-
- If code no longer exists or was significantly refactored: likely resolved
|
|
70
|
-
|
|
71
|
-
2. **Check if accidentally resolved:**
|
|
72
|
-
- Look for commits/changes that may have addressed this
|
|
73
|
-
- Check if the enhancement was implemented as part of other work
|
|
74
|
-
|
|
75
|
-
3. **Assess current urgency:**
|
|
76
|
-
- Is this blocking upcoming phases?
|
|
77
|
-
- Has this become a pain point mentioned in recent summaries?
|
|
78
|
-
- Is this now affecting code we're actively working on?
|
|
79
|
-
|
|
80
|
-
4. **Check natural fit:**
|
|
81
|
-
- Does this align with an upcoming phase in the roadmap?
|
|
82
|
-
- Would addressing it now touch the same files as current work?
|
|
83
|
-
|
|
84
|
-
**Categorize each issue:**
|
|
85
|
-
- **Resolved** - Can be closed (code changed, no longer applicable)
|
|
86
|
-
- **Urgent** - Should address before continuing (blocking or causing problems)
|
|
87
|
-
- **Natural fit** - Good candidate for upcoming phase X
|
|
88
|
-
- **Can wait** - Keep deferred, no change in status
|
|
89
|
-
</step>
|
|
90
|
-
|
|
91
|
-
<step name="report">
|
|
92
|
-
**Present categorized report:**
|
|
93
|
-
|
|
94
|
-
```
|
|
95
|
-
# Issue Review
|
|
96
|
-
|
|
97
|
-
**Analyzed:** [N] open issues
|
|
98
|
-
**Last reviewed:** [today's date]
|
|
99
|
-
|
|
100
|
-
## Resolved (can close)
|
|
101
|
-
|
|
102
|
-
### ISS-XXX: [description]
|
|
103
|
-
**Reason:** [Why it's resolved - code changed, implemented elsewhere, no longer applicable]
|
|
104
|
-
**Evidence:** [What you found - file changes, missing code, etc.]
|
|
105
|
-
|
|
106
|
-
[Repeat for each resolved issue, or "None" if none resolved]
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## Urgent (should address now)
|
|
111
|
-
|
|
112
|
-
### ISS-XXX: [description]
|
|
113
|
-
**Why urgent:** [What changed - blocking next phase, causing active problems, etc.]
|
|
114
|
-
**Recommendation:** Insert plan before Phase [X] / Add to current phase
|
|
115
|
-
**Effort:** [Quick/Medium/Substantial]
|
|
116
|
-
|
|
117
|
-
[Repeat for each urgent issue, or "None - all issues can wait" if none urgent]
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
## Natural Fit for Upcoming Work
|
|
122
|
-
|
|
123
|
-
### ISS-XXX: [description]
|
|
124
|
-
**Fits with:** Phase [X] - [phase name]
|
|
125
|
-
**Reason:** [Same files, same subsystem, natural inclusion]
|
|
126
|
-
|
|
127
|
-
[Repeat for each, or "None" if no natural fits]
|
|
128
|
-
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
## Can Wait (no change)
|
|
132
|
-
|
|
133
|
-
### ISS-XXX: [description]
|
|
134
|
-
**Status:** Still valid, not urgent, keep deferred
|
|
135
|
-
|
|
136
|
-
[Repeat for each, or list ISS numbers if many]
|
|
137
|
-
```
|
|
138
|
-
</step>
|
|
139
|
-
|
|
140
|
-
<step name="offer_actions">
|
|
141
|
-
**Offer batch actions:**
|
|
142
|
-
|
|
143
|
-
Based on analysis, present options:
|
|
144
|
-
|
|
145
|
-
```
|
|
146
|
-
## Actions
|
|
147
|
-
|
|
148
|
-
What would you like to do?
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
Use AskUserQuestion with appropriate options based on findings:
|
|
152
|
-
|
|
153
|
-
**If resolved issues exist:**
|
|
154
|
-
- "Close resolved issues" - Move to Closed Enhancements section
|
|
155
|
-
- "Review each first" - Show details before closing
|
|
156
|
-
|
|
157
|
-
**If urgent issues exist:**
|
|
158
|
-
- "Insert urgent phase" - Create phase to address urgent issues (/gsd:insert-phase)
|
|
159
|
-
- "Add to current plan" - Include in next plan being created
|
|
160
|
-
- "Defer anyway" - Keep as-is despite urgency
|
|
161
|
-
|
|
162
|
-
**If natural fits exist:**
|
|
163
|
-
- "Note for phase planning" - Will be picked up during /gsd:plan-phase
|
|
164
|
-
- "Add explicit reminder" - Update issue with "Include in Phase X"
|
|
165
|
-
|
|
166
|
-
**Always include:**
|
|
167
|
-
- "Done for now" - Exit without changes
|
|
168
|
-
</step>
|
|
169
|
-
|
|
170
|
-
<step name="execute_actions">
|
|
171
|
-
**Execute selected actions:**
|
|
172
|
-
|
|
173
|
-
**If closing resolved issues:**
|
|
174
|
-
1. Read current ISSUES.md
|
|
175
|
-
2. For each resolved issue:
|
|
176
|
-
- Remove from "## Open Enhancements"
|
|
177
|
-
- Add to "## Closed Enhancements" with resolution note:
|
|
178
|
-
```
|
|
179
|
-
### ISS-XXX: [description]
|
|
180
|
-
**Resolved:** [date] - [reason]
|
|
181
|
-
```
|
|
182
|
-
3. Write updated ISSUES.md
|
|
183
|
-
4. Update STATE.md deferred issues count
|
|
184
|
-
|
|
185
|
-
**If inserting urgent phase:**
|
|
186
|
-
- Display the command for user to run after clearing: `/gsd:insert-phase [after-phase] Address urgent issues ISS-XXX, ISS-YYY`
|
|
187
|
-
|
|
188
|
-
**If noting for phase planning:**
|
|
189
|
-
- Update issue's "Suggested phase" field with specific phase number
|
|
190
|
-
- These will be picked up by /gsd:plan-phase workflow
|
|
191
|
-
</step>
|
|
192
|
-
|
|
193
|
-
</process>
|
|
194
|
-
|
|
195
|
-
<success_criteria>
|
|
196
|
-
- [ ] All open issues analyzed against current codebase
|
|
197
|
-
- [ ] Each issue categorized (resolved/urgent/natural-fit/can-wait)
|
|
198
|
-
- [ ] Clear reasoning provided for each categorization
|
|
199
|
-
- [ ] Actions offered based on findings
|
|
200
|
-
- [ ] ISSUES.md updated if user takes action
|
|
201
|
-
- [ ] STATE.md updated if issue count changes
|
|
202
|
-
</success_criteria>
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
# Project Issues Log
|
|
2
|
-
|
|
3
|
-
Enhancements discovered during execution. Not critical - address in future phases.
|
|
4
|
-
|
|
5
|
-
## Open Enhancements
|
|
6
|
-
|
|
7
|
-
### ISS-001: [Brief description]
|
|
8
|
-
|
|
9
|
-
- **Discovered:** Phase [X] Task [Z] (YYYY-MM-DD)
|
|
10
|
-
- **Type:** [Performance / Refactoring / UX / Testing / Documentation / Accessibility]
|
|
11
|
-
- **Description:** [What could be improved and why it would help]
|
|
12
|
-
- **Impact:** Low (works correctly, this would enhance)
|
|
13
|
-
- **Effort:** [Quick / Medium / Substantial]
|
|
14
|
-
- **Suggested phase:** [Phase number or "Future"]
|
|
15
|
-
|
|
16
|
-
## Closed Enhancements
|
|
17
|
-
|
|
18
|
-
[Moved here when addressed]
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## Template Notes
|
|
23
|
-
|
|
24
|
-
**When to create:** First time Rule 5 (log enhancements) triggers during execution.
|
|
25
|
-
|
|
26
|
-
**Location:** `.planning/ISSUES.md`
|
|
27
|
-
|
|
28
|
-
**ISS numbering:** Auto-increment from highest existing number.
|
|
29
|
-
|
|
30
|
-
**Entry format:** Copy the ISS-001 block, update number and fields.
|
|
31
|
-
|
|
32
|
-
**Closing issues:** Move entire block to "Closed Enhancements" section, add resolution note.
|