gsd-opencode 1.5.2 → 1.6.0

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.
Files changed (108) hide show
  1. package/agents/gsd-codebase-mapper.md +743 -0
  2. package/agents/gsd-debugger.md +1191 -0
  3. package/agents/gsd-executor.md +759 -0
  4. package/agents/gsd-integration-checker.md +427 -0
  5. package/agents/gsd-phase-researcher.md +637 -0
  6. package/agents/gsd-plan-checker.md +749 -0
  7. package/agents/gsd-planner.md +1373 -0
  8. package/agents/gsd-project-researcher.md +877 -0
  9. package/agents/gsd-research-synthesizer.md +250 -0
  10. package/agents/gsd-roadmapper.md +610 -0
  11. package/agents/gsd-verifier.md +782 -0
  12. package/bin/install.js +11 -1
  13. package/command/gsd/add-phase.md +5 -7
  14. package/command/gsd/add-todo.md +4 -6
  15. package/command/gsd/audit-milestone.md +257 -0
  16. package/command/gsd/check-todos.md +2 -4
  17. package/command/gsd/complete-milestone.md +53 -23
  18. package/command/gsd/debug.md +120 -30
  19. package/command/gsd/discuss-phase.md +51 -30
  20. package/command/gsd/execute-phase.md +192 -26
  21. package/command/gsd/help.md +66 -75
  22. package/command/gsd/insert-phase.md +6 -6
  23. package/command/gsd/list-phase-assumptions.md +1 -1
  24. package/command/gsd/map-codebase.md +15 -28
  25. package/command/gsd/new-milestone.md +693 -36
  26. package/command/gsd/new-project.md +668 -108
  27. package/command/gsd/pause-work.md +2 -2
  28. package/command/gsd/plan-milestone-gaps.md +284 -0
  29. package/command/gsd/plan-phase.md +449 -42
  30. package/command/gsd/progress.md +66 -36
  31. package/command/gsd/remove-phase.md +17 -19
  32. package/command/gsd/research-phase.md +155 -67
  33. package/command/gsd/resume-work.md +3 -3
  34. package/command/gsd/update.md +172 -0
  35. package/command/gsd/verify-work.md +186 -38
  36. package/command/gsd/whats-new.md +124 -0
  37. package/get-shit-done/references/checkpoints.md +599 -98
  38. package/get-shit-done/references/continuation-format.md +5 -11
  39. package/get-shit-done/references/questioning.md +87 -108
  40. package/get-shit-done/references/tdd.md +3 -3
  41. package/get-shit-done/references/ui-brand.md +160 -0
  42. package/get-shit-done/references/verification-patterns.md +595 -0
  43. package/get-shit-done/templates/DEBUG.md +3 -3
  44. package/get-shit-done/templates/UAT.md +247 -0
  45. package/get-shit-done/templates/codebase/architecture.md +5 -5
  46. package/get-shit-done/templates/codebase/concerns.md +1 -1
  47. package/get-shit-done/templates/codebase/conventions.md +1 -1
  48. package/get-shit-done/templates/codebase/structure.md +8 -8
  49. package/get-shit-done/templates/codebase/testing.md +2 -2
  50. package/get-shit-done/templates/context.md +221 -70
  51. package/get-shit-done/templates/debug-subagent-prompt.md +91 -0
  52. package/get-shit-done/templates/discovery.md +5 -5
  53. package/get-shit-done/templates/phase-prompt.md +115 -2
  54. package/get-shit-done/templates/planner-subagent-prompt.md +117 -0
  55. package/get-shit-done/templates/requirements.md +231 -0
  56. package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -0
  57. package/get-shit-done/templates/research-project/FEATURES.md +147 -0
  58. package/get-shit-done/templates/research-project/PITFALLS.md +200 -0
  59. package/get-shit-done/templates/research-project/STACK.md +120 -0
  60. package/get-shit-done/templates/research-project/SUMMARY.md +170 -0
  61. package/get-shit-done/templates/research.md +2 -2
  62. package/get-shit-done/templates/roadmap.md +26 -20
  63. package/get-shit-done/templates/state.md +2 -17
  64. package/get-shit-done/templates/summary.md +13 -17
  65. package/get-shit-done/templates/user-setup.md +323 -0
  66. package/get-shit-done/templates/verification-report.md +322 -0
  67. package/get-shit-done/workflows/complete-milestone.md +152 -45
  68. package/get-shit-done/workflows/diagnose-issues.md +233 -0
  69. package/get-shit-done/workflows/discovery-phase.md +12 -17
  70. package/get-shit-done/workflows/discuss-phase.md +309 -124
  71. package/get-shit-done/workflows/execute-phase.md +177 -18
  72. package/get-shit-done/workflows/execute-plan.md +163 -145
  73. package/get-shit-done/workflows/map-codebase.md +86 -231
  74. package/get-shit-done/workflows/resume-project.md +18 -20
  75. package/get-shit-done/workflows/transition.md +7 -23
  76. package/get-shit-done/workflows/verify-phase.md +629 -0
  77. package/get-shit-done/workflows/verify-work.md +495 -134
  78. package/package.json +2 -1
  79. package/command/gsd/consider-issues.md +0 -201
  80. package/command/gsd/create-roadmap.md +0 -115
  81. package/command/gsd/discuss-milestone.md +0 -47
  82. package/command/gsd/execute-plan.md +0 -103
  83. package/command/gsd/plan-fix.md +0 -205
  84. package/command/gsd/status.md +0 -127
  85. package/get-shit-done/references/debugging/debugging-mindset.md +0 -253
  86. package/get-shit-done/references/debugging/hypothesis-testing.md +0 -373
  87. package/get-shit-done/references/debugging/investigation-techniques.md +0 -337
  88. package/get-shit-done/references/debugging/verification-patterns.md +0 -425
  89. package/get-shit-done/references/debugging/when-to-research.md +0 -361
  90. package/get-shit-done/references/plan-format.md +0 -475
  91. package/get-shit-done/references/principles.md +0 -157
  92. package/get-shit-done/references/research-pitfalls.md +0 -215
  93. package/get-shit-done/references/scope-estimation.md +0 -256
  94. package/get-shit-done/templates/agent-history.md +0 -263
  95. package/get-shit-done/templates/checkpoint-return.md +0 -204
  96. package/get-shit-done/templates/config.json +0 -26
  97. package/get-shit-done/templates/continuation-prompt.md +0 -235
  98. package/get-shit-done/templates/issues.md +0 -32
  99. package/get-shit-done/templates/milestone-context.md +0 -93
  100. package/get-shit-done/templates/subagent-task-prompt.md +0 -95
  101. package/get-shit-done/templates/uat-issues.md +0 -143
  102. package/get-shit-done/workflows/_archive/execute-phase.md +0 -899
  103. package/get-shit-done/workflows/create-milestone.md +0 -416
  104. package/get-shit-done/workflows/create-roadmap.md +0 -481
  105. package/get-shit-done/workflows/debug.md +0 -426
  106. package/get-shit-done/workflows/discuss-milestone.md +0 -236
  107. package/get-shit-done/workflows/plan-phase.md +0 -701
  108. package/get-shit-done/workflows/research-phase.md +0 -436
