Skip to content

Commit ebea517

Browse files
committed
docs(prompts): improve task list format with hierarchical structure
Update generate-task-list-from-spec prompt to use hierarchical markdown structure for better readability. - Change from flat bullet lists to hierarchical headers (### and ####) - Convert Demo Criteria and Proof Artifacts to bulleted lists - Add TBD placeholder for Tasks section in Phase 2 output format
1 parent bd83253 commit ebea517

File tree

1 file changed

+98
-25
lines changed

1 file changed

+98
-25
lines changed

prompts/generate-task-list-from-spec.md

Lines changed: 98 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -136,20 +136,58 @@ Wait for explicit user confirmation before generating sub-tasks. Then:
136136

137137
## Phase 2 Output Format (Parent Tasks Only)
138138

139-
When generating parent tasks in Phase 2, use this structure WITHOUT sub-tasks:
139+
When generating parent tasks in Phase 2, use this hierarchical structure with Tasks section marked "TBD":
140140

141141
```markdown
142142
## Tasks
143143

144-
- [ ] 1.0 Parent Task Title
145-
- Demo Criteria: "Open /path and complete X end-to-end; acceptance: Y visible/returned"
146-
- Proof Artifact(s): "URL: https://..., CLI: command & expected output, Test: MyFeature.test.ts"
147-
- [ ] 2.0 Parent Task Title
148-
- Demo Criteria: "User can perform Z with persisted state"
149-
- Proof Artifact(s): "Screenshot of flow; link to test suite section"
150-
- [ ] 3.0 Parent Task Title
151-
- Demo Criteria: "Configuration is verifiable via command/output"
152-
- Proof Artifact(s): "CLI: config get … -> expected value; log line; diff link"
144+
### [ ] 1.0 Parent Task Title
145+
146+
#### 1.0 Demo Criteria
147+
148+
- Open /path and complete X end-to-end
149+
- Acceptance: Y visible/returned
150+
151+
#### 1.0 Proof Artifact(s)
152+
153+
- URL: https://...
154+
- CLI: command & expected output
155+
- Test: MyFeature.test.ts
156+
157+
#### 1.0 Tasks
158+
159+
TBD
160+
161+
### [ ] 2.0 Parent Task Title
162+
163+
#### 2.0 Demo Criteria
164+
165+
- User can perform Z with persisted state
166+
167+
#### 2.0 Proof Artifact(s)
168+
169+
- Screenshot of flow
170+
- Link to test suite section
171+
172+
#### 2.0 Tasks
173+
174+
TBD
175+
176+
### [ ] 3.0 Parent Task Title
177+
178+
#### 3.0 Demo Criteria
179+
180+
- Configuration is verifiable via command/output
181+
182+
#### 3.0 Proof Artifact(s)
183+
184+
- CLI: config get … -> expected value
185+
- Log line
186+
- Diff link
187+
188+
#### 3.0 Tasks
189+
190+
TBD
153191
```
154192

155193
## Phase 3 Output Format (Complete with Sub-Tasks)
@@ -175,21 +213,56 @@ After user confirmation in Phase 3, update the file with this complete structure
175213

176214
## Tasks
177215

178-
- [ ] 1.0 Parent Task Title
179-
- Demo Criteria: "Open /path and complete X end-to-end; acceptance: Y visible/returned"
180-
- Proof Artifact(s): "URL: https://..., CLI: command & expected output, Test: MyFeature.test.ts"
181-
- [ ] 1.1 [Sub-task description 1.1]
182-
- [ ] 1.2 [Sub-task description 1.2]
183-
- [ ] 2.0 Parent Task Title
184-
- Demo Criteria: "User can perform Z with persisted state"
185-
- Proof Artifact(s): "Screenshot of flow; link to test suite section"
186-
- [ ] 2.1 [Sub-task description 2.1]
187-
- [ ] 2.2 [Sub-task description 2.2]
188-
- [ ] 3.0 Parent Task Title (may not require sub-tasks if purely structural or configuration)
189-
- Demo Criteria: "Configuration is verifiable via command/output"
190-
- Proof Artifact(s): "CLI: config get … -> expected value; log line; diff link"
191-
- [ ] 3.1 [Sub-task description 3.1]
192-
- [ ] 3.2 [Sub-task description 3.2]
216+
### [ ] 1.0 Parent Task Title
217+
218+
#### 1.0 Demo Criteria
219+
220+
- Open /path and complete X end-to-end
221+
- Acceptance: Y visible/returned
222+
223+
#### 1.0 Proof Artifact(s)
224+
225+
- URL: https://...
226+
- CLI: command & expected output
227+
- Test: MyFeature.test.ts
228+
229+
#### 1.0 Tasks
230+
231+
- [ ] 1.1 [Sub-task description 1.1]
232+
- [ ] 1.2 [Sub-task description 1.2]
233+
234+
### [ ] 2.0 Parent Task Title
235+
236+
#### 2.0 Demo Criteria
237+
238+
- User can perform Z with persisted state
239+
240+
#### 2.0 Proof Artifact(s)
241+
242+
- Screenshot of flow
243+
- Link to test suite section
244+
245+
#### 2.0 Tasks
246+
247+
- [ ] 2.1 [Sub-task description 2.1]
248+
- [ ] 2.2 [Sub-task description 2.2]
249+
250+
### [ ] 3.0 Parent Task Title
251+
252+
#### 3.0 Demo Criteria
253+
254+
- Configuration is verifiable via command/output
255+
256+
#### 3.0 Proof Artifact(s)
257+
258+
- CLI: config get … -> expected value
259+
- Log line
260+
- Diff link
261+
262+
#### 3.0 Tasks
263+
264+
- [ ] 3.1 [Sub-task description 3.1]
265+
- [ ] 3.2 [Sub-task description 3.2]
193266
```
194267

195268
## Interaction Model

0 commit comments

Comments
 (0)