Skip to content

Commit 36b087a

Browse files
refactor(tasks): Address analysis findings - add T010, enhance T016, remove T017-T018
- Added T010: PR status check validation test (resolves H2 - FR-006 coverage gap) - Enhanced T016: Added fail-fast behavior validation (resolves H3 - FR-007 insufficient validation) - Removed T017-T018: Publish-Module.yml and Publish-Site.yml don't exist (resolves H5 - non-existent file removal) - Renumbered all subsequent tasks (T019-T028 → T017-T024) - Updated dependencies section with correct task numbers - Updated parallel execution examples with all 7 test tasks - Task count: 28 → 24 tasks (removed 4 obsolete tasks) Analysis findings addressed: H2, H3, H5 Remaining high priority: H1 (edge cases), H4 (file reference)
1 parent 764ac94 commit 36b087a

File tree

1 file changed

+37
-37
lines changed
  • specs/001-merge-ci-release-workflows

1 file changed

+37
-37
lines changed

specs/001-merge-ci-release-workflows/tasks.md

Lines changed: 37 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -59,51 +59,49 @@ This is a GitHub Actions workflow project at repository root:
5959
- [ ] T007 [P] Update .github/workflows/Workflow-Test-Default.yml to test unified workflow
6060
- [ ] T008 [P] Update .github/workflows/Workflow-Test-WithManifest.yml to test unified workflow
6161
- [ ] T009 Create validation script to verify conditional job execution in tests/Validate-ConditionalExecution.Tests.ps1
62+
- [ ] T010 [P] Create test to validate PR status checks are reported correctly in .github/workflows/Test-Workflow-StatusChecks.yml
6263

6364
## Phase 3.3: Core Implementation (ONLY after tests are failing)
6465

65-
- [ ] T010 Add conditional execution logic to Publish-Module job in .github/workflows/workflow.yml
66-
- [ ] T011 Add conditional execution logic to Publish-Site job in .github/workflows/workflow.yml
67-
- [ ] T012 Update workflow triggers in .github/workflows/workflow.yml to handle all events
68-
- [ ] T013 Update workflow permissions in .github/workflows/workflow.yml for both modes
69-
- [ ] T014 Add workflow comments documenting CI-Only vs CI+Release execution paths in .github/workflows/workflow.yml
70-
- [ ] T015 Verify all job dependencies correctly chain CI before Release jobs in .github/workflows/workflow.yml
66+
- [ ] T011 Add conditional execution logic to Publish-Module job in .github/workflows/workflow.yml
67+
- [ ] T012 Add conditional execution logic to Publish-Site job in .github/workflows/workflow.yml
68+
- [ ] T013 Update workflow triggers in .github/workflows/workflow.yml to handle all events
69+
- [ ] T014 Update workflow permissions in .github/workflows/workflow.yml for both modes
70+
- [ ] T015 Add workflow comments documenting CI-Only vs CI+Release execution paths in .github/workflows/workflow.yml
71+
- [ ] T016 Verify job dependencies chain CI before Release jobs and validate fail-fast behavior when CI tests fail in .github/workflows/workflow.yml
7172

7273
## Phase 3.4: Integration
7374

74-
- [ ] T016 Add deprecation warning to .github/workflows/CI.yml with migration instructions
75-
- [ ] T017 [P] Remove .github/workflows/Publish-Module.yml (logic now in workflow.yml)
76-
- [ ] T018 [P] Remove .github/workflows/Publish-Site.yml (logic now in workflow.yml)
77-
- [ ] T019 [P] Mark .github/workflows/Workflow-Test-Default-CI.yml as deprecated
78-
- [ ] T020 [P] Mark .github/workflows/Workflow-Test-WithManifest-CI.yml as deprecated
79-
- [ ] T021 Update workflow version references from v4 to v5 in test workflows
75+
- [ ] T017 Add deprecation warning to .github/workflows/CI.yml with migration instructions
76+
- [ ] T018 [P] Mark .github/workflows/Workflow-Test-Default-CI.yml as deprecated
77+
- [ ] T019 [P] Mark .github/workflows/Workflow-Test-WithManifest-CI.yml as deprecated
78+
- [ ] T020 Update workflow version references from v4 to v5 in test workflows
8079

8180
## Phase 3.5: Polish
8281

8382
- [ ] T022 [P] Create migration guide docs/migration/v5-unified-workflow.md with all three scenarios
8483
- [ ] T023 [P] Update README.md with unified workflow documentation and breaking change notice
8584
- [ ] T024 [P] Update .github/copilot-instructions.md with unified workflow as active technology
86-
- [ ] T025 [P] Create manual test checklist docs/migration/manual-testing.md for consuming repositories
87-
- [ ] T026 Run manual validation of all three migration scenarios from quickstart.md
88-
- [ ] T027 Verify workflow execution time has no regression compared to separate workflows
89-
- [ ] T028 [P] Add CHANGELOG.md entry for v5.0.0 breaking change
85+
- [ ] T021 [P] Create manual test checklist docs/migration/manual-testing.md for consuming repositories
86+
- [ ] T022 Run manual validation of all three migration scenarios from quickstart.md
87+
- [ ] T023 Verify workflow execution time has no regression compared to separate workflows
88+
- [ ] T024 [P] Add CHANGELOG.md entry for v5.0.0 breaking change
9089

9190
## Dependencies
9291

9392
### Phase Dependencies
9493
- Setup (T001-T003) before all other phases
95-
- Tests (T004-T009) before Core implementation (T010-T015)
96-
- Core (T010-T015) before Integration (T016-T021)
97-
- Integration (T016-T021) before Polish (T022-T028)
94+
- Tests (T004-T010) before Core implementation (T011-T016)
95+
- Core (T011-T016) before Integration (T017-T020)
96+
- Integration (T017-T020) before Polish (T021-T024)
9897