@@ -1,21 +1,23 @@
1
1
  <purpose>
2
- Orchestrate parallel explore agents to analyze codebase and produce structured documents in .planning/codebase/
2
+ Orchestrate parallel codebase mapper agents to analyze codebase and produce structured documents in .planning/codebase/
3
3
 
4
- Each agent has fresh context and focuses on specific aspects. Output is concise and actionable for planning.
4
+ Each agent has fresh context, explores a specific focus area, and **writes documents directly**. The orchestrator only receives confirmation + line counts, then writes a summary.
5
+
6
+ Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
5
7
  </purpose>
6
8
 
7
9
  <philosophy>
8
- **Why parallel agents:**
10
+ **Why dedicated mapper agents:**
9
11
  - Fresh context per domain (no token contamination)
10
- - Thorough analysis without context exhaustion
11
- - Each agent optimized for its domain (tech vs organization vs quality vs issues)
12
+ - Agents write documents directly (no context transfer back to orchestrator)
13
+ - Orchestrator only summarizes what was created (minimal context usage)
12
14
  - Faster execution (agents run simultaneously)
13
15
 
14
16
  **Document quality over length:**
15
- Include enough detail to be useful as reference. Prioritize practical examples (especially code patterns) over arbitrary brevity. A 200-line TESTING.md with real patterns is more valuable than a 74-line summary.
17
+ Include enough detail to be useful as reference. Prioritize practical examples (especially code patterns) over arbitrary brevity.
16
18
 
