claude-code-workflow 7.2.15 → 7.2.16

package/.codex/skills/team-roadmap-dev/roles/verifier/role.md

@@ -0,0 +1,74 @@
+---
+role: verifier
+prefix: VERIFY
+inner_loop: true
+cli_tools:
+  - gemini --mode analysis
+message_types:
+  success: verify_passed
+  failure: gaps_found
+  error: error
+---
+
+# Verifier
+
+Goal-backward verification per phase. Reads convergence criteria from IMPL-*.json task files and checks against actual codebase state. Read-only — never modifies code. Produces verification.md with pass/fail and structured gap lists.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task JSONs | <session>/phase-{N}/.task/IMPL-*.json | Yes |
+| Summaries | <session>/phase-{N}/summary-*.md | Yes |
+| Wisdom | <session>/wisdom/ | No |
+
+1. Glob IMPL-*.json files, extract convergence criteria from each task
+2. Glob summary-*.md files, parse frontmatter (task, affects, provides)
+3. If no task JSONs or summaries found → error to coordinator
+
+## Phase 3: Goal-Backward Verification
+
+For each task's convergence criteria, execute appropriate check:
+
+| Criteria Type | Method |
+|---------------|--------|
+| File existence | `test -f <path>` |
+| Command execution | Run command, check exit code |
+| Pattern match | Grep for pattern in specified files |
+| Semantic check | Optional: Gemini CLI (`--mode analysis --rule analysis-review-code-quality`) |
+
+**Per task scoring**:
+
+| Result | Condition |
+|--------|-----------|
+| pass | All criteria met |
+| partial | Some criteria met |
+| fail | No criteria met or critical check failed |
+
+Collect all gaps from partial/failed tasks with structured format:
+- task ID, criteria type, expected value, actual value
+
+## Phase 4: Compile Results
+
+1. Aggregate per-task results: count passed, partial, failed
+2. Determine overall status:
+   - `passed` if gaps.length === 0
+   - `gaps_found` otherwise
+3. Write `<session>/phase-{N}/verification.md`:
+
+```yaml
+---
+phase: <N>
+status: passed | gaps_found
+tasks_checked: <count>
+tasks_passed: <count>
+gaps:
+  - task: "<task-id>"
+    type: "<criteria-type>"
+    item: "<description>"
+    expected: "<expected>"
+    actual: "<actual>"
+---
+```
+
+4. Update .msg/meta.json with verification summary

package/.codex/skills/team-roadmap-dev/specs/pipelines.md

@@ -0,0 +1,93 @@
+# 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
+
+```json
+{
+  "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 |

package/.codex/skills/team-roadmap-dev/specs/team-config.json

@@ -0,0 +1,95 @@
+{
+  "team_name": "roadmap-dev",
+  "team_display_name": "Roadmap Dev",
+  "skill_name": "team-roadmap-dev",
+  "skill_path": "~  or <project>/.claude/skills/team-roadmap-dev/",
+  "design_source": "roadmap-driven development workflow design (2026-02-24)",
+  "pipeline_type": "Phased",
+  "pipeline": {
+    "stages": [
+      { "name": "PLAN", "role": "planner", "blockedBy": [] },
+      { "name": "EXEC", "role": "executor", "blockedBy": ["PLAN"] },
+      { "name": "VERIFY", "role": "verifier", "blockedBy": ["EXEC"] }
+    ],
+    "diagram": "Coordinator (roadmap) → PLAN → EXEC → VERIFY → Coordinator (transition)",
+    "gap_closure": "VERIFY fails → PLAN (gaps) → EXEC (gaps) → VERIFY (re-check), max 3 iterations"
+  },
+  "roles": [
+    {
+      "name": "coordinator",
+      "display_name": "RD Coordinator",
+      "responsibility_type": "Orchestration",
+      "task_prefix": null,
+      "description": "Human interaction, roadmap discussion, phase transitions, state management",
+      "commands": ["roadmap-discuss", "dispatch", "monitor", "pause", "resume"],
+      "message_types": ["phase_started", "phase_complete", "gap_closure", "project_complete", "error"]
+    },
+    {
+      "name": "planner",
+      "display_name": "RD Planner",
+      "responsibility_type": "Orchestration",
+      "task_prefix": "PLAN",
+      "description": "Research, context gathering, task JSON generation via CLI planning tool",
+      "commands": ["research", "create-plans"],
+      "cli_tools": [{"tool": "gemini", "mode": "analysis"}],
+      "message_types": ["plan_ready", "plan_progress", "error"]
+    },
+    {
+      "name": "executor",
+      "display_name": "RD Executor",
+      "responsibility_type": "Code generation",
+      "task_prefix": "EXEC",
+      "description": "Code implementation from IMPL-*.json tasks, wave-based parallel execution",
+      "commands": ["implement"],
+      "cli_tools": [{"tool": "gemini", "mode": "write"}],
+      "message_types": ["exec_complete", "exec_progress", "error"]
+    },
+    {
+      "name": "verifier",
+      "display_name": "RD Verifier",
+      "responsibility_type": "Validation",
+      "task_prefix": "VERIFY",
+      "description": "Convergence criteria verification, gap detection, fix loop trigger",
+      "commands": ["verify"],
+      "cli_tools": [{"tool": "gemini", "mode": "analysis"}],
+      "message_types": ["verify_passed", "gaps_found", "error"]
+    }
+  ],
+  "artifacts": {
+    "fixed": {
+      "roadmap.md": {
+        "created_by": "coordinator (roadmap-discuss)",
+        "purpose": "Phase plan with requirements and success criteria",
+        "lifecycle": "Created once, updated at phase transitions"
+      },
+      "state.md": {
+        "created_by": "coordinator",
+        "purpose": "Living memory (<100 lines)",
+        "lifecycle": "Updated every significant action"
+      },
+      "config.json": {
+        "created_by": "coordinator (roadmap-discuss)",
+        "purpose": "Session settings: mode, depth, gates",
+        "lifecycle": "Created once, rarely updated"
+      }
+    },
+    "dynamic": {
+      "context.md": { "created_by": "planner (research)", "per": "phase" },
+      "IMPL_PLAN.md": { "created_by": "planner (create-plans)", "per": "phase", "purpose": "Implementation overview with task dependency graph" },
+      "IMPL-*.json": { "created_by": "planner (create-plans)", "per": "phase", "path": ".task/", "schema": "unified-flat-schema", "purpose": "Task JSON files with convergence criteria" },
+      "TODO_LIST.md": { "created_by": "planner (create-plans)", "per": "phase", "purpose": "Checklist tracking for all tasks" },
+      "summary-{ID}.md": { "created_by": "executor (implement)", "per": "task", "yaml_frontmatter": true },
+      "verification.md": { "created_by": "verifier (verify)", "per": "phase" }
+    }
+  },
+  "init_prerequisite": {
+    "required_files": [".workflow/project-tech.json"],
+    "optional_files": [".workflow/specs/*.md"],
+    "init_command": "/workflow:spec:setup "
+  },
+  "_metadata": {
+    "created_at": "2026-02-24",
+    "version": "1.1.0",
+    "based_on": "roadmap-driven development workflow design"
+  }
+}