mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-10 17:11:04 +08:00
29a1fea467
- Introduced a comprehensive template for generating epics and stories in Phase 5, including an index and individual epic files. - Created a product brief template for Phase 2 to summarize product vision, goals, and target users. - Developed a requirements PRD template for Phase 3, outlining functional and non-functional requirements, along with traceability matrices. feat: Implement tech debt roles for assessment, execution, planning, scanning, validation, and analysis - Added roles for tech debt assessment, executor, planner, scanner, validator, and analyst, each with defined phases and processes for managing technical debt. - Each role includes structured input requirements, processing strategies, and output formats to ensure consistency and clarity in tech debt management.
3.6 KiB
3.6 KiB
Pipeline Definitions — Team Roadmap Dev
Pipeline Mode
Single Phase Pipeline
PLAN-101 --> EXEC-101 --> VERIFY-101
[planner] [executor] [verifier]
|
gap found?
YES (< 3x)
|
PLAN-102 --> EXEC-102 --> VERIFY-102
|
gap found?
YES (>= 3x) -> AskUser: continue/retry/stop
NO -> Complete
Multi-Phase Pipeline
Phase 1: PLAN-101 --> EXEC-101 --> VERIFY-101
|
[gap closure loop]
|
Phase 1 passed
|
Phase 2: PLAN-201 --> EXEC-201 --> VERIFY-201
|
[gap closure loop]
|
Phase 2 passed
|
Phase N: PLAN-N01 --> EXEC-N01 --> VERIFY-N01
|
[gap closure loop]
|
All phases done -> Complete
Task Metadata Registry
| Task ID | Role | Phase | Dependencies | Description |
|---|---|---|---|---|
| PLAN-N01 | planner | phase N | (none or previous VERIFY) | Context research + IMPL-*.json task generation |
| EXEC-N01 | executor | phase N | PLAN-N01 | Wave-based code implementation following IMPL-*.json plans |
| VERIFY-N01 | verifier | phase N | EXEC-N01 | Convergence criteria check + gap detection |
| PLAN-N02 | planner | phase N (gap closure 1) | VERIFY-N01 | Gap-targeted re-plan |
| EXEC-N02 | executor | phase N (gap closure 1) | PLAN-N02 | Gap fix execution |
| VERIFY-N02 | verifier | phase N (gap closure 1) | EXEC-N02 | Re-verify after gap fixes |
Task Naming Rules
| Type | Pattern | Example |
|---|---|---|
| Plan | PLAN-{phase}01 |
PLAN-101, PLAN-201 |
| Execute | EXEC-{phase}01 |
EXEC-101, EXEC-201 |
| Verify | VERIFY-{phase}01 |
VERIFY-101 |
| Gap Plan | PLAN-{phase}{iteration+1} |
PLAN-102 (gap 1), PLAN-103 (gap 2) |
| Gap Execute | EXEC-{phase}{iteration+1} |
EXEC-102, EXEC-103 |
| Gap Verify | VERIFY-{phase}{iteration+1} |
VERIFY-102, VERIFY-103 |
Checkpoints
| Checkpoint | Trigger | Behavior |
|---|---|---|
| Plan gate (optional) | PLAN-N01 complete | If config.gates.plan_check=true: AskUser to approve/revise/skip |
| Phase transition | VERIFY-N01 complete, no gaps | If config.mode=interactive: AskUser to proceed/review/stop |
| Gap closure | VERIFY-N01 complete, gaps found | Auto-create PLAN-N02/EXEC-N02/VERIFY-N02 (max 3 iterations) |
| Gap limit | gap_iteration >= 3 | AskUser: continue anyway / retry once more / stop |
| Pipeline complete | All phases passed | AskUser: archive & clean / keep active / export results |
State Machine Coordinates
{
"current_phase": 1,
"total_phases": 3,
"gap_iteration": 0,
"step": "plan | exec | verify | gap_closure | transition",
"status": "running | paused | complete"
}
Role-Worker Map
| Prefix | Role | Role Spec | Inner Loop |
|---|---|---|---|
| PLAN | planner | .claude/skills/team-roadmap-dev/roles/planner/role.md |
true |
| EXEC | executor | .claude/skills/team-roadmap-dev/roles/executor/role.md |
true |
| VERIFY | verifier | .claude/skills/team-roadmap-dev/roles/verifier/role.md |
true |