claude-code-workflow 7.2.26 → 7.2.28

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

@@ -0,0 +1,204 @@
+# Monitor Pipeline
+
+Event-driven pipeline coordination. Beat model: coordinator wake -> process -> spawn -> STOP.
+
+## Constants
+
+- SPAWN_MODE: background
+- ONE_STEP_PER_INVOCATION: true
+- FAST_ADVANCE_AWARE: true
+- WORKER_AGENT: team-worker
+- MAX_GC_ROUNDS: 2
+
+## Handler Router
+
+| Source | Handler |
+|--------|---------|
+| Message contains [color-auditor], [typo-auditor], [focus-auditor], [remediation-planner], [fix-implementer] | handleCallback |
+| "capability_gap" | handleAdapt |
+| "check" or "status" | handleCheck |
+| "resume" or "continue" | handleResume |
+| All tasks completed | handleComplete |
+| Default | handleSpawnNext |
+
+## handleCallback
+
+Worker completed. Process and advance.
+
+1. Parse message to identify role and task ID:
+
+| Message Pattern | Role |
+|----------------|------|
+| `[color-auditor]` or `COLOR-*` | color-auditor |
+| `[typo-auditor]` or `TYPO-*` | typo-auditor |
+| `[focus-auditor]` or `FOCUS-*` | focus-auditor |
+| `[remediation-planner]` or `REMED-*` | remediation-planner |
+| `[fix-implementer]` or `FIX-*` | fix-implementer |
+
+2. Mark task completed: `TaskUpdate({ taskId: "<task-id>", status: "completed" })`
+3. Record completion in session state
+
+4. Check checkpoint for completed task:
+
+| Completed Task | Checkpoint | Action |
+|---------------|------------|--------|
+| COLOR-001 | Parallel fan-in | Check if all 3 audits complete -> unblock REMED-001 |
+| TYPO-001 | Parallel fan-in | Check if all 3 audits complete -> unblock REMED-001 |
+| FOCUS-001 | Parallel fan-in | Check if all 3 audits complete -> unblock REMED-001 |
+| REMED-001 | -- | Unblock FIX-001 (full mode only) |
+| FIX-001 | GC check | Spawn COLOR-002 + FOCUS-002 in parallel (full mode) |
+| COLOR-002 | Re-audit fan-in | Check if both re-audits complete -> handleComplete |
+| FOCUS-002 | Re-audit fan-in | Check if both re-audits complete -> handleComplete |
+
+5. **Parallel fan-in handling** (audit task completed):
+
+   **CRITICAL**: REMED-001 must wait for ALL 3 auditors (COLOR-001 + TYPO-001 + FOCUS-001) to complete.
+
+   Check completion state:
+   ```
+   completed_audits = count of completed tasks in [COLOR-001, TYPO-001, FOCUS-001]
+   if completed_audits < 3:
+     -> Log "[coordinator] Audit fan-in: {completed_audits}/3 complete, waiting for remaining"
+     -> STOP (do NOT advance)
+   if completed_audits === 3:
+     -> Log "[coordinator] All 3 audits complete, advancing to REMED-001"
+     -> handleSpawnNext (will pick up REMED-001)
+   ```
+
+6. **GC loop handling** (full mode, after FIX-001 completes):
+
+   Read re-audit results when COLOR-002 and FOCUS-002 both complete:
+
+   | Signal | Condition | Action |
+   |--------|-----------|--------|
+   | All pass | No critical/high issues remaining | GC converged -> handleComplete |
+   | Issues remain | Critical/high issues found | gc_rounds < max -> create FIX-002 + re-audit tasks |
+   | Any | gc_rounds >= max | Escalate to user |
+
+   **GC Fix Task Creation** (when re-audit finds issues):
+   ```
+   TaskCreate({ subject: "FIX-002",
+     description: "PURPOSE: Address remaining issues from re-audit | Success: All critical/high issues resolved
+   TASK:
+     - Parse re-audit reports for remaining issues
+     - Apply targeted fixes for color and focus issues
+   CONTEXT:
+     - Session: <session-folder>
+     - Upstream artifacts: re-audit/color-audit-002.md, re-audit/focus-audit-002.md" })
+   TaskUpdate({ taskId: "FIX-002", addBlockedBy: ["COLOR-002", "FOCUS-002"], owner: "fix-implementer" })
+   ```
+   Then create new re-audit tasks blocked by FIX-002. Increment gc_state.round.
+
+   **GC Escalation Options** (when max rounds exceeded):
+   1. Accept current state - acknowledge remaining issues
+   2. Try one more round
+   3. Terminate
+
+7. -> handleSpawnNext
+
+## handleCheck
+
+Read-only status report, then STOP.
+
+```
+Pipeline Status (<pipeline-mode>):
+  [DONE]  COLOR-001 (color-auditor)        -> audits/color/color-audit-001.md
+  [DONE]  TYPO-001  (typo-auditor)         -> audits/typography/typo-audit-001.md
+  [RUN]   FOCUS-001 (focus-auditor)        -> auditing focus...
+  [WAIT]  REMED-001 (remediation-planner)  -> blocked by COLOR-001, TYPO-001, FOCUS-001
+  [WAIT]  FIX-001   (fix-implementer)      -> blocked by REMED-001
+  [WAIT]  COLOR-002 (color-auditor)        -> blocked by FIX-001
+  [WAIT]  FOCUS-002 (focus-auditor)        -> blocked by FIX-001
+
+Fan-in: 2/3 audits complete
+GC Rounds: 0/2
+Session: <session-id>
+Commands: 'resume' to advance | 'check' to refresh
+```
+
+Output status -- do NOT advance pipeline.
+
+## handleResume
+
+1. Audit task list for inconsistencies:
+   - Tasks stuck in "in_progress" -> reset to "pending"
+   - Tasks with completed blockers but still "pending" -> include in spawn list
+2. -> handleSpawnNext
+
+## handleSpawnNext
+
+Find ready tasks, spawn workers, STOP.
+
+1. Collect: completedSubjects, inProgressSubjects, readySubjects (pending + all blockedBy completed)
+2. No ready + work in progress -> report waiting, STOP
+3. No ready + nothing in progress -> handleComplete
+4. Has ready -> for each:
+   a. Check inner loop role with active worker -> skip (worker picks up)
+   b. TaskUpdate -> in_progress
+   c. team_msg log -> task_unblocked
+   d. Spawn team-worker:
+
+```
+Agent({
+  subagent_type: "team-worker",
+  description: "Spawn <role> worker for <task-id>",
+  team_name: "visual-a11y",
+  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: visual-a11y
+requirement: <task-description>
+inner_loop: <true|false>
+
+Read role_spec file to load Phase 2-4 domain instructions.
+Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
+})
+```
+
+**Parallel spawn rules by mode**:
+
+| Mode | Scenario | Spawn Behavior |
+|------|----------|---------------|
+| audit-only | Initial | Spawn COLOR-001 + TYPO-001 + FOCUS-001 in parallel |
+| audit-only | After 3 audits complete | Spawn REMED-001 |
+| full | Initial | Spawn COLOR-001 + TYPO-001 + FOCUS-001 in parallel |
+| full | After 3 audits complete | Spawn REMED-001 |
+| full | After REMED-001 | Spawn FIX-001 |
+| full | After FIX-001 | Spawn COLOR-002 + FOCUS-002 in parallel |
+
+5. Add to active_workers, update session, output summary, STOP
+
+## handleComplete
+
+Pipeline done. Generate report and completion action.
+
+**Completion check by mode**:
+
+| Mode | Completion Condition |
+|------|---------------------|
+| audit-only | All 4 tasks (+ any fix tasks) completed |
+| full | All 7 tasks (+ any GC fix tasks) completed |
+
+1. If any tasks not completed -> handleSpawnNext
+2. If all completed -> transition to coordinator Phase 5
+
+## handleAdapt
+
+Capability gap reported mid-pipeline.
+
+1. Parse gap description
+2. Check if existing role covers it -> redirect
+3. Role count < 6 -> generate dynamic role spec
+4. Create new task, spawn worker
+5. Role count >= 6 -> merge or pause
+
+## Fast-Advance Reconciliation
+
+On every coordinator wake:
+1. Read team_msg entries with type="fast_advance"
+2. Sync active_workers with spawned successors
+3. No duplicate spawns

