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 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>
@@ -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
@@ -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, concerns, or deferred issues
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
- ## Open Issues
86
- - [any deferred issues or blockers]
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, deferred issues, blockers
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]), [N] deferred
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), 2 deferred
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
- - Deferred issues from STATE.md
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" (those go in ISSUES.md)
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
- ### Deferred Issues
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
- - Deferred issues from STATE.md (potential features)
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: [Deferred issues from STATE.md if any] + ["New features", "Improvements to existing", "Bug fixes", "Let me describe"]
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: [Deferred issues from STATE.md + pain point categories + "Let me think about it"]
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: log to ISSUES.md, continue without change
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 Rule 5 applies** → Log to ISSUES.md, continue
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), 3 deferred
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. **Issues:**
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
- - Deferred issues (candidates for inclusion)
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. Deferred issues → candidates. Blockers → may need to address.
189
+ **From STATE.md:** Decisions → constrain approach. Pending todos → candidates. Blockers → may need to address.
190
190
 
191
- **From ISSUES.md:**
191
+ **From pending todos:**
192
192
 
193
193
  ```bash
194
- cat .planning/ISSUES.md 2>/dev/null
194
+ ls .planning/todos/pending/*.md 2>/dev/null
195
195
  ```
196
196
 
197
- Assess each open issue - relevant to this phase? Waiting long enough? Natural to address now? Blocking something?
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 deferred issues that should become tasks?
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
- - Issues being addressed (from ISSUES.md)
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
- - **Deferred Issues**: Open items awaiting attention
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 deferred issues exist:]
127
- 📋 [N] deferred issues awaiting attention
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 deferred issues ([N] open)
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
- - **Review issues** → Read ISSUES.md, present summary
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, issues, concerns
278
- 4. Read ISSUES.md Count deferred issues
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,6 +1,6 @@
1
1
  {
2
2
  "name": "get-shit-done-cc",
3
- "version": "1.4.22",
3
+ "version": "1.4.23",
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"
@@ -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.