claude-code-workflow 7.2.26 → 7.2.28

package/.claude/skills/team-motion-design/specs/team-config.json

@@ -0,0 +1,99 @@
+{
+  "team_name": "motion-design",
+  "team_display_name": "Motion Design",
+  "description": "Motion design team for animation token systems, scroll choreography, GPU-accelerated transforms, reduced-motion fallback",
+  "version": "1.0.0",
+
+  "roles": {
+    "coordinator": {
+      "task_prefix": null,
+      "responsibility": "Scope assessment, pipeline orchestration, performance gate management, GC loop control",
+      "message_types": ["task_unblocked", "perf_checkpoint", "fix_required", "error", "shutdown"]
+    },
+    "motion-researcher": {
+      "task_prefix": "MRESEARCH",
+      "responsibility": "Audit existing animations, measure paint/composite costs, catalog easing patterns",
+      "message_types": ["research_ready", "research_progress", "error"]
+    },
+    "choreographer": {
+      "task_prefix": "CHOREO",
+      "responsibility": "Design animation token system, scroll-triggered reveal sequences, transition state diagrams",
+      "message_types": ["choreography_ready", "choreography_progress", "error"]
+    },
+    "animator": {
+      "task_prefix": "ANIM",
+      "inner_loop": true,
+      "responsibility": "Implement CSS animations/transitions, JS orchestration, IntersectionObserver triggers, rAF coordination",
+      "message_types": ["animation_ready", "animation_revision", "animation_progress", "error"]
+    },
+    "motion-tester": {
+      "task_prefix": "MTEST",
+      "responsibility": "Chrome DevTools perf traces, compositor-only verification, FPS measurement, layout thrashing detection, reduced-motion validation",
+      "message_types": ["perf_passed", "perf_warning", "fix_required", "error"]
+    }
+  },
+
+  "pipelines": {
+    "tokens": {
+      "description": "Animation token system: research -> choreography -> animation -> test",
+      "task_chain": ["MRESEARCH-001", "CHOREO-001", "ANIM-001", "MTEST-001"],
+      "complexity": "low"
+    },
+    "component": {
+      "description": "Component animation: research -> choreography -> animation -> test (GC loop)",
+      "task_chain": ["MRESEARCH-001", "CHOREO-001", "ANIM-001", "MTEST-001"],
+      "gc_loop": { "generator": "ANIM", "critic": "MTEST", "trigger": "FPS < 60 or layout thrashing" },
+      "complexity": "medium"
+    },
+    "page": {
+      "description": "Page scroll choreography: research -> choreography -> parallel animations -> test",
+      "task_chain": [
+        "MRESEARCH-001", "CHOREO-001",
+        "ANIM-001..N:parallel",
+        "MTEST-001"
+      ],
+      "parallel_fan_out": { "after": "CHOREO-001", "tasks": "ANIM-*", "join_before": "MTEST-001" },
+      "complexity": "high"
+    }
+  },
+
+  "innovation_patterns": {
+    "generator_critic": {
+      "generator": "animator",
+      "critic": "motion-tester",
+      "max_rounds": 2,
+      "convergence": "perf.score >= 8 && perf.fps >= 60 && perf.thrashing_count === 0",
+      "trigger": "FPS < 60 or layout thrashing detected",
+      "escalation": "Coordinator intervenes after max rounds"
+    },
+    "shared_memory": {
+      "file": "shared-memory.json",
+      "fields": {
+        "motion-researcher": ["animation_inventory", "performance_baseline", "easing_catalog"],
+        "choreographer": ["motion_tokens", "scroll_sequences", "state_diagrams"],
+        "animator": ["keyframe_registry", "orchestrator_registry"],
+        "motion-tester": ["perf_history", "issue_registry"]
+      }
+    },
+    "parallel_fan_out": {
+      "pattern": "CP-3",
+      "description": "Multiple ANIM tasks execute in parallel for page mode, joined before MTEST",
+      "trigger": "page pipeline after CHOREO-001 completion"
+    },
+    "review_fix": {
+      "pattern": "CP-2",
+      "description": "Animator and motion-tester in Generator-Critic loop",
+      "max_rounds": 2,
+      "trigger": "FPS < 60 or layout thrashing detected"
+    }
+  },
+
+  "session_dirs": {
+    "base": ".workflow/.team/MD-{slug}-{YYYY-MM-DD}/",
+    "research": "research/",
+    "choreography": "choreography/",
+    "animations": "animations/",
+    "testing": "testing/",
+    "messages": ".workflow/.team-msg/{team-name}/"
+  }
+}