package/.claude/skills/team-visual-a11y/roles/coordinator/role.md

@@ -0,0 +1,169 @@
+# Coordinator Role
+
+Visual Accessibility Team coordinator. Orchestrate pipeline: analyze -> dispatch -> spawn -> monitor -> report. Manages parallel fan-in (3 auditors), remediation synthesis, fix implementation, and optional re-audit GC loop.
+
+## Identity
+- **Name**: coordinator | **Tag**: [coordinator]
+- **Responsibility**: Analyze scope -> Create team -> Dispatch tasks -> Monitor progress -> Report results
+
+## Boundaries
+
+### MUST
+- All output (SendMessage, team_msg, logs) must carry `[coordinator]` identifier
+- Use `team-worker` agent type for all worker spawns (NOT `general-purpose`)
+- Dispatch tasks with proper dependency chains and blockedBy
+- Spawn COLOR-001, TYPO-001, FOCUS-001 in PARALLEL (no blockedBy between them)
+- Monitor worker progress via message bus and route messages
+- Handle Generator-Critic loops with max 2 iterations
+- Maintain session state persistence
+
+### MUST NOT
+- Implement domain logic (auditing, planning, fixing) -- workers handle this
+- Spawn workers without creating tasks first
+- Skip sync points when configured
+- Force-advance pipeline past failed audit
+- Modify source code or design artifacts directly -- delegate to workers
+- Omit `[coordinator]` identifier in any output
+
+## Command Execution Protocol
+
+When coordinator needs to execute a command (analyze, dispatch, monitor):
+
+1. Read `commands/<command>.md`
+2. Follow the workflow defined in the command
+3. Commands are inline execution guides, NOT separate agents
+4. Execute synchronously, complete before proceeding
+
+## Entry Router
+
+| Detection | Condition | Handler |
+|-----------|-----------|---------|
+| Worker callback | Message contains [color-auditor], [typo-auditor], [focus-auditor], [remediation-planner], [fix-implementer] | -> handleCallback (monitor.md) |
+| Status check | Args contain "check" or "status" | -> handleCheck (monitor.md) |
+| Manual resume | Args contain "resume" or "continue" | -> handleResume (monitor.md) |
+| Capability gap | Message contains "capability_gap" | -> handleAdapt (monitor.md) |
+| Pipeline complete | All tasks have status "completed" | -> handleComplete (monitor.md) |
+| Interrupted session | Active/paused session exists in .workflow/.team/VA-* | -> Phase 0 |
+| New session | None of above | -> Phase 1 |
+
+For callback/check/resume/adapt/complete: load `@commands/monitor.md`, execute matched handler, STOP.
+
+## Phase 0: Session Resume Check
+
+1. Scan `.workflow/.team/VA-*/.msg/meta.json` for active/paused sessions
+2. No sessions -> Phase 1
+3. Single session -> reconcile (audit TaskList, reset in_progress->pending, rebuild team, kick first ready task)
+4. Multiple -> AskUserQuestion for selection
+
+## Phase 1: Requirement Clarification
+
+TEXT-LEVEL ONLY. No source code reading.
+
+1. Parse task description from arguments
+2. Detect audit scope:
+
+| Signal | Pipeline Mode |
+|--------|---------------|
+| "audit only", "no fixes", "assessment" | audit-only |
+| "full audit", "fix", "remediate", "full cycle" | full |
+| Unclear | ask user |
+
+3. Ask for missing parameters if scope unclear:
+   ```
+   AskUserQuestion({
+     questions: [
+       { question: "Accessibility audit scope?", header: "Scope", options: [
+         { label: "Audit only", description: "Color + typography + focus audit with remediation plan" },
+         { label: "Full cycle", description: "Audit + fix + re-audit verification" }
+       ]},
+       { question: "Target?", header: "Target", options: [
+         { label: "URL (rendered page)" },
+         { label: "Component path (source)" },
+         { label: "Full site" }
+       ]}
+     ]
+   })
+   ```
+4. Delegate to `@commands/analyze.md` -> output scope context
+5. Record: pipeline_mode, target, wcag_level
+
+## Phase 2: Create Team + Initialize Session
+
+1. Resolve workspace paths (MUST do first):
+   - `project_root` = result of `Bash({ command: "pwd" })`
+   - `skill_root` = `<project_root>/.claude/skills/team-visual-a11y`
+2. Generate session ID: `VA-<slug>-<YYYY-MM-DD>`
+3. Create session folder structure:
+   ```
+   .workflow/.team/VA-<slug>-<date>/audits/color/
+   .workflow/.team/VA-<slug>-<date>/audits/typography/
+   .workflow/.team/VA-<slug>-<date>/audits/focus/
+   .workflow/.team/VA-<slug>-<date>/remediation/
+   .workflow/.team/VA-<slug>-<date>/fixes/
+   .workflow/.team/VA-<slug>-<date>/re-audit/
+   .workflow/.team/VA-<slug>-<date>/evidence/
+   .workflow/.team/VA-<slug>-<date>/.msg/
+   ```
+4. Initialize `.msg/meta.json` via team_msg state_update with pipeline metadata
+5. TeamCreate(team_name="visual-a11y")
+6. Do NOT spawn workers yet - deferred to Phase 4
+
+## Phase 3: Create Task Chain
+
+Delegate to `@commands/dispatch.md`. Task chains by mode:
+
+| Mode | Task Chain |
+|------|------------|
+| audit-only | [COLOR-001 + TYPO-001 + FOCUS-001 parallel] -> REMED-001 |
+| full | [COLOR-001 + TYPO-001 + FOCUS-001 parallel] -> REMED-001 -> FIX-001 -> [COLOR-002 + FOCUS-002 parallel] |
+
+## Phase 4: Spawn-and-Stop
+
+**CRITICAL**: Spawn COLOR-001, TYPO-001, FOCUS-001 in PARALLEL (all 3 have NO blockedBy).
+
+Delegate to `@commands/monitor.md#handleSpawnNext`:
+1. Find ready tasks (pending + blockedBy resolved)
+2. Spawn team-worker agents (see SKILL.md Spawn Template)
+3. Output status summary
+4. STOP
+
+## Phase 5: Report + Completion Action
+
+1. Read session state -> collect all results
+2. List deliverables:
+
+| Deliverable | Path |
+|-------------|------|
+| Color Audit | <session>/audits/color/color-audit-001.md |
+| Typography Audit | <session>/audits/typography/typo-audit-001.md |
+| Focus Audit | <session>/audits/focus/focus-audit-001.md |
+| Remediation Plan | <session>/remediation/remediation-plan.md |
+| Fix Summary | <session>/fixes/fix-summary-001.md (full mode) |
+| Re-audit Color | <session>/re-audit/color-audit-002.md (full mode) |
+| Re-audit Focus | <session>/re-audit/focus-audit-002.md (full mode) |
+| Evidence | <session>/evidence/*.png (if Chrome DevTools used) |
+
+3. Calculate: completed_tasks, gc_rounds, issues_found, issues_fixed, wcag_compliance_level
+4. Output pipeline summary with [coordinator] prefix
+5. Execute completion action:
+   ```
+   AskUserQuestion({
+     questions: [{ question: "Pipeline complete. What next?", header: "Completion", options: [
+       { label: "Archive & Clean", description: "Archive session and clean up team resources" },
+       { label: "Keep Active", description: "Keep session for follow-up work" },
+       { label: "Export Results", description: "Export deliverables to specified location" }
+     ]}]
+   })
+   ```
+
+## Error Handling
+
+| Error | Resolution |
+|-------|------------|
+| Task timeout | Log, mark failed, ask user to retry or skip |
+| Worker crash | Reset task to pending, respawn worker |
+| Dependency cycle | Detect, report to user, halt |
+| Invalid scope | Reject with error, ask to clarify |
+| Session corruption | Attempt recovery, fallback to manual reconciliation |
+| GC loop stuck > 2 rounds | Escalate to user: accept / try one more / terminate |
+| Chrome DevTools unavailable | Mark in meta.json, auditors degrade to static analysis |

package/.claude/skills/team-visual-a11y/roles/fix-implementer/role.md

@@ -0,0 +1,246 @@
+---
+role: fix-implementer
+prefix: FIX
+inner_loop: true
+message_types: [state_update]
+---
+
+# Accessibility Fix Implementer
+
+Implement accessibility fixes from the remediation plan. OKLCH color corrections, focus styles, ARIA attributes, reduced-motion queries, typography adjustments. Apply fixes in priority order (critical first) and self-validate results.
+
+## Phase 2: Context & Artifact Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task description | From task subject/description | Yes |
+| Session path | Extracted from task description | Yes |
+| Remediation plan | <session>/remediation/remediation-plan.md | Yes |
+| Color audit report | <session>/audits/color/color-audit-001.md | Yes |
+| Focus audit report | <session>/audits/focus/focus-audit-001.md | Yes |
+| Typography audit report | <session>/audits/typography/typo-audit-001.md | Yes |
+| .msg/meta.json | <session>/.msg/meta.json | Yes |
+| Re-audit reports (GC loop) | <session>/re-audit/*.md | Only for FIX-002+ |
+
+1. Extract session path from task description
+2. Read remediation plan -- this is the primary work instruction
+3. Parse priority matrix for ordered fix list
+4. Read audit reports for detailed context on each issue
+5. For FIX-002+ (GC loop): read re-audit reports for remaining issues
+
+## Phase 3: Fix Implementation
+
+Apply fixes in priority order: Critical -> High -> Medium -> Low.
+
+### Category 1: OKLCH Color Corrections
+
+**Goal**: Adjust OKLCH lightness/chroma to meet contrast requirements.
+
+**Process**:
+1. Read remediation plan for specific color changes needed
+2. Locate CSS custom properties or color definitions in source files
+3. Apply lightness adjustments:
+   - Text too light -> decrease L% (e.g., L 55% -> L 35%)
+   - Background too dark -> increase L% (e.g., L 80% -> L 92%)
+   - Maintain hue (H) and adjust chroma (C) minimally
+4. Verify new contrast ratios meet WCAG target
+5. If dark mode exists, apply corresponding adjustments
+
+**Example**:
+```css
+/* Before: contrast 3.2:1 */
+--color-text: oklch(55% 0 0);
+--color-bg: oklch(98% 0 0);
+
+/* After: contrast 7.2:1 (AAA) */
+--color-text: oklch(25% 0 0);
+--color-bg: oklch(98% 0 0);
+```
+
+### Category 2: Focus Styles
+
+**Goal**: Add visible, high-contrast focus indicators for keyboard users.
+
+**Process**:
+1. Add `:focus-visible` rules per specs/focus-patterns.md:
+   ```css
+   :focus-visible {
+     outline: 2px solid var(--color-accent);
+     outline-offset: 2px;
+   }
+   :focus:not(:focus-visible) {
+     outline: none;
+   }
+   ```
+2. Remove bare `outline: none` or `outline: 0` that suppress focus without alternative
+3. Verify focus indicator contrast >= 3:1 against adjacent colors
+4. Add consistent focus style across all interactive elements
+
+### Category 3: ARIA Attributes
+
+**Goal**: Add missing ARIA roles, states, and properties.
+
+**Process**:
+1. Add `role` attributes where semantic HTML is not used:
+   - `<div onclick>` -> add `role="button"` and `tabindex="0"`
+   - Custom widgets -> appropriate ARIA role
+2. Add state attributes:
+   - Toggle buttons: `aria-pressed="true|false"`
+   - Expandable: `aria-expanded="true|false"`, `aria-controls="panel-id"`
+   - Dialogs: `role="dialog"`, `aria-modal="true"`, `aria-labelledby="title-id"`
+3. Add labels:
+   - `aria-label` for icon-only buttons
+   - `aria-labelledby` for dialogs and sections
+   - `aria-describedby` for form error messages
+4. Add live regions:
+   - Status messages: `aria-live="polite"`
+   - Error messages: `aria-live="assertive"`
+
+### Category 4: Reduced-Motion Queries
+
+**Goal**: Respect user's motion preferences.
+
+**Process**:
+1. Wrap animations and transitions in media query:
+   ```css
+   @media (prefers-reduced-motion: reduce) {
+     *,
+     *::before,
+     *::after {
+       animation-duration: 0.01ms !important;
+       animation-iteration-count: 1 !important;
+       transition-duration: 0.01ms !important;
+       scroll-behavior: auto !important;
+     }
+   }
+   ```
+2. Or per-element: disable specific animations while keeping layout
+3. Ensure no content is lost when motion is reduced
+
+### Category 5: Typography Adjustments
+
+**Goal**: Fix font sizes, line heights, and reading widths.
+
+**Process**:
+1. Replace fixed font sizes with responsive clamp():
+   ```css
+   body { font-size: clamp(1rem, 1vw + 0.875rem, 1.25rem); }
+   ```
+2. Fix line-height to acceptable ranges:
+   ```css
+   body { line-height: 1.625; }
+   h1, h2, h3 { line-height: 1.2; }
+   ```
+3. Add max-width for reading containers:
+   ```css
+   .content { max-width: 70ch; }
+   ```
+
+### Category 6: Skip Link
+
+**Goal**: Add skip-to-main-content link if missing.
+
+**Process** (per specs/focus-patterns.md):
+1. Add as first child of `<body>`:
+   ```html
+   <a href="#main" class="skip-link">Skip to main content</a>
+   ```
+2. Add CSS:
+   ```css
+   .skip-link {
+     position: absolute;
+     left: -9999px;
+     top: auto;
+   }
+   .skip-link:focus {
+     position: fixed;
+     left: 16px;
+     top: 16px;
+     z-index: 9999;
+     background: var(--color-paper, #fff);
+     color: var(--color-ink, #000);
+     padding: 8px 16px;
+     border-radius: 4px;
+     text-decoration: underline;
+   }
+   ```
+3. Ensure main content has `id="main"` (or equivalent target)
+
+### Category 7: Focus Trap for Modals
+
+**Goal**: Implement proper focus management in dialogs.
+
+**Process** (per specs/focus-patterns.md):
+1. On dialog open:
+   - Store `document.activeElement` as return target
+   - Move focus to first focusable element within dialog
+2. Trap Tab/Shift+Tab within dialog:
+   - Collect all focusable elements within dialog
+   - On Tab at last element -> focus first element
+   - On Shift+Tab at first element -> focus last element
+3. On Escape -> close dialog, restore focus to stored element
+4. Set `aria-modal="true"` on dialog container
+5. Optional: set `inert` on background content
+
+## Phase 4: Self-Validation & Output
+
+1. Validate each fix category:
+
+| Category | Validation Method |
+|----------|------------------|
+| Color | Recalculate contrast ratios for changed colors, verify >= target |
+| Focus | Search for :focus-visible rules, verify no bare outline:none |
+| ARIA | Check all dialogs have role+aria-modal, all buttons have labels |
+| Motion | Verify prefers-reduced-motion media query exists |
+| Typography | Check clamp() minimum >= 1rem, line-height in range |
+| Skip link | Verify skip link element exists, CSS hides then shows on focus |
+| Focus trap | Verify dialog has focus management code |
+
+2. Write fix summary to `<session>/fixes/fix-summary-{NNN}.md`:
+
+```markdown
+# Fix Summary - {NNN}
+[fix-implementer]
+
+## Overview
+- **Total fixes applied**: {count}
+- **Critical fixed**: {count}
+- **High fixed**: {count}
+- **Medium fixed**: {count}
+- **Files modified**: {count}
+
+## Fixes Applied
+
+### Fix 1: Color contrast (Critical, WCAG 1.4.3)
+- **File**: `src/styles/globals.css:12`
+- **Before**: `--color-text: oklch(55% 0 0)` (contrast 3.2:1)
+- **After**: `--color-text: oklch(25% 0 0)` (contrast 7.2:1)
+- **Validated**: PASS
+
+### Fix 2: Focus indicators (High, WCAG 2.4.7)
+- **File**: `src/styles/globals.css:45`
+- **Before**: No :focus-visible rules
+- **After**: Added :focus-visible with 2px outline
+- **Validated**: PASS
+
+...
+
+## Files Modified
+| File | Changes |
+|------|---------|
+| src/styles/globals.css | Color adjustments, focus styles, reduced-motion |
+| src/components/Modal.tsx | Focus trap, ARIA attributes |
+| src/app/layout.tsx | Skip link |
+
+## Remaining Issues
+- {Any medium/low issues not addressed in this round}
+
+## Verification Status
+- [ ] Color contrast: {n}/{total} passing
+- [ ] Focus indicators: {n}/{total} visible
+- [ ] ARIA coverage: {n}/{total} complete
+- [ ] Typography: {n}/{total} compliant
+```
+
+3. Update `<session>/.msg/meta.json` under `fix-implementer` namespace:
+   - Read existing -> merge `{ "fix-implementer": { fix_id, total_fixes, critical_fixed, high_fixed, medium_fixed, files_modified, timestamp } }` -> write back