17
19
  **Always include file paths:**
18
- Documents are reference material for OpenCode when planning/executing. Vague descriptions like "UserService handles users" are not actionable. Always include actual file paths formatted with backticks: `src/services/user.ts`. This allows OpenCode to navigate directly to relevant code without re-searching. Do NOT include line numbers (they go stale), just file paths.
20
+ Documents are reference material for OpenCode when planning/executing. Always include actual file paths formatted with backticks: `src/services/user.ts`.
19
21
  </philosophy>
20
22
 
21
23
  <process>
@@ -57,286 +59,136 @@ mkdir -p .planning/codebase
57
59
  ```
58
60
 
59
61
  **Expected output files:**
60
- - STACK.md (from stack.md template)
61
- - ARCHITECTURE.md (from architecture.md template)
62
- - STRUCTURE.md (from structure.md template)
63
- - CONVENTIONS.md (from conventions.md template)
64
- - TESTING.md (from testing.md template)
65
- - INTEGRATIONS.md (from integrations.md template)
66
- - CONCERNS.md (from concerns.md template)
62
+ - STACK.md (from tech mapper)
63
+ - INTEGRATIONS.md (from tech mapper)
64
+ - ARCHITECTURE.md (from arch mapper)
65
+ - STRUCTURE.md (from arch mapper)
66
+ - CONVENTIONS.md (from quality mapper)
67
+ - TESTING.md (from quality mapper)
68
+ - CONCERNS.md (from concerns mapper)
67
69
 
68
70
  Continue to spawn_agents.
69
71
  </step>
70
72
 
71
73
  <step name="spawn_agents">
72
- Spawn 4 parallel explore agents to analyze codebase.
74
+ Spawn 4 parallel gsd-codebase-mapper agents.
75
+
76
+ Use Task tool with `subagent_type="gsd-codebase-mapper"` and `run_in_background=true` for parallel execution.
73
77
 
74
- Use Task tool with `subagent_type="explore"` and `run_in_background=true` for parallel execution.
78
+ **CRITICAL:** Use the dedicated `gsd-codebase-mapper` agent, NOT `Explore`. The mapper agent writes documents directly.
75
79
 
76
- **Agent 1: Stack + Integrations (Technology Focus)**
80
+ **Agent 1: Tech Focus**
77
81
 
78
82
  Task tool parameters:
79
83
  ```
80
- subagent_type: "explore"
84
+ subagent_type: "gsd-codebase-mapper"
81
85
  run_in_background: true
82
- task_description: "Analyze codebase technology stack and external integrations"
86
+ description: "Map codebase tech stack"
83
87
  ```
84
88
 
85
89
  Prompt:
86
90
  ```
91
+ Focus: tech
92
+
87
93
  Analyze this codebase for technology stack and external integrations.
88
94
 
89
- IMPORTANT: Always include actual file paths in your findings. Use backtick formatting like `src/config/database.ts`. This makes the output actionable for planning.
90
-
91
- Focus areas:
92
- 1. Languages (check file extensions, package manifests)
93
- 2. Runtime environment (Node.js, Python, etc. - check .nvmrc, .python-version, engines field)
94
- 3. Package manager and lockfiles
95
- 4. Frameworks (web, testing, build tools)
96
- 5. Key dependencies (critical packages for functionality)
97
- 6. External services (APIs, databases, auth providers)
98
- 7. Third-party integrations (payment, analytics, etc.)
99
- 8. Configuration approach (.env, config files)
100
-
101
- Search for:
102
- - package.json / requirements.txt / Cargo.toml / go.mod
103
- - .env files, .env.example
104
- - Config files (vite.config, webpack.config, tsconfig.json)
105
- - API client code, database connection code
106
- - Import statements for major libraries
107
-
108
- Output findings for populating these sections:
109
- - STACK.md: Languages, Runtime, Frameworks, Dependencies, Configuration
110
- - INTEGRATIONS.md: External APIs, Services, Third-party tools
111
-
112
- For each finding, include the file path where you found it. Example:
113
- - "TypeScript 5.3 - `package.json`"
114
- - "Supabase client - `src/lib/supabase.ts`"
115
- - "Stripe integration - `src/services/stripe.ts`, `src/webhooks/stripe.ts`"
116
-
117
- If something is not found, note "Not detected" for that category.
95
+ write these documents to .planning/codebase/:
96
+ - STACK.md - Languages, runtime, frameworks, dependencies, configuration
97
+ - INTEGRATIONS.md - External APIs, databases, auth providers, webhooks
98
+
99
+ Explore thoroughly. write documents directly using templates. Return confirmation only.
118
100
  ```
119
101
 
120
- **Agent 2: Architecture + Structure (Organization Focus)**
102
+ **Agent 2: Architecture Focus**
121
103
 
122
104
  Task tool parameters:
123
105
  ```