package/.claude/skills/team-perf-opt/SKILL.md

@@ -90,7 +90,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
 })
 ```
 
-**Inner Loop roles** (optimizer): Set `inner_loop: true`.
+**Inner Loop roles** (optimizer): Set `inner_loop` dynamically — `true` for single mode, `false` for fan-out/independent (parallel branches).
 **Single-task roles** (profiler, strategist, benchmarker, reviewer): Set `inner_loop: false`.
 
 ## User Commands

package/.claude/skills/team-perf-opt/roles/optimizer/role.md

@@ -1,7 +1,7 @@
 ---
 role: optimizer
 prefix: IMPL
-inner_loop: true
+inner_loop: dynamic
 additional_prefixes: [FIX]
 message_types:
   success: impl_complete
@@ -11,6 +11,8 @@ message_types:
 
 # Code Optimizer
 
+> **inner_loop: dynamic** — Dispatch sets per-task: `true` for single mode (one IMPL task with iterative fix cycles), `false` for fan-out/independent modes (IMPL-B01..N run as separate parallel workers). When false, each branch gets its own worker.
+
 Implement optimization changes following the strategy plan. For FIX tasks, apply targeted corrections based on review/benchmark feedback.
 
 ## Modes

package/.claude/skills/team-perf-opt/specs/team-config.json

@@ -65,10 +65,10 @@
       "type": "code_generation",
       "description": "Implements optimization changes following the strategy plan",
       "role_spec": "roles/optimizer/role.md",
-      "inner_loop": true,
+      "inner_loop": "dynamic",
       "frontmatter": {
         "prefix": "IMPL",
-        "inner_loop": true,
+        "inner_loop": "dynamic",
         "additional_prefixes": ["FIX"],
         "discuss_rounds": [],
         "delegates_to": [],

package/.claude/skills/team-quality-assurance/SKILL.md

@@ -38,7 +38,7 @@ Skill(skill="team-quality-assurance", args="task description")
 | scout | [roles/scout/role.md](roles/scout/role.md) | SCOUT-* | false |
 | strategist | [roles/strategist/role.md](roles/strategist/role.md) | QASTRAT-* | false |
 | generator | [roles/generator/role.md](roles/generator/role.md) | QAGEN-* | false |
-| executor | [roles/executor/role.md](roles/executor/role.md) | QARUN-* | true |
+| executor | [roles/executor/role.md](roles/executor/role.md) | QARUN-* | dynamic |
 | analyst | [roles/analyst/role.md](roles/analyst/role.md) | QAANA-* | false |
 
 ## Role Router

package/.claude/skills/team-quality-assurance/roles/coordinator/commands/dispatch.md

@@ -87,8 +87,10 @@ SCOUT-002 (scout): Regression scan after fixes
 
 ## InnerLoop Flag Rules
 
-- true: executor roles (run-fix cycles)
-- false: scout, strategist, generator, analyst roles
+- **executor**: dynamic per pipeline mode:
+  - Discovery/Testing: `true` (serial layer chain, single executor handles GC loops)
+  - Full: `false` for parallel QARUN tasks (QARUN-L1-001 and QARUN-L2-001 have independent blockedBy, each gets own worker)
+- **scout, strategist, generator, analyst**: always false
 
 ## Dependency Validation
 

package/.claude/skills/team-quality-assurance/roles/coordinator/commands/monitor.md

@@ -132,10 +132,12 @@ Find ready tasks, spawn workers, STOP.
 | SCOUT-* | scout | false |
 | QASTRAT-* | strategist | false |
 | QAGEN-* | generator | false |
-| QARUN-* | executor | true |
+| QARUN-* | executor | dynamic |
 | QAANA-* | analyst | false |
 
-   b. Check if inner loop role with active worker -> skip (worker picks up next task)
+   b. Check inner_loop: parse task description `InnerLoop:` field (NOT role.md default)
+      - InnerLoop: true AND same-role worker already active -> skip (worker picks up next task)
+      - InnerLoop: false OR no active same-role worker -> spawn new worker
    c. TaskUpdate -> in_progress
    d. team_msg log -> task_unblocked
    e. Spawn team-worker:

package/.claude/skills/team-quality-assurance/roles/executor/role.md

@@ -1,7 +1,7 @@
 ---
 role: executor
 prefix: QARUN
-inner_loop: true
+inner_loop: dynamic
 additional_prefixes: [QARUN-gc]
 message_types:
   success: tests_passed
@@ -12,6 +12,8 @@ message_types:
 
 # Test Executor
 
+> **inner_loop: dynamic** — Dispatch sets per-task: `true` for serial layer chains (discovery/testing mode), `false` for parallel layer execution (full mode where QARUN-L1-001 and QARUN-L2-001 run independently). When false, each QARUN task gets its own worker.
+
 Run test suites, collect coverage data, and perform automatic fix cycles when tests fail. Implements the execution side of the Generator-Executor (GC) loop.
 
 ## Phase 2: Environment Detection

package/.claude/skills/team-testing/SKILL.md

@@ -37,7 +37,7 @@ Skill(skill="team-testing", args="task description")
 | coordinator | [roles/coordinator/role.md](roles/coordinator/role.md) | — | — |
 | strategist | [roles/strategist/role.md](roles/strategist/role.md) | STRATEGY-* | false |
 | generator | [roles/generator/role.md](roles/generator/role.md) | TESTGEN-* | true |
-| executor | [roles/executor/role.md](roles/executor/role.md) | TESTRUN-* | true |
+| executor | [roles/executor/role.md](roles/executor/role.md) | TESTRUN-* | dynamic |
 | analyst | [roles/analyst/role.md](roles/analyst/role.md) | TESTANA-* | false |
 
 ## Role Router

package/.claude/skills/team-testing/roles/coordinator/commands/dispatch.md

@@ -84,8 +84,11 @@ TESTANA-001 (analyst): Defect pattern analysis, quality report
 
 ## InnerLoop Flag Rules
 
-- true: generator, executor roles (GC loop iterations)
-- false: strategist, analyst roles
+- **generator**: always true (GC loop iterations within a single layer)
+- **executor**: dynamic per pipeline mode:
+  - Targeted/Standard: `true` (serial layer chain, single executor handles GC loops)
+  - Comprehensive: `false` for parallel TESTRUN tasks (TESTRUN-001 and TESTRUN-002 have independent blockedBy, each gets own worker)
+- **strategist, analyst**: always false
 
 ## Dependency Validation
 

package/.claude/skills/team-testing/roles/coordinator/commands/monitor.md

@@ -27,7 +27,7 @@ Event-driven pipeline coordination. Beat model: coordinator wake -> process -> s
 |--------|------|-----------|------------|
 | STRATEGY-* | strategist | `~  or <project>/.claude/skills/team-testing/roles/strategist/role.md` | false |
 | TESTGEN-* | generator | `~  or <project>/.claude/skills/team-testing/roles/generator/role.md` | true |
-| TESTRUN-* | executor | `~  or <project>/.claude/skills/team-testing/roles/executor/role.md` | true |
+| TESTRUN-* | executor | `~  or <project>/.claude/skills/team-testing/roles/executor/role.md` | dynamic |
 | TESTANA-* | analyst | `~  or <project>/.claude/skills/team-testing/roles/analyst/role.md` | false |
 
 ## handleCallback
@@ -136,7 +136,9 @@ Find ready tasks, spawn workers, STOP.
 3. No ready + nothing in progress -> handleComplete
 4. Has ready -> for each ready task:
    a. Determine role from prefix (use Role-Worker Map)
-   b. Check if inner loop role (generator/executor) with active worker -> skip (worker picks up next task)
+   b. Check inner_loop: parse task description `InnerLoop:` field (NOT role.md default)
+      - InnerLoop: true AND same-role worker already active -> skip (worker picks up next task)
+      - InnerLoop: false OR no active same-role worker -> spawn new worker
    c. TaskUpdate -> in_progress
    d. team_msg log -> task_unblocked
    e. Spawn team-worker:

package/.claude/skills/team-testing/roles/executor/role.md

@@ -1,7 +1,7 @@
 ---
 role: executor
 prefix: TESTRUN
-inner_loop: true
+inner_loop: dynamic
 message_types:
   success: tests_passed
   failure: tests_failed
@@ -11,6 +11,8 @@ message_types:
 
 # Test Executor
 
+> **inner_loop: dynamic** — Dispatch sets per-task: `true` for serial GC loops (single layer pipeline), `false` for parallel layer execution (comprehensive pipeline where TESTRUN-001 and TESTRUN-002 run independently). When false, each TESTRUN task gets its own worker.
+
 Execute tests, collect coverage, attempt auto-fix for failures. Acts as the Critic in the Generator-Critic loop. Reports pass rate and coverage for coordinator GC decisions.
 
 ## Phase 2: Context Loading

package/.claude/skills/team-ui-polish/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: team-ui-polish
+description: Unified team skill for UI polish. Auto-discover and fix UI design issues using Impeccable design standards. Anti-AI-slop detection, color/typography/spacing quality, motion, interaction states, visual hierarchy. Uses team-worker agent architecture. Triggers on "team ui polish", "ui polish", "design polish".
+allowed-tools: Agent, AskUserQuestion, Read, Write, Edit, Bash, Glob, Grep, TaskList, TaskGet, TaskUpdate, TaskCreate, TeamCreate, TeamDelete, SendMessage, mcp__ccw-tools__read_file, mcp__ccw-tools__write_file, mcp__ccw-tools__edit_file, mcp__ccw-tools__team_msg, mcp__chrome-devtools__evaluate_script, mcp__chrome-devtools__take_screenshot, mcp__chrome-devtools__navigate_page, mcp__chrome-devtools__resize_page
+---
+
+# Team UI Polish
+
+Automatic UI quality improvement pipeline: scan -> diagnose -> optimize -> verify. Built on **team-worker agent architecture** -- all worker roles share a single agent definition with role-specific Phase 2-4 loaded from `roles/<role>/role.md`.
+
+## Architecture
+
+```
+Skill(skill="team-ui-polish", args="task description")
+                    |
+         SKILL.md (this file) = Router
+                    |
+     +--------------+--------------+
+     |                             |
+  no --role flag              --role <name>
+     |                             |
+  Coordinator                  Worker
+  roles/coordinator/role.md    roles/<name>/role.md
+     |
+     +-- analyze -> dispatch -> spawn workers -> STOP
+                                    |
+                    +-------+-------+-------+
+                    v       v       v       v
+           [team-worker agents, each loads roles/<role>/role.md]
+          scanner  diagnostician  optimizer <-> verifier (GC loop)
+```
+
+## Role Registry
+
+| Role | Path | Prefix | Inner Loop |
+|------|------|--------|------------|
+| coordinator | [roles/coordinator/role.md](roles/coordinator/role.md) | -- | -- |
+| scanner | [roles/scanner/role.md](roles/scanner/role.md) | SCAN-* | false |
+| diagnostician | [roles/diagnostician/role.md](roles/diagnostician/role.md) | DIAG-* | false |
+| optimizer | [roles/optimizer/role.md](roles/optimizer/role.md) | OPT-* | true |
+| verifier | [roles/verifier/role.md](roles/verifier/role.md) | VERIFY-* | false |
+
+## Role Router
+
+Parse `$ARGUMENTS`:
+- Has `--role <name>` -> Read `roles/<name>/role.md`, execute Phase 2-4
+- No `--role` -> `@roles/coordinator/role.md`, execute entry router
+
+## Shared Constants
+
+- **Session prefix**: `UIP`
+- **Session path**: `.workflow/.team/UIP-<slug>-<date>/`
+- **CLI tools**: `ccw cli --mode analysis` (read-only), `ccw cli --mode write` (modifications)
+- **Message bus**: `mcp__ccw-tools__team_msg(session_id=<session-id>, ...)`
+- **Max GC rounds**: 2
+
+## Worker Spawn Template
+
+Coordinator spawns workers using this template:
+
+```
+Agent({
+  subagent_type: "team-worker",
+  description: "Spawn <role> worker for <task-id>",
+  team_name: "ui-polish",
+  name: "<role>",
+  run_in_background: true,
+  prompt: `## Role Assignment
+role: <role>
+role_spec: <skill_root>/roles/<role>/role.md
+session: <session-folder>
+session_id: <session-id>
+team_name: ui-polish
+requirement: <task-description>
+inner_loop: <true|false>
+
+Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
+Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
+})
+```
+
+## User Commands
+
+| Command | Action |
+|---------|--------|
+| `check` / `status` | View execution status graph |
+| `resume` / `continue` | Advance to next step |
+
+## Specs Reference
+
+- [specs/pipelines.md](specs/pipelines.md) -- Pipeline definitions and task registry
+- [specs/team-config.json](specs/team-config.json) -- Team configuration
+- [specs/anti-patterns.md](specs/anti-patterns.md) -- AI slop and design anti-pattern catalog
+- [specs/design-standards.md](specs/design-standards.md) -- Impeccable positive design standards
+- [specs/fix-strategies.md](specs/fix-strategies.md) -- Issue-to-fix mapping
+- [specs/scoring-guide.md](specs/scoring-guide.md) -- Scoring rubric
+
+## Session Directory
+
+```
+.workflow/.team/UIP-<slug>-<date>/
++-- .msg/
+|   +-- messages.jsonl         # Team message bus
+|   +-- meta.json              # Pipeline config + GC state
++-- scan/                      # Scanner output
+|   +-- scan-report.md
++-- diagnosis/                 # Diagnostician output
+|   +-- diagnosis-report.md
++-- optimization/              # Optimizer output
+|   +-- fix-log.md
++-- verification/              # Verifier output
+|   +-- verify-report.md
++-- evidence/                  # Screenshots (before/after)
+|   +-- *.png
++-- wisdom/                    # Cross-task knowledge
+```
+
+## Error Handling
+
+| Scenario | Resolution |
+|----------|------------|
+| Unknown command | Error with available command list |
+| Role not found | Error with role registry |
+| Session corruption | Attempt recovery, fallback to manual |
+| Fast-advance conflict | Coordinator reconciles on next callback |
+| Completion action fails | Default to Keep Active |
+| GC loop stuck > 2 rounds | Escalate to user: accept / retry / terminate |

package/.claude/skills/team-ui-polish/roles/coordinator/commands/analyze.md

@@ -0,0 +1,77 @@
+# Analyze Task
+
+Parse user task -> detect polish scope -> determine pipeline mode -> estimate complexity.
+
+**CONSTRAINT**: Text-level analysis only. NO source code reading, NO codebase exploration.
+
+## Signal Detection
+
+| Keywords | Dimension | Priority |
+|----------|-----------|----------|
+| AI slop, generic, templated, looks like AI | Anti-Patterns | P0 |
+| color, palette, contrast, OKLCH, dark mode, theme | Color Quality | P1 |
+| font, typography, heading, text size, type scale | Typography | P1 |
+| spacing, padding, margin, rhythm, gap, grid | Spacing/Layout | P1 |
+| animation, transition, motion, easing, animate | Motion | P2 |
+| hover, focus, active, disabled, states, interaction | Interaction States | P2 |
+| hierarchy, visual weight, composition, squint | Visual Hierarchy | P2 |
+| responsive, mobile, breakpoint, viewport | Responsive | P2 |
+
+## Scope Determination
+
+| Signal | Pipeline Mode |
+|--------|---------------|
+| "scan", "audit", "check", "report", "analyze", "review" | scan-only |
+| "fix color", "fix typography", specific dimension keyword | targeted |
+| "polish", "fix all", "full", "improve", "clean up", "redesign" | full |
+| Unclear | ask user |
+
+## Dimension Filter (targeted mode only)
+
+When targeted mode detected, extract which dimensions to focus on:
+
+| Keywords | Dimension Filter |
+|----------|-----------------|
+| AI slop, generic | anti_patterns |
+| color, palette, contrast | color |
+| font, typography, type | typography |
+| spacing, layout, grid | spacing |
+| animation, motion | motion |
+| hover, focus, states | interaction |
+| hierarchy, visual weight | hierarchy |
+| responsive, mobile | responsive |
+
+## Target Detection
+
+| Signal | Target Type |
+|--------|-------------|
+| URL provided (http/https) | url |
+| File path provided (.tsx, .css, .html) | component |
+| "all", "full site", "entire", "everything" | full_site |
+| Directory path | directory |
+
+## Complexity Scoring
+
+| Factor | Points |
+|--------|--------|
+| Single component / single URL | +1 |
+| Multiple components | +2 |
+| Full site | +3 |
+| Multiple dimensions targeted | +1 |
+| Chrome DevTools required | +1 |
+| Responsive checks needed | +1 |
+
+Results: 1-2 Low (scan-only), 3-4 Medium (targeted), 5+ High (full)
+
+## Output
+
+Write scope context to coordinator memory:
+```json
+{
+  "pipeline_mode": "<scan-only|targeted|full>",
+  "target": "<url|component-path|full_site>",
+  "target_type": "<url|component|directory|full_site>",
+  "dimension_filters": ["<dimension-names or empty for all>"],
+  "complexity": { "score": 0, "level": "Low|Medium|High" }
+}
+```

package/.claude/skills/team-ui-polish/roles/coordinator/commands/dispatch.md

@@ -0,0 +1,194 @@
+# Command: Dispatch
+
+Create the UI polish task chain with correct dependencies and structured task descriptions. Supports scan-only, targeted, and full pipeline modes.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| User requirement | From coordinator Phase 1 | Yes |
+| Session folder | From coordinator Phase 2 | Yes |
+| Pipeline mode | From analyze output | Yes |
+| Target | From analyze output (url/component/full_site) | Yes |
+| Dimension filters | From analyze output (targeted mode only) | No |
+
+1. Load user requirement and polish scope from session context
+2. Load pipeline stage definitions from specs/pipelines.md
+3. Read `pipeline_mode`, `target`, and `dimension_filters` from session context
+
+## Phase 3: Task Chain Creation (Mode-Branched)
+
+### Task Description Template
+
+Every task description uses structured format:
+
+```
+TaskCreate({
+  subject: "<TASK-ID>",
+  description: "PURPOSE: <what this task achieves> | Success: <measurable completion criteria>
+TASK:
+  - <step 1: specific action>
+  - <step 2: specific action>
+  - <step 3: specific action>
+CONTEXT:
+  - Session: <session-folder>
+  - Target: <url|component-path|full_site>
+  - Dimension filters: <all | specific dimensions>
+  - Upstream artifacts: <artifact-1>, <artifact-2>
+  - Shared memory: <session>/wisdom/.msg/meta.json
+EXPECTED: <deliverable path> + <quality criteria>
+CONSTRAINTS: <scope limits, focus areas>"
+})
+TaskUpdate({ taskId: "<TASK-ID>", addBlockedBy: [<dependency-list>], owner: "<role>" })
+```
+
+### Mode Router
+
+| Mode | Action |
+|------|--------|
+| `scan-only` | Create 2 tasks: SCAN -> DIAG |
+| `targeted` | Create 4 tasks: SCAN -> DIAG -> OPT -> VERIFY |
+| `full` | Create 4 tasks: SCAN -> DIAG -> OPT -> VERIFY (with GC loop enabled) |
+
+---
+
+### Scan-Only Pipeline Task Chain
+
+**SCAN-001** (scanner):
+```
+TaskCreate({
+  subject: "SCAN-001",
+  description: "PURPOSE: Scan UI against Impeccable's 8 audit dimensions to discover all design problems | Success: Complete scan report with per-dimension scores and issue inventory
+TASK:
+  - Load target files or take screenshots via Chrome DevTools
+  - Extract color values, font definitions, spacing values, animation declarations
+  - Score all 8 dimensions: anti-patterns, color, typography, spacing, motion, interaction, hierarchy, responsive
+  - Generate issue inventory with file:line locations and severity
+CONTEXT:
+  - Session: <session-folder>
+  - Target: <target>
+  - Dimension filters: all
+  - Shared memory: <session>/wisdom/.msg/meta.json
+EXPECTED: <session>/scan/scan-report.md | 8-dimension scored report with issue inventory
+CONSTRAINTS: Read-only analysis | Reference specs/anti-patterns.md and specs/design-standards.md"
+})
+TaskUpdate({ taskId: "SCAN-001", owner: "scanner" })
+```
+
+**DIAG-001** (diagnostician):
+```
+TaskCreate({
+  subject: "DIAG-001",
+  description: "PURPOSE: Deep-dive root cause analysis of scan findings, classify severity, group systemic vs one-off | Success: Prioritized diagnosis with fix dependency graph
+TASK:
+  - Read scan report and classify each issue as systemic or one-off
+  - Group issues by root cause
+  - Build fix dependency graph (which fixes must come first)
+  - Prioritize by severity (P0 -> P1 -> P2 -> P3)
+CONTEXT:
+  - Session: <session-folder>
+  - Upstream artifacts: scan/scan-report.md
+  - Shared memory: <session>/wisdom/.msg/meta.json
+EXPECTED: <session>/diagnosis/diagnosis-report.md | Root cause groups with fix strategies and dependency graph
+CONSTRAINTS: Read-only analysis | Reference specs/fix-strategies.md"
+})
+TaskUpdate({ taskId: "DIAG-001", addBlockedBy: ["SCAN-001"], owner: "diagnostician" })
+```
+
+---
+
+### Targeted Pipeline Task Chain
+
+Same as scan-only SCAN-001 and DIAG-001, plus:
+
+**Note**: For targeted mode, SCAN-001 description adds dimension filter:
+```
+  - Dimension filters: <specific dimensions from analyze output>
+```
+
+**OPT-001** (optimizer):
+```
+TaskCreate({
+  subject: "OPT-001",
+  description: "PURPOSE: Apply targeted fixes for specified dimensions following Impeccable design standards | Success: All P0/P1 issues in targeted dimensions resolved
+TASK:
+  - Read diagnosis report for prioritized fix plan
+  - Apply fixes in dependency order (systemic first, then one-off)
+  - Follow Impeccable fix strategies per dimension
+  - Self-validate: no regressions, code compiles/lints
+CONTEXT:
+  - Session: <session-folder>
+  - Dimension filters: <targeted dimensions>
+  - Upstream artifacts: scan/scan-report.md, diagnosis/diagnosis-report.md
+  - Shared memory: <session>/wisdom/.msg/meta.json
+EXPECTED: Modified source files + <session>/optimization/fix-log.md | Each fix documented with before/after
+CONSTRAINTS: Only fix targeted dimensions | Reference specs/fix-strategies.md and specs/design-standards.md"
+})
+TaskUpdate({ taskId: "OPT-001", addBlockedBy: ["DIAG-001"], owner: "optimizer" })
+```
+
+**VERIFY-001** (verifier):
+```
+TaskCreate({
+  subject: "VERIFY-001",
+  description: "PURPOSE: Verify fixes improved scores without introducing regressions | Success: Score improved or maintained in all dimensions, zero regressions
+TASK:
+  - Re-scan fixed code against same 8 dimensions
+  - Calculate before/after score delta per dimension
+  - Check for regressions (new issues introduced by fixes)
+  - Take after screenshots if Chrome DevTools available
+CONTEXT:
+  - Session: <session-folder>
+  - Upstream artifacts: scan/scan-report.md, optimization/fix-log.md
+  - Shared memory: <session>/wisdom/.msg/meta.json
+EXPECTED: <session>/verification/verify-report.md | Before/after comparison with regression check
+CONSTRAINTS: Read-only verification | Signal fix_required if regressions found"
+})
+TaskUpdate({ taskId: "VERIFY-001", addBlockedBy: ["OPT-001"], owner: "verifier" })
+```
+
+---
+
+### Full Pipeline Task Chain
+
+Same as targeted pipeline. The difference is in GC loop behavior:
+- When VERIFY-001 reports `fix_required`, coordinator creates OPT-fix task (see monitor.md)
+- Full mode enables GC loop; targeted mode does not create GC fix tasks
+
+---
+
+### GC Fix Task Template (created by monitor.md when verify fails)
+
+```
+TaskCreate({
+  subject: "OPT-fix-<round>",
+  description: "PURPOSE: Address verification regressions from round <round> | Success: All regressions resolved, no new issues
+TASK:
+  - Parse verification feedback for specific regressions
+  - Apply targeted fixes for regression issues only
+  - Self-validate before reporting
+CONTEXT:
+  - Session: <session-folder>
+  - Upstream artifacts: verification/verify-report.md, optimization/fix-log.md
+  - Shared memory: <session>/wisdom/.msg/meta.json
+EXPECTED: Updated source files + appended <session>/optimization/fix-log.md
+CONSTRAINTS: Fix regressions only, do not expand scope"
+})
+TaskUpdate({ taskId: "OPT-fix-<round>", owner: "optimizer" })
+```
+
+Then create new VERIFY task blocked by OPT-fix.
+
+## Phase 4: Validation
+
+Verify task chain integrity:
+
+| Check | Method | Expected |
+|-------|--------|----------|
+| Task count correct | TaskList count | scan-only: 2, targeted: 4, full: 4 |
+| Dependencies correct | Trace dependency graph | Acyclic, correct blockedBy |
+| No circular dependencies | Trace dependency graph | Acyclic |
+| Task IDs use correct prefixes | Pattern check | SCAN/DIAG/OPT/VERIFY |
+| Structured descriptions complete | Each has PURPOSE/TASK/CONTEXT/EXPECTED/CONSTRAINTS | All present |
+
+If validation fails, fix the specific task and re-validate.