Files
Claude-Code-Workflow/.codex/skills/team-roadmap-dev/specs/pipelines.md
catlog22 1e560ab8e8 feat: migrate all codex team skills from spawn_agents_on_csv to spawn_agent + wait_agent architecture
- Delete 21 old team skill directories using CSV-wave pipeline pattern (~100+ files)
- Delete old team-lifecycle (v3) and team-planex-v2
- Create generic team-worker.toml and team-supervisor.toml (replacing tlv4-specific TOMLs)
- Convert 19 team skills from Claude Code format (Agent/SendMessage/TaskCreate)
  to Codex format (spawn_agent/wait_agent/tasks.json/request_user_input)
- Update team-lifecycle-v4 to use generic agent types (team_worker/team_supervisor)
- Convert all coordinator role files: dispatch.md, monitor.md, role.md
- Convert all worker role files: remove run_in_background, fix Bash syntax
- Convert all specs/pipelines.md references
- Final state: 20 team skills, 217 .md files, zero Claude Code API residuals

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-24 16:54:48 +08:00

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 ~ or <project>/.claude/skills/team-roadmap-dev/roles/planner/role.md true
EXEC executor ~ or <project>/.claude/skills/team-roadmap-dev/roles/executor/role.md true
VERIFY verifier ~ or <project>/.claude/skills/team-roadmap-dev/roles/verifier/role.md true