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.
- package/agents/gsd-codebase-mapper.md +743 -0
- package/agents/gsd-debugger.md +1191 -0
- package/agents/gsd-executor.md +759 -0
- package/agents/gsd-integration-checker.md +427 -0
- package/agents/gsd-phase-researcher.md +637 -0
- package/agents/gsd-plan-checker.md +749 -0
- package/agents/gsd-planner.md +1373 -0
- package/agents/gsd-project-researcher.md +877 -0
- package/agents/gsd-research-synthesizer.md +250 -0
- package/agents/gsd-roadmapper.md +610 -0
- package/agents/gsd-verifier.md +782 -0
- package/bin/install.js +11 -1
- package/command/gsd/add-phase.md +5 -7
- package/command/gsd/add-todo.md +4 -6
- package/command/gsd/audit-milestone.md +257 -0
- package/command/gsd/check-todos.md +2 -4
- package/command/gsd/complete-milestone.md +53 -23
- package/command/gsd/debug.md +120 -30
- package/command/gsd/discuss-phase.md +51 -30
- package/command/gsd/execute-phase.md +192 -26
- package/command/gsd/help.md +66 -75
- package/command/gsd/insert-phase.md +6 -6
- package/command/gsd/list-phase-assumptions.md +1 -1
- package/command/gsd/map-codebase.md +15 -28
- package/command/gsd/new-milestone.md +693 -36
- package/command/gsd/new-project.md +668 -108
- package/command/gsd/pause-work.md +2 -2
- package/command/gsd/plan-milestone-gaps.md +284 -0
- package/command/gsd/plan-phase.md +449 -42
- package/command/gsd/progress.md +66 -36
- package/command/gsd/remove-phase.md +17 -19
- package/command/gsd/research-phase.md +155 -67
- package/command/gsd/resume-work.md +3 -3
- package/command/gsd/update.md +172 -0
- package/command/gsd/verify-work.md +186 -38
- package/command/gsd/whats-new.md +124 -0
- package/get-shit-done/references/checkpoints.md +599 -98
- package/get-shit-done/references/continuation-format.md +5 -11
- package/get-shit-done/references/questioning.md +87 -108
- package/get-shit-done/references/tdd.md +3 -3
- package/get-shit-done/references/ui-brand.md +160 -0
- package/get-shit-done/references/verification-patterns.md +595 -0
- package/get-shit-done/templates/DEBUG.md +3 -3
- package/get-shit-done/templates/UAT.md +247 -0
- package/get-shit-done/templates/codebase/architecture.md +5 -5
- package/get-shit-done/templates/codebase/concerns.md +1 -1
- package/get-shit-done/templates/codebase/conventions.md +1 -1
- package/get-shit-done/templates/codebase/structure.md +8 -8
- package/get-shit-done/templates/codebase/testing.md +2 -2
- package/get-shit-done/templates/context.md +221 -70
- package/get-shit-done/templates/debug-subagent-prompt.md +91 -0
- package/get-shit-done/templates/discovery.md +5 -5
- package/get-shit-done/templates/phase-prompt.md +115 -2
- package/get-shit-done/templates/planner-subagent-prompt.md +117 -0
- package/get-shit-done/templates/requirements.md +231 -0
- package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -0
- package/get-shit-done/templates/research-project/FEATURES.md +147 -0
- package/get-shit-done/templates/research-project/PITFALLS.md +200 -0
- package/get-shit-done/templates/research-project/STACK.md +120 -0
- package/get-shit-done/templates/research-project/SUMMARY.md +170 -0
- package/get-shit-done/templates/research.md +2 -2
- package/get-shit-done/templates/roadmap.md +26 -20
- package/get-shit-done/templates/state.md +2 -17
- package/get-shit-done/templates/summary.md +13 -17
- package/get-shit-done/templates/user-setup.md +323 -0
- package/get-shit-done/templates/verification-report.md +322 -0
- package/get-shit-done/workflows/complete-milestone.md +152 -45
- package/get-shit-done/workflows/diagnose-issues.md +233 -0
- package/get-shit-done/workflows/discovery-phase.md +12 -17
- package/get-shit-done/workflows/discuss-phase.md +309 -124
- package/get-shit-done/workflows/execute-phase.md +177 -18
- package/get-shit-done/workflows/execute-plan.md +163 -145
- package/get-shit-done/workflows/map-codebase.md +86 -231
- package/get-shit-done/workflows/resume-project.md +18 -20
- package/get-shit-done/workflows/transition.md +7 -23
- package/get-shit-done/workflows/verify-phase.md +629 -0
- package/get-shit-done/workflows/verify-work.md +495 -134
- package/package.json +2 -1
- package/command/gsd/consider-issues.md +0 -201
- package/command/gsd/create-roadmap.md +0 -115
- package/command/gsd/discuss-milestone.md +0 -47
- package/command/gsd/execute-plan.md +0 -103
- package/command/gsd/plan-fix.md +0 -205
- package/command/gsd/status.md +0 -127
- package/get-shit-done/references/debugging/debugging-mindset.md +0 -253
- package/get-shit-done/references/debugging/hypothesis-testing.md +0 -373
- package/get-shit-done/references/debugging/investigation-techniques.md +0 -337
- package/get-shit-done/references/debugging/verification-patterns.md +0 -425
- package/get-shit-done/references/debugging/when-to-research.md +0 -361
- package/get-shit-done/references/plan-format.md +0 -475
- package/get-shit-done/references/principles.md +0 -157
- package/get-shit-done/references/research-pitfalls.md +0 -215
- package/get-shit-done/references/scope-estimation.md +0 -256
- package/get-shit-done/templates/agent-history.md +0 -263
- package/get-shit-done/templates/checkpoint-return.md +0 -204
- package/get-shit-done/templates/config.json +0 -26
- package/get-shit-done/templates/continuation-prompt.md +0 -235
- package/get-shit-done/templates/issues.md +0 -32
- package/get-shit-done/templates/milestone-context.md +0 -93
- package/get-shit-done/templates/subagent-task-prompt.md +0 -95
- package/get-shit-done/templates/uat-issues.md +0 -143
- package/get-shit-done/workflows/_archive/execute-phase.md +0 -899
- package/get-shit-done/workflows/create-milestone.md +0 -416
- package/get-shit-done/workflows/create-roadmap.md +0 -481
- package/get-shit-done/workflows/debug.md +0 -426
- package/get-shit-done/workflows/discuss-milestone.md +0 -236
- package/get-shit-done/workflows/plan-phase.md +0 -701
- package/get-shit-done/workflows/research-phase.md +0 -436
|
@@ -1,21 +1,23 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Orchestrate parallel
|
|
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
|
|
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
|
|
10
|
+
**Why dedicated mapper agents:**
|
|
9
11
|
- Fresh context per domain (no token contamination)
|
|
10
|
-
-
|
|
11
|
-
-
|
|
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.
|
|
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.
|
|
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
|
|
61
|
-
-
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
66
|
-
- CONCERNS.md (from concerns
|
|
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
|
|
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
|
|
78
|
+
**CRITICAL:** Use the dedicated `gsd-codebase-mapper` agent, NOT `Explore`. The mapper agent writes documents directly.
|
|
75
79
|
|
|
76
|
-
**Agent 1:
|
|
80
|
+
**Agent 1: Tech Focus**
|
|
77
81
|
|
|
78
82
|
Task tool parameters:
|
|
79
83
|
```
|
|
80
|
-
subagent_type: "
|
|
84
|
+
subagent_type: "gsd-codebase-mapper"
|
|
81
85
|
run_in_background: true
|
|
82
|
-
|
|
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
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
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
|
|
102
|
+
**Agent 2: Architecture Focus**
|
|
121
103
|
|
|
122
104
|
Task tool parameters:
|
|
123
105
|
```
|
|
124
|
-
subagent_type: "
|
|
106
|
+
subagent_type: "gsd-codebase-mapper"
|
|
125
107
|
run_in_background: true
|
|
126
|
-
|
|
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
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
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:
|
|
124
|
+
**Agent 3: Quality Focus**
|
|
164
125
|
|
|
165
126
|
Task tool parameters:
|
|
166
127
|
```
|
|
167
|
-
subagent_type: "
|
|
128
|
+
subagent_type: "gsd-codebase-mapper"
|
|
168
129
|
run_in_background: true
|
|
169
|
-
|
|
130
|
+
description: "Map codebase conventions"
|
|
170
131
|
```
|
|
171
132
|
|
|
172
133
|
Prompt:
|
|
173
134
|
```
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
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
|
|
146
|
+
**Agent 4: Concerns Focus**
|
|
208
147
|
|
|
209
148
|
Task tool parameters:
|
|
210
149
|
```
|
|
211
|
-
subagent_type: "
|
|
150
|
+
subagent_type: "gsd-codebase-mapper"
|
|
212
151
|
run_in_background: true
|
|
213
|
-
|
|
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
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
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
|
|
167
|
+
Continue to collect_confirmations.
|
|
254
168
|
</step>
|
|
255
169
|
|
|
256
|
-
<step name="
|
|
170
|
+
<step name="collect_confirmations">
|
|
257
171
|
Wait for all 4 agents to complete.
|
|
258
172
|
|
|
259
|
-
|
|
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
|
-
**
|
|
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
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
179
|
+
**Focus:** {focus}
|
|
180
|
+
**Documents written:**
|
|
181
|
+
- `.planning/codebase/{DOC1}.md` ({N} lines)
|
|
182
|
+
- `.planning/codebase/{DOC2}.md` ({N} lines)
|
|
322
183
|
|
|
323
|
-
|
|
324
|
-
```
|
|
325
|
-
**Primary:**
|
|
326
|
-
- TypeScript 5.3 - All application code
|
|
184
|
+
Ready for orchestrator summary.
|
|
327
185
|
```
|
|
328
186
|
|
|
329
|
-
**
|
|
187
|
+
**What you receive:** Just file paths and line counts. NOT document contents.
|
|
330
188
|
|
|
331
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
-
|
|
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
|
|
428
|
-
-
|
|
429
|
-
-
|
|
430
|
-
- All 7 codebase documents
|
|
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
|
-
|
|
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
|
-
- **
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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:
|
|
124
|
+
Resume with: Task tool (resume parameter with agent ID)
|
|
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:
|
|
@@ -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 (
|
|
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
|
|
181
|
+
1. Resume interrupted agent [if interrupted agent found]
|
|
182
182
|
OR
|
|
183
|
-
1.
|
|
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
|
|
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-
|
|
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
|
-
- **
|
|
248
|
-
- **Review alignment** →
|
|
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.
|
|
276
|
-
2.
|
|
277
|
-
3. Scan \*-SUMMARY.md files → Extract decisions,
|
|
278
|
-
4.
|
|
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
|
-
**
|
|
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
|
-
**
|
|
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:
|
|
397
|
+
**Step 1: read ROADMAP.md and identify phases in current milestone**
|
|
414
398
|
|
|
415
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
481
|
+
Exit skill and invoke "/gsd-complete-milestone {version}"
|
|
498
482
|
|
|
499
483
|
</if>
|
|
500
484
|
|