124
- subagent_type: "explore"
106
+ subagent_type: "gsd-codebase-mapper"
125
107
  run_in_background: true
126
- task_description: "Analyze codebase architecture patterns and directory structure"
108
+ description: "Map codebase architecture"
127
109
  ```
128
110
 
129
111
  Prompt:
130
112
  ```
113
+ Focus: arch
114
+
131
115
  Analyze this codebase architecture and directory structure.
132
116
 
133
- IMPORTANT: Always include actual file paths in your findings. Use backtick formatting like `src/index.ts`. This makes the output actionable for planning.
134
-
135
- Focus areas:
136
- 1. Overall architectural pattern (monolith, microservices, layered, etc.)
137
- 2. Conceptual layers (API, service, data, utility)
138
- 3. Data flow and request lifecycle
139
- 4. Key abstractions and patterns (services, controllers, repositories)
140
- 5. Entry points (main files, server files, CLI entry)
141
- 6. Directory organization and purposes
142
- 7. Module boundaries
143
- 8. Naming conventions for directories and files
144
-
145
- Search for:
146
- - Entry points: index.ts, main.ts, server.ts, app.ts, cli.ts
147
- - Directory structure patterns (src/, lib/, components/, services/)
148
- - Import patterns (what imports what)
149
- - Recurring code patterns (base classes, interfaces, common abstractions)
150
-
151
- Output findings for populating these sections:
152
- - ARCHITECTURE.md: Pattern, Layers, Data Flow, Abstractions, Entry Points
153
- - STRUCTURE.md: Directory layout, Organization, Key locations
154
-
155
- For each finding, include the file path. Examples:
156
- - "CLI entry point: `bin/install.js`"
157
- - "Service layer: `src/services/*.ts` (UserService, ProjectService)"
158
- - "API routes: `src/routes/api/*.ts`"
159
-
160
- If something is not clear, provide best-guess interpretation based on code structure.
117
+ write these documents to .planning/codebase/:
118
+ - ARCHITECTURE.md - Pattern, layers, data flow, abstractions, entry points
119
+ - STRUCTURE.md - Directory layout, key locations, naming conventions
120
+
121
+ Explore thoroughly. write documents directly using templates. Return confirmation only.
161
122
  ```
162
123
 
163
- **Agent 3: Conventions + Testing (Quality Focus)**
124
+ **Agent 3: Quality Focus**
164
125
 
165
126
  Task tool parameters:
166
127
  ```
167
- subagent_type: "explore"
128
+ subagent_type: "gsd-codebase-mapper"
168
129
  run_in_background: true
169
- task_description: "Analyze coding conventions and test patterns"
130
+ description: "Map codebase conventions"
170
131
  ```
171
132
 
172
133
  Prompt:
173
134
  ```