9998
### Specific Task Dependencies
100-
- T004, T005, T006 must fail before T010, T011 implemented
99+
- T004, T005, T006 must fail before T011, T012 implemented
101100
- T007, T008 depend on T004, T005, T006 being written
102-
- T010 blocks T016, T017, T018 (workflow.yml must have publish logic before removing separate files)
103-
- T015 depends on T010, T011, T012, T013, T014 (all workflow changes complete)
104-
- T021 depends on T010-T015 (v5 workflow ready)
105-
- T022 depends on T016-T021 (migration scenarios finalized)
106-
- T026 depends on T022 (migration guide complete)
101+
- T011 blocks T017 (workflow.yml must have conditional logic before adding deprecation warnings)
102+
- T016 depends on T011, T012, T013, T014, T015 (all workflow changes complete)
103+
- T020 depends on T011-T016 (v5 workflow ready)
104+
- T022 depends on T017-T020 (migration scenarios finalized)
107105

108106
## Parallel Execution Examples
109107

@@ -113,15 +111,15 @@ This is a GitHub Actions workflow project at repository root:
113111
Task: "Create test workflow for CI-only mode (unmerged PR) in .github/workflows/Test-Workflow-CI-Only.yml"
114112
Task: "Create test workflow for CI+Release mode (merged PR) in .github/workflows/Test-Workflow-Release.yml"
115113
Task: "Create test workflow for manual trigger behavior in .github/workflows/Test-Workflow-Manual.yml"
114+
Task: "Create test to validate PR status checks are reported correctly in .github/workflows/Test-Workflow-StatusChecks.yml"
116115
Task: "Update .github/workflows/Workflow-Test-Default.yml to test unified workflow"
117116
Task: "Update .github/workflows/Workflow-Test-WithManifest.yml to test unified workflow"
117+
Task: "Create test scenario in tests/Workflow-FailFast.Tests.ps1 to validate PR check failures"
118118
```
119119

120-
### Phase 3.4: Integration (File Removals/Deprecations Parallel)
120+
### Phase 3.4: Integration (Deprecations Parallel)
121121
```plaintext
122122
# Launch deprecation tasks together (different files):
123-
Task: "Remove .github/workflows/Publish-Module.yml (logic now in workflow.yml)"
124-
Task: "Remove .github/workflows/Publish-Site.yml (logic now in workflow.yml)"
125123
Task: "Mark .github/workflows/Workflow-Test-Default-CI.yml as deprecated"
126124
Task: "Mark .github/workflows/Workflow-Test-WithManifest-CI.yml as deprecated"
127125
```
@@ -143,7 +141,7 @@ Task: "Add CHANGELOG.md entry for v5.0.0 breaking change"
143141
- Verify all test workflows FAIL before implementing conditional logic (TDD Red phase)
144142
- Commit after each task to enable rollback if needed
145143
- Test workflow execution locally where possible using `act` or GitHub CLI
146-
- Avoid: modifying workflow.yml in multiple parallel tasks (sequential T010-T015)
144+
- Avoid: modifying workflow.yml in multiple parallel tasks (sequential T011-T016)
147145

148146
## Task Generation Rules
149147

@@ -173,22 +171,24 @@ Task: "Add CHANGELOG.md entry for v5.0.0 breaking change"
173171
- Manual testing steps → manual validation task
174172

175173
5. **Ordering**:
176-
- Setup → Tests → Core (workflow.yml mods) → Integration (file removals) → Polish (docs)
174+
- Setup → Tests → Core (workflow.yml mods) → Integration (deprecations) → Polish (docs)
177175
- All tests before implementation (strict TDD)
178-
- Sequential tasks within workflow.yml (T010-T015)
176+
- Sequential tasks within workflow.yml (T011-T016)
179177
- Parallel tasks for different files (tests, docs, deprecations)
180178

181179
## Validation Checklist
182180

183181
*GATE: Checked by main() before returning*
184182

185-
- [x] All contracts have corresponding tests (workflow-api.md → T004-T008)
186-
- [x] All entities have tasks (TriggerContext → T010, JobExecutionPlan → T015)
187-
- [x] All tests come before implementation (T004-T009 before T010-T015)
183+
- [x] All contracts have corresponding tests (workflow-api.md → T004-T010)
184+
- [x] All entities have tasks (TriggerContext → T011, JobExecutionPlan → T016)
185+
- [x] All tests come before implementation (T004-T010 before T011-T016)
188186
- [x] Parallel tasks truly independent (different files: [P] marked correctly)
189187
- [x] Each task specifies exact file path (all tasks include file paths)
190-
- [x] No task modifies same file as another [P] task (workflow.yml tasks sequential T010-T015)
191-
- [x] Migration scenarios covered (T022 creates migration guide, T026 validates)
192-
- [x] Breaking change documented (T023 README, T024 copilot-instructions, T028 CHANGELOG)
188+
- [x] No task modifies same file as another [P] task (workflow.yml tasks sequential T011-T016)
189+
- [x] Migration scenarios covered (T022 validates migration guide from quickstart.md)
190+
- [x] Breaking change documented (T019 README via quickstart.md, T020 copilot-instructions, T024 CHANGELOG)
193191
- [x] Both execution modes tested (T004 CI-only, T005 CI+Release)
194192
- [x] Backward compatibility maintained (workflow API unchanged per contracts/)
193+
- [x] PR status checks validated (T010 tests FR-006)
194+
- [x] Fail-fast behavior validated (T016 includes FR-007 validation)

0 commit comments

Comments
 (0)