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-26 19:56:37 +08:00 · 2026-03-24 16:54:48 +08:00
parent 54283e5dbb
commit 1e560ab8e8
334 changed files with 28996 additions and 35516 deletions
--- a/.codex/skills/team-iterdev/specs/pipelines.md
+++ b/.codex/skills/team-iterdev/specs/pipelines.md
@@ -0,0 +1,94 @@
+# IterDev Pipeline Definitions
+
+## Three-Pipeline Architecture
+
+### Patch Pipeline (2 beats, serial)
+
+```
+DEV-001 -> VERIFY-001
+[developer]  [tester]
+```
+
+### Sprint Pipeline (4 beats, with parallel window)
+
+```
+DESIGN-001 -> DEV-001 -> [VERIFY-001 + REVIEW-001] (parallel)
+[architect]   [developer]  [tester]       [reviewer]
+```
+
+### Multi-Sprint Pipeline (N beats, iterative)
+
+```
+Sprint 1: DESIGN-001 -> DEV-001 -> DEV-002(incremental) -> VERIFY-001 -> DEV-fix -> REVIEW-001
+Sprint 2: DESIGN-002(refined) -> DEV-003 -> VERIFY-002 -> REVIEW-002
+...
+```
+
+## Generator-Critic Loop (developer <-> reviewer)
+
+```
+DEV -> REVIEW -> (if review.critical_count > 0 || review.score < 7)
+              -> DEV-fix -> REVIEW-2 -> (if still issues) -> DEV-fix-2 -> REVIEW-3
+              -> (max 3 rounds, then accept with warning)
+```
+
+## Pipeline Selection Logic
+
+| Signal | Score |
+|--------|-------|
+| Changed files > 10 | +3 |
+| Changed files 3-10 | +2 |
+| Structural change | +3 |
+| Cross-cutting concern | +2 |
+| Simple fix | -2 |
+
+| Score | Pipeline |
+|-------|----------|
+| >= 5 | multi-sprint |
+| 2-4 | sprint |
+| 0-1 | patch |
+
+## Task Metadata Registry
+
+| Task ID | Role | Pipeline | Dependencies | Description |
+|---------|------|----------|-------------|-------------|
+| DESIGN-001 | architect | sprint/multi | (none) | Technical design and task breakdown |
+| DEV-001 | developer | all | DESIGN-001 (sprint/multi) or (none for patch) | Code implementation |
+| DEV-002 | developer | multi | DEV-001 | Incremental implementation |
+| DEV-fix | developer | sprint/multi | REVIEW-* (GC loop trigger) | Fix issues from review |
+| VERIFY-001 | tester | all | DEV-001 (or last DEV) | Test execution and fix cycles |
+| REVIEW-001 | reviewer | sprint/multi | DEV-001 (or last DEV) | Code review and quality scoring |
+
+## Checkpoints
+
+| Trigger Condition | Location | Behavior |
+|-------------------|----------|----------|
+| GC loop exceeds max rounds | After REVIEW-3 | Stop iteration, accept with warning, record in wisdom |
+| Sprint transition | End of Sprint N | Pause, retrospective, user confirms `resume` for Sprint N+1 |
+| Pipeline stall | No ready + no running tasks | Check missing tasks, report blockedBy chain to user |
+
+## Multi-Sprint Dynamic Downgrade
+
+If Sprint N metrics are strong (velocity >= expected, review avg >= 8), coordinator may downgrade Sprint N+1 from multi-sprint to sprint pipeline for efficiency.
+
+## Task Ledger Schema
+
+| Field | Description |
+|-------|-------------|
+| `sprint_id` | Current sprint identifier |
+| `sprint_goal` | Sprint objective |
+| `tasks[]` | Array of task entries |
+| `metrics` | Aggregated metrics: total, completed, in_progress, blocked, velocity |
+
+**Task Entry Fields**:
+
+| Field | Description |
+|-------|-------------|
+| `id` | Task identifier |
+| `title` | Task title |
+| `owner` | Assigned role |
+| `status` | pending / in_progress / completed / blocked |
+| `started_at` / `completed_at` | Timestamps |
+| `gc_rounds` | Generator-Critic iteration count |
+| `review_score` | Reviewer score (null until reviewed) |
+| `test_pass_rate` | Tester pass rate (null until tested) |
--- a/.codex/skills/team-iterdev/specs/team-config.json
+++ b/.codex/skills/team-iterdev/specs/team-config.json
@@ -0,0 +1,172 @@
+{
+  "team_name": "team-iterdev",
+  "team_display_name": "Team IterDev",
+  "description": "Iterative development team with Generator-Critic loop, task ledger, sprint learning, dynamic pipeline, conflict handling, concurrency control, rollback strategy, user feedback loop, and tech debt tracking",
+  "version": "1.2.0",
+
+  "roles": {
+    "coordinator": {
+      "task_prefix": null,
+      "responsibility": "Sprint planning, backlog management, task ledger maintenance, GC loop control, Phase 1: conflict handling, concurrency control, rollback strategy, Phase 3: user feedback loop, tech debt tracking",
+      "message_types": [
+        "sprint_started", "gc_loop_trigger", "sprint_complete", "task_unblocked", "error", "shutdown",
+        "conflict_detected", "conflict_resolved", "resource_locked", "resource_unlocked", "resource_contention",
+        "rollback_initiated", "rollback_completed", "rollback_failed",
+        "user_feedback_received", "tech_debt_identified"
+      ]
+    },
+    "architect": {
+      "task_prefix": "DESIGN",
+      "responsibility": "Technical design, task decomposition, architecture decisions",
+      "message_types": ["design_ready", "design_revision", "error"]
+    },
+    "developer": {
+      "task_prefix": "DEV",
+      "responsibility": "Code implementation, incremental delivery",
+      "message_types": ["dev_complete", "dev_progress", "error"]
+    },
+    "tester": {
+      "task_prefix": "VERIFY",
+      "responsibility": "Test execution, fix cycle, regression detection",
+      "message_types": ["verify_passed", "verify_failed", "fix_required", "error"]
+    },
+    "reviewer": {
+      "task_prefix": "REVIEW",
+      "responsibility": "Code review, quality scoring, improvement suggestions",
+      "message_types": ["review_passed", "review_revision", "review_critical", "error"]
+    }
+  },
+
+  "pipelines": {
+    "patch": {
+      "description": "Simple fix: implement → verify",
+      "task_chain": ["DEV-001", "VERIFY-001"],
+      "gc_loops": 0
+    },
+    "sprint": {
+      "description": "Standard feature: design → implement → verify + review (parallel)",
+      "task_chain": ["DESIGN-001", "DEV-001", "VERIFY-001", "REVIEW-001"],
+      "gc_loops": 3,
+      "parallel_groups": [["VERIFY-001", "REVIEW-001"]]
+    },
+    "multi-sprint": {
+      "description": "Large feature: multiple sprint cycles with incremental delivery",
+      "task_chain": "dynamic — coordinator creates per-sprint chains",
+      "gc_loops": 3,
+      "sprint_count": "dynamic"
+    }
+  },
+
+  "innovation_patterns": {
+    "generator_critic": {
+      "generator": "developer",
+      "critic": "reviewer",
+      "max_rounds": 3,
+      "convergence_trigger": "review.critical_count === 0 && review.score >= 7"
+    },
+    "task_ledger": {
+      "file": "task-ledger.json",
+      "updated_by": "coordinator",
+      "tracks": ["status", "gc_rounds", "review_score", "test_pass_rate", "velocity"],
+      "phase1_extensions": {
+        "conflict_info": {
+          "fields": ["status", "conflicting_files", "resolution_strategy", "resolved_by_task_id"],
+          "default": { "status": "none", "conflicting_files": [], "resolution_strategy": null, "resolved_by_task_id": null }
+        },
+        "rollback_info": {
+          "fields": ["snapshot_id", "rollback_procedure", "last_successful_state_id"],
+          "default": { "snapshot_id": null, "rollback_procedure": null, "last_successful_state_id": null }
+        }
+      }
+    },
+    "shared_memory": {
+      "file": "shared-memory.json",
+      "fields": {
+        "architect": "architecture_decisions",
+        "developer": "implementation_context",
+        "tester": "test_patterns",
+        "reviewer": "review_feedback_trends"
+      },
+      "persistent_fields": ["sprint_history", "what_worked", "what_failed", "patterns_learned"],
+      "phase1_extensions": {
+        "resource_locks": {
+          "description": "Concurrency control: resource locking state",
+          "lock_timeout_ms": 300000,
+          "deadlock_detection": true
+        }
+      }
+    },
+    "dynamic_pipeline": {
+      "selector": "coordinator",
+      "criteria": "file_count + module_count + complexity_assessment",
+      "downgrade_rule": "velocity >= expected && review_avg >= 8 → simplify next sprint"
+    }
+  },
+
+  "phase1_features": {
+    "conflict_handling": {
+      "enabled": true,
+      "detection_strategy": "file_overlap",
+      "resolution_strategies": ["manual", "auto_merge", "abort"]
+    },
+    "concurrency_control": {
+      "enabled": true,
+      "lock_timeout_minutes": 5,
+      "deadlock_detection": true,
+      "resources": ["task-ledger.json", "shared-memory.json"]
+    },
+    "rollback_strategy": {
+      "enabled": true,
+      "snapshot_trigger": "task_complete",
+      "default_procedure": "git revert HEAD"
+    }
+  },
+
+  "phase2_features": {
+    "external_dependency_management": {
+      "enabled": true,
+      "validation_trigger": "task_start",
+      "supported_sources": ["npm", "maven", "pip", "git"],
+      "version_check_command": {
+        "npm": "npm list {name}",
+        "pip": "pip show {name}",
+        "maven": "mvn dependency:tree"
+      }
+    },
+    "state_recovery": {
+      "enabled": true,
+      "checkpoint_trigger": "phase_complete",
+      "max_checkpoints_per_task": 5,
+      "checkpoint_dir": "checkpoints/"
+    }
+  },
+
+  "phase3_features": {
+    "user_feedback_loop": {
+      "enabled": true,
+      "collection_trigger": "sprint_complete",
+      "max_feedback_items": 50,
+      "severity_levels": ["low", "medium", "high", "critical"],
+      "status_flow": ["new", "reviewed", "addressed", "closed"]
+    },
+    "tech_debt_tracking": {
+      "enabled": true,
+      "detection_sources": ["review", "test", "architect"],
+      "categories": ["code", "design", "test", "documentation"],
+      "severity_levels": ["low", "medium", "high", "critical"],
+      "status_flow": ["open", "in_progress", "resolved", "deferred"],
+      "report_trigger": "sprint_retrospective"
+    }
+  },
+
+  "collaboration_patterns": ["CP-1", "CP-3", "CP-5", "CP-6"],
+
+  "session_dirs": {
+    "base": ".workflow/.team/IDS-{slug}-{YYYY-MM-DD}/",
+    "design": "design/",
+    "code": "code/",
+    "verify": "verify/",
+    "review": "review/",
+    "messages": ".workflow/.team-msg/{team-name}/"
+  }
+}