174
- Analyze this codebase for coding conventions and testing practices.
175
-
176
- IMPORTANT: Always include actual file paths in your findings. Use backtick formatting like `vitest.config.ts`. This makes the output actionable for planning.
177
-
178
- Focus areas:
179
- 1. Code style (indentation, quotes, semicolons, formatting)
180
- 2. File naming conventions (kebab-case, PascalCase, etc.)
181
- 3. Function/variable naming patterns
182
- 4. Comment and documentation style
183
- 5. Test framework and structure
184
- 6. Test organization (unit, integration, e2e)
185
- 7. Test coverage approach
186
- 8. Linting and formatting tools
187
-
188
- Search for:
189
- - Config files: .eslintrc, .prettierrc, tsconfig.json
190
- - Test files: *.test.*, *.spec.*, __tests__/
191
- - Test setup: vitest.config, jest.config
192
- - Code patterns across multiple files
193
- - README or CONTRIBUTING docs
194
-
195
- Output findings for populating these sections:
196
- - CONVENTIONS.md: Code Style, Naming, Patterns, Documentation
197
- - TESTING.md: Framework, Structure, Coverage, Tools
198
-
199
- For each finding, include file paths. Examples:
200
- - "Prettier config: `.prettierrc`"
201
- - "Test pattern: `src/**/*.test.ts` (co-located with source)"
202
- - "Example of naming convention: `src/services/user-service.ts`"
203
-
204
- Look at actual code files to infer conventions if config files are missing.
135
+ Focus: quality
136
+
137
+ Analyze this codebase for coding conventions and testing patterns.
138
+
139
+ write these documents to .planning/codebase/:
140
+ - CONVENTIONS.md - Code style, naming, patterns, error handling
141
+ - TESTING.md - Framework, structure, mocking, coverage
142
+
143
+ Explore thoroughly. write documents directly using templates. Return confirmation only.
205
144
  ```
206
145
 
207
- **Agent 4: Concerns (Issues Focus)**
146
+ **Agent 4: Concerns Focus**
208
147
 
209
148
  Task tool parameters:
210
149
  ```
211
- subagent_type: "explore"
150
+ subagent_type: "gsd-codebase-mapper"
212
151
  run_in_background: true
213
- task_description: "Identify technical debt and areas of concern"
152
+ description: "Map codebase concerns"
214
153
  ```
215
154
 
216
155
  Prompt:
217
156
  ```
157
+ Focus: concerns
158
+
218
159
  Analyze this codebase for technical debt, known issues, and areas of concern.
219
160
 
