Add explicit-task-dependencies community preset to catalog and README #2091
Add explicit-task-dependencies community preset to catalog and README #2091Quratulain-bilal wants to merge 1 commit intogithub:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the tasks/spec templates to support explicit inter-task dependency declarations and to document an execution-wave view of the dependency graph for parallelizable scheduling.
Changes:
- Add optional
(depends on T###, ...)suffix to the documented task checklist format. - Update sample tasks to include dependency annotations.
- Replace the prior “Parallel Example” section with an Execution Wave DAG example grouped by dependency resolution.
Show a summary per file
| File | Description |
|---|---|
| templates/tasks-template.md | Documents dependency suffix, annotates sample tasks, and adds an Execution Wave DAG example. |
| templates/commands/tasks.md | Updates task-generation instructions to include dependency suffixes and the Execution Wave DAG section. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comments suppressed due to low confidence (1)
templates/tasks-template.md:240
- In the Execution Wave DAG, Wave 8 shows T016/T017 as
[P], but in the User Story 1 checklist those tasks are not marked[P]. Please make the DAG and the checklist agree (either mark them[P]in the checklist or drop the[P]annotation here).
Wave 8:
T016 [US1] Validation (depends on T015) [P]
T017 [US1] Logging (depends on T015) [P]
T023 [US2] Integrate with US1 (depends on T022)
- Files reviewed: 2/2 changed files
- Comments generated: 4
mnriem
left a comment
mnriem
left a comment
There was a problem hiding this comment.
Please address Copilot feedback. If not applicable, please explain why
|
Addressed all 4 Copilot review comments:
|
There was a problem hiding this comment.
Pull request overview
Updates the task authoring templates to support explicit inter-task dependency declarations and to present task execution order as a dependency-resolved “Execution Wave DAG” to enable parallel scheduling.
Changes:
- Adds optional
(depends on T###, ...)suffix to the documented task checklist format. - Replaces the prior parallel-examples prose with an Execution Wave DAG section in the tasks template.
- Updates
/taskscommand guidance to instruct dependency suffix usage and Wave DAG generation.
Show a summary per file
| File | Description |
|---|---|
| templates/tasks-template.md | Documents dependency suffix syntax, annotates sample tasks with dependencies, and adds an Execution Wave DAG section. |
| templates/commands/tasks.md | Updates task generation rules to include dependency suffix and directs generation of an Execution Wave DAG. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comments suppressed due to low confidence (1)
templates/tasks-template.md:216
- In the Wave 3 heading, the text implies T004/T005/T006/T008/T009 depend on completion of T002 and T003, but those dependencies aren’t shown on the tasks themselves (despite the template introducing an explicit
(depends on ...)syntax). Either add explicit(depends on T002, T003)to the relevant tasks in this example, or reword the wave heading so it doesn’t assert undeclared dependencies.
Wave 3 (Phase 2 — T002, T003 done):
T004 Setup database schema
T005 Implement auth framework [P]
T006 Setup API routing [P]
T008 Configure error handling [P]
T009 Setup environment config [P]
- Files reviewed: 2/2 changed files
- Comments generated: 3
mnriem
left a comment
mnriem
left a comment
There was a problem hiding this comment.
Please address Copilot feedback
|
Addressed all 3 Copilot comments:
|
There was a problem hiding this comment.
Pull request overview
Adds explicit inter-task dependency notation to the tasks template/command docs and introduces an “Execution Wave DAG” representation to help agents schedule parallelizable work based on dependency resolution order.
Changes:
- Extend task checklist format to optionally include a
(depends on T###, ...)suffix for explicit task-level dependencies. - Replace the prior prose “Parallel Example” with a structured Execution Wave DAG section in the tasks template.
- Update
/taskscommand guidance to require dependency suffixes for dependent tasks and to generate the Execution Wave DAG.
Show a summary per file
| File | Description |
|---|---|
| templates/tasks-template.md | Updates task format documentation, annotates sample tasks with dependency suffixes, and adds an Execution Wave DAG example. |
| templates/commands/tasks.md | Updates generation instructions and checklist format to include dependency suffix and require generating an Execution Wave DAG. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comments suppressed due to low confidence (1)
templates/tasks-template.md:228
- The Execution Wave DAG example appears to be a complete grouping of the sample tasks, but it omits several sample task IDs that are defined above (e.g., T019, T024–T028). This can confuse readers/agents trying to validate that every listed task is represented in the DAG. Consider either including all sample tasks in the DAG or explicitly stating that the DAG is a partial illustration.
Wave 5 (Phase 2 complete — User Stories can begin in parallel):
T010 [P] [US1] Contract test
T011 [P] [US1] Integration test
T012 [P] [US1] Create Entity1 model
T013 [P] [US1] Create Entity2 model
T018 [P] [US2] Contract test
T020 [P] [US2] Create Entity model
- Files reviewed: 2/2 changed files
- Comments generated: 1
mnriem
left a comment
mnriem
left a comment
There was a problem hiding this comment.
Please address Copilot feedback
There was a problem hiding this comment.
Pull request overview
Adds explicit task dependency notation and replaces the prior parallelism guidance with an “Execution Wave DAG” to enable clearer, machine-derivable parallel scheduling.
Changes:
- Extends task checklist format to support an optional
(depends on T###, ...)suffix for explicit dependencies. - Updates the tasks template examples to include dependency annotations and adds an “Execution Wave DAG” section.
- Updates
/taskscommand instructions to require dependency suffixes (when applicable) and to generate the Wave DAG.
Show a summary per file
| File | Description |
|---|---|
| templates/tasks-template.md | Documents dependency suffix, annotates example tasks, and adds an Execution Wave DAG example. |
| templates/commands/tasks.md | Updates task-generation rules to include dependency suffixes and instructs generating an Execution Wave DAG. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comments suppressed due to low confidence (2)
templates/tasks-template.md:97
- T016/T017 are shown without a
[P]marker in the sample task list, but the Execution Wave DAG later labels them as[P]. Please make the[P]markers consistent between the canonical task list examples and the Wave DAG representation.
- [ ] T015 [US1] Implement [endpoint/feature] in src/[location]/[file].py (depends on T014)
- [ ] T016 [US1] Add validation and error handling (depends on T015)
- [ ] T017 [US1] Add logging for user story 1 operations (depends on T015)
templates/tasks-template.md:228
- The Execution Wave DAG appears to be derived from the sample tasks above, but it omits some of them (e.g., T019 and the US3 test tasks). If the DAG is intentionally partial, call that out explicitly; otherwise, include all sample tasks so the example stays internally consistent.
Wave 5 (Phase 2 complete — User Stories can begin in parallel):
T010 [P] [US1] Contract test
T011 [P] [US1] Integration test
T012 [P] [US1] Create Entity1 model
T013 [P] [US1] Create Entity2 model
T018 [P] [US2] Contract test
T020 [P] [US2] Create Entity model
- Files reviewed: 2/2 changed files
- Comments generated: 1
|
Please address Copilot feedback |
|
Addressed Copilot's cross-phase dependency feedback: all sample tasks now declare explicit dependencies |
There was a problem hiding this comment.
Pull request overview
Adds explicit task-level dependency notation to the tasks template and updates the /tasks command guidance to support generating an Execution Wave DAG for parallelizable scheduling.
Changes:
- Extend task format to optionally append
[(depends on ...)]for explicit inter-task dependencies. - Replace the “Parallel Example” prose with a structured “Execution Wave DAG” section in the tasks template.
- Update
/tasksgeneration rules to require dependency suffixes and instruct Wave DAG generation.
Show a summary per file
| File | Description |
|---|---|
| templates/tasks-template.md | Documents dependency suffix, annotates sample tasks with dependencies, and introduces an Execution Wave DAG section. |
| templates/commands/tasks.md | Updates required task format to include dependency suffix and instructs generation of an Execution Wave DAG. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 2/2 changed files
- Comments generated: 3
|
Please address Copilot feedback |
|
Addressed all 3 Copilot comments: 1. Renumbered Phase 2 tasks so IDs are monotonic with Wave DAG order — independent tasks (T005-T008) come before the blocking base-models task (T009) 2. Execution Wave DAG now includes all sample tasks (US1, US2, US3) — no longer a partial excerpt 3. Clarified Task ID is a "sequential identifier in declaration order" with execution order derived from dependencies and the Wave DAG |
There was a problem hiding this comment.
Pull request overview
Updates the task list templates to support explicit inter-task dependency tracking and to document parallelizable execution via a wave-based DAG, enabling better scheduling for agents and tooling.
Changes:
- Adds optional
(depends on T###, ...)suffix to the documented task format and updates sample tasks to include dependencies. - Replaces the “Parallel Example” prose section with an Execution Wave DAG grouped by dependency resolution.
- Updates the
/speckit.taskscommand template to require dependency suffixes and to instruct generating the Wave DAG.
Show a summary per file
| File | Description |
|---|---|
| templates/tasks-template.md | Documents dependency suffix, annotates sample tasks with dependencies, and adds an Execution Wave DAG section. |
| templates/commands/tasks.md | Updates task format rules to include dependency suffix and mandates generating an Execution Wave DAG. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 2/2 changed files
- Comments generated: 2
|
Fixed: removed [P] from T016/T017 in the Execution Wave DAG to match the checklist where they are not |
|
Looks like this also has so many cascading issues. We might want to reserve this also for a preset? So you can test it out and see its impact? |
Registers the explicit-task-dependencies preset in the community catalog and README. The preset adds (depends on T###) dependency declarations and an Execution Wave DAG to tasks.md. Preset repository: https://github.com/Quratulain-bilal/spec-kit-preset-explicit-task-dependencies Related to github#1934
Quratulain-bilal
force-pushed
the
feat/explicit-task-dependencies
branch
from
3dfefb4 to
9fa1104
Compare
Quratulain-bilal
changed the title
|
Converted to a community preset per maintainer feedback. The PR now only adds a catalog entry and README |
There was a problem hiding this comment.
Pull request overview
Registers the explicit-task-dependencies community preset in the community preset catalog and surfaces it in the README’s Community Presets table.
Changes:
- Added
explicit-task-dependenciestopresets/catalog.community.json(v1.0.0, repo + download URL, metadata). - Added a corresponding row to the Community Presets table in
README.md.
Show a summary per file
| File | Description |
|---|---|
| README.md | Adds the preset to the Community Presets table with a short purpose/URL entry. |
| presets/catalog.community.json | Registers the preset in the community preset catalog with version, URLs, requirements, and tags. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 2/2 changed files
- Comments generated: 0 new
|
Thank you for the review and approval! All checks are passing and this is ready to merge whenever convenient. |
Summary
Registers the [explicit-task-dependencies](https://github.com/Quratulain-bilal/spec-kit-preset-explicit-ta
sk-dependencies) community preset in the catalog and README.
The dependency tracking functionality is delivered as a standalone community preset (per maintainer
guidance), not as core template changes. The preset lives in its own repository with a v1.0.0 release.
Changes in this PR:
explicit-task-dependenciesentry topresets/catalog.community.jsonREADME.mdPreset repository: https://github.com/Quratulain-bilal/spec-kit-preset-explicit-task-dependencies
Related to #1934 — explicit task dependency declarations delivered as a community preset.