Skip to content

Commit 147db0c

Browse files
ryderstormOpenCode
andcommitted
feat(prompts): format relevant files as table
Update SDD-2 so generated task files present the Relevant Files section as a markdown table instead of a bullet list. This makes planned file coverage easier to scan during task review without changing the underlying workflow. Co-Authored-By: OpenCode <no-reply@example.com>
1 parent fdb9a57 commit 147db0c

File tree

1 file changed

+12
-10
lines changed

1 file changed

+12
-10
lines changed

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

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -191,9 +191,9 @@ Do not proceed to Phase 2 until you produce a standards evidence table with:
191191

192192
Wait for explicit user confirmation before generating sub-tasks. Then:
193193

194-
1. **Identify Relevant Files:** List all files that will need creation or modification
194+
1. **Identify Relevant Files:** Capture all files that will need creation or modification in a markdown table
195195
2. **Generate Sub-Tasks:** Break down each parent task into smaller, actionable sub-tasks
196-
3. **Update Task List:** Update the existing `./docs/specs/[NN]-spec-[feature-name]/[NN]-tasks-[feature-name].md` file with the sub-tasks and relevant files sections
196+
3. **Update Task List:** Update the existing `./docs/specs/[NN]-spec-[feature-name]/[NN]-tasks-[feature-name].md` file with the sub-tasks and relevant files table sections
197197

198198
### Phase 4: Planning Audit Gate (Required)
199199

@@ -291,12 +291,14 @@ After user confirmation in Phase 3, update the file with this complete structure
291291
```markdown
292292
## Relevant Files
293293

294-
- `path/to/potential/file1.ts` - Brief description of why this file is relevant (e.g., Contains the main component for this feature).
295-
- `path/to/file1.test.ts` - Unit tests for `file1.ts`.
296-
- `path/to/another/file.tsx` - Brief description (e.g., API route handler for data submission).
297-
- `path/to/another/file.test.tsx` - Unit tests for `another/file.tsx`.
298-
- `lib/utils/helpers.ts` - Brief description (e.g., Utility functions needed for calculations).
299-
- `lib/utils/helpers.test.ts` - Unit tests for `helpers.ts`.
294+
| File | Why It Is Relevant |
295+
| --- | --- |
296+
| `path/to/potential/file1.ts` | Contains the main component or implementation entry point for this feature. |
297+
| `path/to/file1.test.ts` | Unit tests for `file1.ts`. |
298+
| `path/to/another/file.tsx` | API route handler or UI entry point for data submission. |
299+
| `path/to/another/file.test.tsx` | Unit tests for `another/file.tsx`. |
300+
| `lib/utils/helpers.ts` | Utility functions needed for calculations or shared behavior. |
301+
| `lib/utils/helpers.test.ts` | Unit tests for `helpers.ts`. |
300302

301303
### Notes
302304

@@ -437,7 +439,7 @@ Before finalizing your task list, verify:
437439
- [ ] Tasks are appropriately scoped (not too large/small)
438440
- [ ] Dependencies are logical and sequential
439441
- [ ] Sub-tasks are actionable and unambiguous
440-
- [ ] Relevant files are comprehensive and accurate
442+
- [ ] Relevant files table is comprehensive, accurate, and easy to scan
441443
- [ ] Format follows the exact structure specified above
442444
- [ ] Repository standards and patterns are identified and incorporated
443445
- [ ] Implementation will follow established coding conventions and workflows
@@ -457,7 +459,7 @@ Only after REQUIRED audit gates pass, instruct the user to run `/SDD-3-manage-ta
457459
3. Generate high-level tasks that represent demoable units of work (adjust count based on spec complexity) and save them to `./docs/specs/[NN]-spec-[feature-name]/[NN]-tasks-[feature-name].md`
458460
4. **CRITICAL**: Stop after generating parent tasks and wait for "Generate sub tasks" confirmation before proceeding.
459461
5. Ensure every parent task has specific Proof Artifacts that demonstrate what will be shown
460-
6. Identify all relevant files for creation/modification
462+
6. Identify all relevant files for creation/modification and present them in the required markdown table format
461463
7. Run the planning audit gate and create `[NN]-audit-[feature-name].md`
462464
8. Present findings and remediation plan; wait for explicit approval before remediation edits
463465
9. Run the Chain-of-Verification check before handoff decisions

0 commit comments

Comments
 (0)