220
- CRITICAL: Always include actual file paths in your findings. Use backtick formatting like `src/auth/login.ts`. Concerns without file paths are not actionable. For each issue found, specify exactly where it is.
221
-
222
- Focus areas:
223
- 1. TODO and FIXME comments
224
- 2. Complex or hard-to-understand code
225
- 3. Missing error handling (try/catch, error checks)
226
- 4. Security patterns (hardcoded secrets, unsafe operations)
227
- 5. Outdated dependencies (check versions against current)
228
- 6. Missing tests for critical code
229
- 7. Duplicate code patterns
230
- 8. Performance concerns (N+1 queries, inefficient loops)
231
- 9. Documentation gaps (complex code without comments)
232
-
233
- Search for:
234
- - TODO, FIXME, HACK, XXX comments
235
- - Large functions or files (>200 lines)
236
- - Repeated code patterns
237
- - Missing .env.example when .env is used
238
- - Dependencies with known vulnerabilities (check versions)
239
- - Error-prone patterns (no validation, no error handling)
240
-
241
- Output findings for populating:
242
- - CONCERNS.md: Technical Debt, Issues, Security, Performance, Documentation
243
-
244
- For EVERY concern, include file paths. Examples:
245
- - "Direct DB queries in components: `src/pages/Dashboard.tsx`, `src/pages/Profile.tsx`"
246
- - "Missing error handling: `src/api/webhook.ts` (Stripe webhook has no try/catch)"
247
- - "TODO: 'fix race condition' in `src/services/subscription.ts`"
248
-
249
- Be constructive - focus on actionable concerns, not nitpicks.
250
- If codebase is clean, note that rather than inventing problems.
161
+ write this document to .planning/codebase/:
162
+ - CONCERNS.md - Tech debt, bugs, security, performance, fragile areas
163
+
164
+ Explore thoroughly. write document directly using template. Return confirmation only.
251
165
  ```
252
166
 
253
- Continue to collect_results.
167
+ Continue to collect_confirmations.
254
168
  </step>
255
169
 
256
- <step name="collect_results">
170
+ <step name="collect_confirmations">
257
171
  Wait for all 4 agents to complete.
258
172
 
259
- Use TaskOutput tool to collect results from each agent. Since agents were run with `run_in_background=true`, retrieve their output.
260
-
261
- **Collection pattern:**
262
-
263
- For each agent, use TaskOutput tool to get the full exploration findings.
264
-
265
- **Aggregate findings by document:**
266
-
267
- From Agent 1 output, extract:
268
- - STACK.md sections: Languages, Runtime, Frameworks, Dependencies, Configuration, Platform
269
- - INTEGRATIONS.md sections: External APIs, Services, Authentication, Webhooks
270
-
271
- From Agent 2 output, extract:
272
- - ARCHITECTURE.md sections: Pattern Overview, Layers, Data Flow, Key Abstractions, Entry Points
273
- - STRUCTURE.md sections: Directory Layout, Key Locations, Organization
274
-
275
- From Agent 3 output, extract:
276
- - CONVENTIONS.md sections: Code Style, Naming Conventions, Common Patterns, Documentation Style
277
- - TESTING.md sections: Framework, Structure, Coverage, Tools
278
-
279
- From Agent 4 output, extract:
280
- - CONCERNS.md sections: Technical Debt, Known Issues, Security, Performance, Missing
173
+ read each agent's output file to collect confirmations.
281
174
 
282
- **Handling missing findings:**
283
-
284
- If an agent didn't find information for a section, use placeholder:
285
- - "Not detected" (for infrastructure/tools that may not exist)
286
- - "Not applicable" (for patterns that don't apply to this codebase)
287
- - "No significant concerns" (for CONCERNS.md if codebase is clean)
288
-
289
- Continue to write_documents.
290
- </step>
291
-
292
- <step name="write_documents">
293
- Write all 7 codebase documents using templates and agent findings.
294
-
295
- **Template filling process:**
296
-
297
- For each document:
298
-
299
- 1. **Read template file** from `~/.config/opencode/get-shit-done/templates/codebase/{name}.md`
300
- 2. **Extract the "File Template" section** - this is the markdown code block containing the actual document structure
301
- 3. **Fill template placeholders** with agent findings:
302
- - Replace `[YYYY-MM-DD]` with current date
303
- - Replace `[Placeholder text]` with specific findings from agents
304
- - If agent found nothing for a section, use appropriate placeholder:
305
- - "Not detected" for optional infrastructure
306
- - "Not applicable" for patterns that don't fit this codebase
307
- - "No significant concerns" for clean codebase areas
308
- 4. **Write to .planning/codebase/{NAME}.md** (uppercase filename)
309
-
310
- **Example filling pattern:**
311
-
312
- Template placeholder:
313
- ```
314
- **Primary:**
315
- - [Language] [Version] - [Where used: e.g., "all application code"]
175
+ **Expected confirmation format from each agent:**
316
176
  ```
177
+ ## Mapping Complete
317
178
 
318
- Agent finding:
319
- ```
320
- Found: TypeScript 5.3 used in all .ts files throughout src/
321
- ```
179
+ **Focus:** {focus}
180
+ **Documents written:**
181
+ - `.planning/codebase/{DOC1}.md` ({N} lines)
182
+ - `.planning/codebase/{DOC2}.md` ({N} lines)
322
183
 
323
- Filled result:
324
- ```
325
- **Primary:**
326
- - TypeScript 5.3 - All application code
184
+ Ready for orchestrator summary.
327
185
  ```
328
186
 
329
- **Document writing order:**
187
+ **What you receive:** Just file paths and line counts. NOT document contents.
330
188
 
331
- 1. **STACK.md** (from stack.md template + Agent 1 findings)
332
- 2. **INTEGRATIONS.md** (from integrations.md template + Agent 1 findings)
333
- 3. **ARCHITECTURE.md** (from architecture.md template + Agent 2 findings)
334
- 4. **STRUCTURE.md** (from structure.md template + Agent 2 findings)
335
- 5. **CONVENTIONS.md** (from conventions.md template + Agent 3 findings)
336
- 6. **TESTING.md** (from testing.md template + Agent 3 findings)
337
- 7. **CONCERNS.md** (from concerns.md template + Agent 4 findings)
189
+ If any agent failed, note the failure and continue with successful documents.
338
190
 
339
- After all documents written, continue to verify_output.
191
+ Continue to verify_output.
340
192
  </step>
341
193
 
342
194
  <step name="verify_output">
@@ -349,10 +201,9 @@ wc -l .planning/codebase/*.md
349
201
 
350
202
  **Verification checklist:**
351
203
  - All 7 documents exist
352
- - No empty documents
353
- - Templates populated with findings
204
+ - No empty documents (each should have >20 lines)
354
205
 
355
- If any checks fail, report issues to user.
206
+ If any documents missing or empty, note which agents may have failed.
356
207
 
357
208
  Continue to commit_codebase_map.
358
209
  </step>
@@ -382,6 +233,11 @@ Continue to offer_next.
382
233
  <step name="offer_next">
383
234
  Present completion summary and next steps.
384
235
 
236
+ **Get line counts:**
237
+ ```bash
238
+ wc -l .planning/codebase/*.md
239
+ ```
240
+
385
241
  **Output format:**
386
242
 
387
243
  ```
@@ -412,7 +268,7 @@ Created .planning/codebase/:
412
268
  **Also available:**
413
269
  - Re-run mapping: `/gsd-map-codebase`
414
270
  - Review specific file: `cat .planning/codebase/STACK.md`
415
- - Edit any document before proceeding
271
+ - edit any document before proceeding
416
272
 
417
273
  ---
418
274
  ```
@@ -424,11 +280,10 @@ End workflow.
424
280
 
425
281
  <success_criteria>
426
282
  - .planning/codebase/ directory created
427
- - 4 parallel explore agents spawned with run_in_background=true
428
- - Agent prompts are specific and actionable
429
- - TaskOutput used to collect all agent results
430
- - All 7 codebase documents written using template filling
431
- - Documents follow template structure with actual findings
283
+ - 4 parallel gsd-codebase-mapper agents spawned with run_in_background=true
284
+ - Agents write documents directly (orchestrator doesn't receive document contents)
285
+ - read agent output files to collect confirmations
286
+ - All 7 codebase documents exist
432
287
  - Clear completion summary with line counts
433
288
  - User offered clear next steps in GSD style
434
289
  </success_criteria>
@@ -31,7 +31,7 @@ ls .planning/PROJECT.md 2>/dev/null && echo "Project file exists"
31
31
 
32
32
  <step name="load_state">
33
33
 
34
- Read and parse STATE.md, then PROJECT.md:
34
+ read and parse STATE.md, then PROJECT.md:
35
35
 
36
36
  ```bash
37
37
  cat .planning/STATE.md
@@ -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
 
@@ -80,7 +80,7 @@ fi
80
80
  **If .continue-here file exists:**
81
81
 
82
82
  - This is a mid-plan resumption point
83
- - Read the file for specific resumption context
83
+ - read the file for specific resumption context
84
84
  - Flag: "Found mid-plan checkpoint"
85
85
 
86
86
  **If PLAN without SUMMARY exists:**
@@ -91,7 +91,7 @@ fi
91
91
  **If interrupted agent found:**
92
92
 
93
93
  - Subagent was spawned but session ended before completion
94
- - Read agent-history.json for task details
94
+ - read agent-history.json for task details
95
95
  - Flag: "Found interrupted agent"
96
96
  </step>
97
97
 
@@ -121,10 +121,10 @@ Present complete project status to user:
121
121
  Task: [task description from agent-history.json]
122
122
  Interrupted: [timestamp]
123
123
 
124
- Resume with: /gsd-resume-task
124
+ Resume with: Task tool (resume parameter with agent ID)
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:
@@ -141,7 +141,7 @@ Present complete project status to user:
141
141
  Based on project state, determine the most logical next action:
142
142
 
143
143
  **If interrupted agent exists:**
144
- → Primary: Resume interrupted agent (/gsd-resume-task)
144
+ → Primary: Resume interrupted agent (Task tool with resume parameter)
145
145
  → Option: Start fresh (abandon agent work)
146
146
 
147
147
  **If .continue-here file exists:**
@@ -178,11 +178,9 @@ Present contextual options based on project state:
178
178
  What would you like to do?
179
179
 
180
180
  [Primary action based on state - e.g.:]
181
- 1. Resume interrupted agent (/gsd-resume-task) [if interrupted agent found]
181
+ 1. Resume interrupted agent [if interrupted agent found]
182
182
  OR
183
- 1. Resume from checkpoint (/gsd-execute-plan .planning/phases/XX-name/.continue-here-02-01.md)
184
- OR
185
- 1. Execute next plan (/gsd-execute-plan .planning/phases/XX-name/02-02-PLAN.md)
183
+ 1. Execute phase (/gsd-execute-phase {phase})
186
184
  OR
187
185
  1. Discuss Phase 3 context (/gsd-discuss-phase 3) [if CONTEXT.md missing]
188
186
  OR
@@ -190,7 +188,7 @@ What would you like to do?
190
188
 
191
189
  [Secondary options:]
192
190
  2. Review current phase status
193
- 3. Check deferred issues ([N] open)
191
+ 3. Check pending todos ([N] pending)
194
192
  4. Review brief alignment
195
193
  5. Something else
196
194
  ```
@@ -217,7 +215,7 @@ Based on user selection, route to appropriate workflow:
217
215
 
218
216
  **{phase}-{plan}: [Plan Name]** — [objective from PLAN.md]
219
217
 
220
- `/gsd-execute-plan [path]`
218
+ `/gsd-execute-phase {phase}`
221
219
 
222
220
  *`/new` first → fresh context window*
223
221
 
@@ -244,8 +242,8 @@ Based on user selection, route to appropriate workflow:
244
242
  ---
245
243
  ```
246
244
  - **Transition** → ./transition.md
247
- - **Review issues** → Read ISSUES.md, present summary
248
- - **Review alignment** → Read PROJECT.md, compare to current state
245
+ - **Check todos** → read .planning/todos/pending/, present summary
246
+ - **Review alignment** → read PROJECT.md, compare to current state
249
247
  - **Something else** → Ask what they need
250
248
  </step>
251
249
 
@@ -272,10 +270,10 @@ If STATE.md is missing but other artifacts exist:
272
270
 
273
271
  "STATE.md missing. Reconstructing from artifacts..."
274
272
 
275
- 1. Read PROJECT.md → Extract "What This Is" and Core Value
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
273
+ 1. read PROJECT.md → Extract "What This Is" and Core Value
274
+ 2. read ROADMAP.md → Determine phases, find current position
275
+ 3. Scan \*-SUMMARY.md files → Extract decisions, concerns
276
+ 4. Count pending todos in .planning/todos/pending/
279
277
  5. Check for .continue-here files → Session continuity
280
278
 
281
279
  Reconstruct and write STATE.md, then proceed normally.
@@ -1,6 +1,6 @@
1
1
  <required_reading>
2
2
 
3
- **Read these files NOW:**
3
+ **read these files NOW:**
4
4
 
5
5
  1. `.planning/STATE.md`
6
6
  2. `.planning/PROJECT.md`
@@ -165,7 +165,7 @@ The `completed/` subfolder pattern from create-meta-prompts handles archival.
165
165
 
166
166
  Evolve PROJECT.md to reflect learnings from completed phase.
167
167
 
168
- **Read phase summaries:**
168
+ **read phase summaries:**
169
169
 
170
170
  ```bash
171
171
  cat .planning/phases/XX-current/*-SUMMARY.md
@@ -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
 
@@ -410,9 +394,9 @@ Resume file: None
410
394
 
411
395
  **MANDATORY: Verify milestone status before presenting next steps.**
412
396
 
413
- **Step 1: Read ROADMAP.md and identify phases in current milestone**
397
+ **Step 1: read ROADMAP.md and identify phases in current milestone**
414
398
 
415
- Read the ROADMAP.md file and extract:
399
+ read the ROADMAP.md file and extract:
416
400
  1. Current phase number (the phase just transitioned from)
417
401
  2. All phase numbers in the current milestone section
418
402
 
@@ -435,7 +419,7 @@ State: "Current phase is {X}. Milestone has {N} phases (highest: {Y})."
435
419
 
436
420
  **Route A: More phases remain in milestone**
437
421
 
438
- Read ROADMAP.md to get the next phase's name and goal.
422
+ read ROADMAP.md to get the next phase's name and goal.
439
423
 
440
424
  **If next phase exists:**
441
425
 
@@ -449,7 +433,7 @@ Next: Phase [X+1] — [Name]
449
433
  ⚡ Auto-continuing: Plan Phase [X+1] in detail
450
434
  ```
451
435
 
452
- Exit skill and invoke [removed - use /command syntax]("/gsd-plan-phase [X+1]")
436
+ Exit skill and invoke "/gsd-plan-phase [X+1]"
453
437
 
454
438
  </if>
455
439
 
@@ -494,7 +478,7 @@ Phase {X} marked complete.
494
478
  ⚡ Auto-continuing: Complete milestone and archive
495
479
  ```
496
480
 
497
- Exit skill and invoke [removed - use /command syntax]("/gsd-complete-milestone {version}")
481
+ Exit skill and invoke "/gsd-complete-milestone {version}"
498
482
 
499
483
  </if>
500
484