claude-code-workflow 7.2.26 → 7.2.28

package/.claude/skills/team-ux-improve/specs/anti-patterns.md

@@ -0,0 +1,103 @@
+# AI Slop Detection Catalog
+
+20 visual anti-patterns commonly produced by AI code generation. Use during scanning to flag design quality issues.
+
+### 1. AI Color Palette
+- **Pattern**: Cyan (#00d4ff, #06b6d4), purple-blue gradients on dark backgrounds as default aesthetic
+- **Detection**: Search for cyan/teal hex values, linear-gradient with blue-purple stops on dark bg
+- **Severity**: P1
+
+### 2. Gradient Text
+- **Pattern**: `background-clip: text` + `-webkit-text-fill-color: transparent` on headings or metric values
+- **Detection**: Grep for `background-clip:\s*text` or `-webkit-background-clip:\s*text`
+- **Severity**: P1
+
+### 3. Default Dark Mode + Glow
+- **Pattern**: Dark background (#0a0a0a, #111) with neon accent colors and box-shadow glow effects
+- **Detection**: Dark bg colors + box-shadow with colored spread on interactive elements
+- **Severity**: P2
+
+### 4. Glassmorphism Everywhere
+- **Pattern**: `backdrop-filter: blur()` applied to more than 2 components
+- **Detection**: Count occurrences of `backdrop-filter:\s*blur` across components
+- **Severity**: P1
+
+### 5. Hero Metric Layout
+- **Pattern**: Large number + small label arranged in card grid, dashboard-style metrics as default layout
+- **Detection**: Pattern of large font-size number + small text label repeated 3+ times in grid
+- **Severity**: P2
+
+### 6. Identical Card Grids
+- **Pattern**: 3+ cards with identical size, structure, and visual weight
+- **Detection**: Repeated card components with same dimensions and no visual differentiation
+- **Severity**: P2
+
+### 7. Nested Cards
+- **Pattern**: Border/shadow container inside another border/shadow container
+- **Detection**: Card component rendered inside another card component, nested border-radius + box-shadow
+- **Severity**: P2
+
+### 8. Generic Fonts
+- **Pattern**: Inter, Roboto, Open Sans, Lato, Montserrat, Arial as primary font-family
+- **Detection**: Grep font-family declarations for generic font names
+- **Severity**: P2
+
+### 9. Rounded Rect + Generic Shadow
+- **Pattern**: `border-radius: 8-16px` + `box-shadow: 0 1-4px ...` on more than 5 elements
+- **Detection**: Count elements with both border-radius and box-shadow, flag if >5
+- **Severity**: P3
+
+### 10. Large Icons Above Every Heading
+- **Pattern**: Decorative icon/emoji placed above section headings, repeated 3+ times
+- **Detection**: Icon component or SVG immediately preceding heading elements, 3+ occurrences
+- **Severity**: P2
+
+### 11. One-Side Border Accent
+- **Pattern**: `border-left: 3-4px solid <accent>` as visual accent on cards/sections
+- **Detection**: Grep for `border-left:\s*\d+px\s+solid` repeated across components
+- **Severity**: P3
+
+### 12. Decorative Sparklines
+- **Pattern**: Tiny inline charts without axis labels, data values, or interactive tooltips
+- **Detection**: Small chart components (<100px height) without label/tooltip props
+- **Severity**: P2
+
+### 13. Bounce/Elastic Easing
+- **Pattern**: `cubic-bezier` with negative control point values, spring/bounce animation keywords
+- **Detection**: Grep for `cubic-bezier\([^)]*-` or animation names containing bounce/spring/elastic
+- **Severity**: P2
+
+### 14. Redundant Copy
+- **Pattern**: Heading text restated in immediately following body paragraph with >50% word overlap
+- **Detection**: Compare heading text with first paragraph text for word overlap
+- **Severity**: P3
+
+### 15. All Buttons Primary
+- **Pattern**: Every button uses same filled/accent treatment, no visual hierarchy
+- **Detection**: All button variants resolve to same background-color, no secondary/tertiary variants
+- **Severity**: P1
+
+### 16. Everything Centered
+- **Pattern**: Body text centered (`text-align: center`), more than 60% of sections centered
+- **Detection**: Count `text-align: center` on non-heading, non-hero elements
+- **Severity**: P2
+
+### 17. Same Spacing Everywhere
+- **Pattern**: >70% of padding/margin values are identical (e.g., all `p-4` or `p-6`)
+- **Detection**: Extract padding/margin values, check distribution uniformity
+- **Severity**: P2
+
+### 18. Monospace as Tech Aesthetic
+- **Pattern**: Monospace font applied to non-code elements (headings, labels, navigation)
+- **Detection**: `font-family: monospace` or code font on non-`<code>`/`<pre>` elements
+- **Severity**: P3
+
+### 19. Modal Overuse
+- **Pattern**: More than 3 modal dialogs for non-critical interactions (settings, confirmations, info)
+- **Detection**: Count modal/dialog component usages, check trigger context
+- **Severity**: P3
+
+### 20. Pure Black/White
+- **Pattern**: #000, #fff, rgb(0,0,0), rgb(255,255,255) as primary background or text colors
+- **Detection**: Grep for exact #000, #fff, rgb(0,0,0), rgb(255,255,255) in color/background properties
+- **Severity**: P1

package/.claude/skills/team-ux-improve/specs/design-standards.md

@@ -0,0 +1,54 @@
+# Visual Design Standards
+
+Reference for visual design quality detection. Scanner and diagnoser use these standards to identify design issues.
+
+## Color Standards
+
+- **OKLCH** for perceptually uniform palettes
+- **Tinted neutrals**: chroma 0.005-0.01, never pure gray (#808080) or pure black/white (#000, #fff)
+- **60-30-10 rule**: 60% neutral, 30% secondary, 10% accent
+- **WCAG AA contrast**: normal text 4.5:1, large text 3:1, UI components 3:1
+- **Text on colored backgrounds**: use `color-mix(in oklch, ...)` not gray text
+
+## Typography Standards
+
+- **Avoid generic fonts**: Inter, Roboto, Open Sans, Lato, Montserrat, Arial
+- **Modular scale** (choose one ratio consistently): 1.125, 1.200, 1.250, 1.333
+- **Fluid sizing**: `clamp()` for display text (xl and above)
+- **Line height**: body 1.5, headings 1.2, small text 1.6
+- **Reading width**: `max-width: 65ch`
+- **Font loading**: `font-display: swap`
+
+## Spacing Standards
+
+- **4pt base scale**: 0, 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 96 px
+- **Rhythm variation**: tight (4-8px), comfortable (16-24px), generous (48-96px)
+- **Sibling spacing**: `gap` over `margin`
+- **No nested cards**. Touch targets: 44x44px min
+
+## Motion Standards
+
+- **Animate ONLY**: transform, opacity, clip-path, background-color, color, box-shadow, filter
+- **NEVER animate**: width, height, top, left, margin, padding
+- **Easing**: ease-out-quart `cubic-bezier(0.25, 1, 0.5, 1)` default. No bounce/elastic/linear
+- **Duration**: instant 100ms, fast 150ms, normal 250ms, slow 400ms
+- **Reduced motion**: `@media (prefers-reduced-motion: reduce)` REQUIRED
+
+## 8 Interaction States
+
+| State | CSS | Requirement |
+|-------|-----|-------------|
+| Default | -- | Base appearance |
+| Hover | `:hover` in `@media(hover:hover)` | Subtle change |
+| Focus | `:focus-visible` | 2px solid accent, offset 2px, 3:1 contrast |
+| Active | `:active` | Scale(0.97) or darker |
+| Disabled | `[disabled]` | Opacity 0.5 |
+| Loading | `[aria-busy]` | Spinner/skeleton |
+| Error | `[aria-invalid]` | Red border + message |
+| Success | custom | Green check |
+
+## Visual Hierarchy
+
+- **Squint test**: blur page, identify top 2 elements + groupings
+- **1 primary CTA** per viewport
+- **Progressive disclosure**: reveal complexity on demand

package/.claude/skills/team-ux-improve/specs/heuristics.md

@@ -0,0 +1,88 @@
+# Nielsen's 10 Usability Heuristics
+
+Structured evaluation framework for UX scanning. Score each 0-4.
+
+## 1. Visibility of System Status
+The system should always keep users informed about what is going on.
+- Loading indicators for async operations (> 200ms)
+- Progress bars for multi-step processes
+- State feedback (saved, syncing, error)
+- Timestamps on data ("Updated 5 minutes ago")
+- Active state indicators (selected tab, current page)
+
+## 2. Match Between System and Real World
+Speak the user's language, not technical jargon.
+- Labels use familiar words (not internal terms)
+- Icons match real-world metaphors
+- Information appears in natural/logical order
+- Dates, numbers, currencies in locale format
+
+## 3. User Control and Freedom
+Users need a clearly marked "emergency exit."
+- Undo/redo for destructive or complex actions
+- Back/cancel navigation always available
+- Escape key closes modals/popovers
+- Clear way to deselect, clear filters, reset
+
+## 4. Consistency and Standards
+Same words and actions should mean the same thing.
+- One term per concept (delete/remove/trash → pick one)
+- Same icon for same action across pages
+- Follow platform conventions (links underlined, × means close)
+- Consistent placement of actions (save always top-right, etc.)
+
+## 5. Error Prevention
+Better to prevent errors than show good error messages.
+- Confirmation for destructive actions (with undo preferred)
+- Input validation on blur (not just submit)
+- Disable invalid options (gray out, not hide)
+- Type-ahead/autocomplete for known-value fields
+- Character counts for limited fields
+
+## 6. Recognition Rather Than Recall
+Minimize user memory load.
+- Show options visibly (don't require memorization)
+- Recent items, favorites, search suggestions
+- Breadcrumbs for navigation context
+- Inline help/tooltips for non-obvious fields
+- Persistent important info (don't hide behind clicks)
+
+## 7. Flexibility and Efficiency of Use
+Accelerators for power users without confusing beginners.
+- Keyboard shortcuts for frequent actions
+- Bulk actions (select all, batch edit)
+- Customizable views/layouts
+- Search/filter as primary navigation for large datasets
+
+## 8. Aesthetic and Minimalist Design
+Every extra unit of information competes with relevant units.
+- Remove decorative elements that don't aid comprehension
+- Progressive disclosure (summary → detail on demand)
+- Visual hierarchy: clear primary, secondary, tertiary
+- Information density appropriate for use case
+
+## 9. Help Users Recognize, Diagnose, and Recover from Errors
+Error messages should be expressed in plain language.
+- Formula: what happened + why + how to fix
+- No error codes without explanation
+- Suggest specific corrective action
+- Preserve user input on error (don't clear forms)
+- Retry option for network/server errors
+
+## 10. Help and Documentation
+Easy to search, focused on user's task.
+- Contextual help (tooltips, info icons)
+- Onboarding for first-time users
+- Empty states with guidance and action
+- Keyboard shortcut reference
+- FAQ/search for complex features
+
+## Severity Scale
+
+| Rating | Description |
+|--------|-------------|
+| 0 | Not a usability problem |
+| 1 | Cosmetic — fix if time permits |
+| 2 | Minor — low priority fix |
+| 3 | Major — important to fix, high priority |
+| 4 | Catastrophe — must fix before release |

package/.claude/skills/team-ux-improve/wisdom/anti-patterns/common-ux-pitfalls.md

@@ -4,14 +4,46 @@
 - Buttons without loading states during async operations
 - Missing error handling with user feedback
 - State changes without visual updates
-- Double-click vulnerabilities
-
-## State Issues
-- Stale data after mutations
-- Race conditions in async operations
-- Missing rollback for failed optimistic updates
-
-## Feedback Issues
+- Double-click vulnerabilities (missing debounce)
+- No disabled state during processing
 - Silent failures without user notification
 - Generic error messages without actionable guidance
 - Missing confirmation for destructive actions
+- No empty state placeholder for data lists
+- Input without validation rules or inline feedback
+
+## State Management Issues
+- Stale data after mutations (direct array/object mutation)
+- Race conditions in async operations (no cancellation)
+- Missing rollback for failed optimistic updates
+- Stale closure capturing old state value
+- Missing loading/error/success state tracking
+
+## Visual Design Anti-Patterns (AI Slop)
+- AI Color Palette: cyan-on-dark, purple gradients (zero design intent)
+- Gradient text: background-clip: text as emphasis crutch
+- Glassmorphism everywhere: backdrop-filter as default aesthetic
+- All Buttons Primary: no visual hierarchy, every button filled
+- Pure Black/White: #000/#fff without tint (harsh, sterile)
+- Generic fonts: Inter, Roboto as defaults (forgettable)
+- Identical card grids: all items same visual weight
+- Nested cards: cards inside cards creating noise
+- Same spacing everywhere: no rhythm variation
+- Bounce/elastic easing: dated animation feel
+- Everything centered: including body text
+
+## Motion Issues
+- Layout animations (width/height/margin/padding triggers)
+- No reduced-motion query (@media prefers-reduced-motion)
+- CSS will-change set permanently (GPU waste)
+- ease/linear as default easing (unnatural)
+- Stagger exceeding 500ms total
+
+## Accessibility Issues
+- outline: none without :focus-visible replacement
+- Missing :focus-visible (using bare :focus)
+- Color-only state indication
+- Touch targets < 44px
+- No skip links
+- Placeholder used as label
+- Missing aria-describedby for error messages

package/.claude/skills/team-ux-improve/wisdom/patterns/state-management.md

@@ -1,14 +1,34 @@
 # State Management Patterns
 
-## Local Component State
-- Use for UI-only state (open/closed, hover, focus)
-- Keep close to where it's used
-
-## Shared State
-- Lift state to lowest common ancestor
-- Use context or state management library for deep trees
-
-## Async State
-- Track loading, error, and success states
-- Handle race conditions with request cancellation
-- Implement retry logic with exponential backoff
+## Reactive Update Rules
+- NEVER mutate arrays/objects directly
+- React: use spread operator, filter/map for new references
+- Vue: use ref() for primitives, reactive() for objects, computed() for derived
+- Always trigger re-render through proper state API
+
+## Async State Pattern
+```
+const [data, setData] = useState(null);
+const [loading, setLoading] = useState(false);
+const [error, setError] = useState(null);
+
+// Always: loading -> success/error -> cleanup
+```
+
+## Race Condition Prevention
+- AbortController for fetch cancellation
+- Debounce for search/filter inputs (250-500ms)
+- Latest-wins pattern for concurrent requests
+- Disable trigger during processing
+
+## Optimistic Updates
+- Update UI immediately
+- Track pending state
+- Rollback on failure with error notification
+- Never lose user data silently
+
+## Form State
+- Controlled inputs (React) / v-model (Vue)
+- Validation on blur + on submit
+- Error clearing on re-input
+- Dirty tracking for unsaved changes warning

package/.claude/skills/team-ux-improve/wisdom/patterns/ui-feedback.md

@@ -1,16 +1,40 @@
 # UI Feedback Patterns
 
 ## Loading States
-- Use skeleton loaders for content areas
-- Disable buttons during async operations
-- Show progress indicators for long operations
+- Button: set disabled + aria-busy="true", show spinner, restore on complete
+- Page: skeleton screens (prefer over spinners for content areas)
+- Inline: progress indicator for multi-step operations
+- Duration: show loading after 200ms delay (avoid flash for fast operations)
 
-## Error Handling
-- Display errors inline when possible
-- Provide actionable error messages
-- Allow retry for transient failures
+## Error States
+- Form: inline validation with aria-invalid + aria-describedby
+- API: toast/snackbar for non-blocking, inline for blocking errors
+- Error message: specific, actionable (not "Something went wrong")
+- Visual: red border on input, error icon, error text below
 
-## Success Feedback
-- Toast notifications for non-critical successes
-- Inline confirmation for critical actions
-- Auto-dismiss non-critical notifications
+## Success States
+- Form submit: success message + next action guidance
+- CRUD: optimistic update with subtle confirmation
+- Duration: success message visible 3-5 seconds
+
+## Empty States
+- Data list: illustration + message + primary action
+- Search: "No results" + suggestions
+- First use: onboarding guidance
+
+## Focus Feedback
+- :focus-visible only (not bare :focus)
+- Ring: 2px solid accent, offset 2px
+- Contrast: 3:1 against adjacent colors
+- Custom for dark backgrounds: lighter ring color
+
+## Hover Feedback
+- Wrap in @media(hover:hover) for touch safety
+- Subtle: background opacity change or slight color shift
+- Duration: 100-150ms transition
+- Cursor: pointer for clickable, not-allowed for disabled
+
+## Active Feedback
+- Scale: transform: scale(0.97) for physical feel
+- Or: darker background shade
+- Duration: instant (< 50ms feel)

package/.claude/skills/team-ux-improve/wisdom/principles/general-ux.md

@@ -1,16 +1,43 @@
 # General UX Principles
 
 ## Feedback & Responsiveness
-- Every user action should have immediate visual feedback
-- Loading states must be shown for operations >200ms
-- Success/error states should be clearly communicated
+- Every user action must have immediate visual feedback (< 100ms perceived)
+- Loading states for operations > 200ms: use skeleton/spinner, set aria-busy="true"
+- Success/error states clearly communicated with both visual and ARIA cues
+- Feedback duration: 100-150ms for hover/active/focus transitions
+- State change transitions: 200-300ms
+- Layout changes: 300-500ms
+
+## Interaction States (8 Required)
+Every interactive element must define all 8 states:
+1. Default — base appearance
+2. Hover — subtle bg/opacity change, wrap in @media(hover:hover)
+3. Focus — :focus-visible with 2px solid accent, offset 2px, 3:1 contrast ratio
+4. Active — scale(0.97) or darker background
+5. Disabled — opacity 0.5, cursor: not-allowed, aria-disabled="true"
+6. Loading — spinner/skeleton, disable interaction, aria-busy="true"
+7. Error — red border, error message below, aria-invalid="true"
+8. Success — green check, success message
 
 ## State Management
-- UI state should reflect the underlying data state
-- Optimistic updates should have rollback mechanisms
-- State changes should be atomic and predictable
+- UI state must reflect underlying data state immediately
+- Optimistic updates must have rollback mechanisms
+- State changes must be atomic and predictable
+- No direct array/object mutation (use spread/filter/map for reactive frameworks)
+- Race conditions: use request cancellation or debounce
+
+## Visual Design Quality
+- Color: OKLCH-based, tinted neutrals (never pure gray/black/white), 60-30-10 rule
+- Typography: distinctive fonts (not Inter/Roboto), modular scale, fluid clamp()
+- Spacing: 4pt base scale with varied rhythm (tight/comfortable/generous)
+- Motion: transform+opacity only, ease-out-quart easing, reduced-motion query required
+- Hierarchy: squint test, single primary CTA per viewport
 
 ## Accessibility
-- Interactive elements must be keyboard accessible
-- Color should not be the only indicator of state
-- Focus states must be visible
+- All interactive elements keyboard accessible (tab + enter/space)
+- Color must NOT be the only indicator of state
+- Focus states must use :focus-visible (not bare :focus)
+- Focus ring: 3:1 contrast against adjacent colors
+- Touch targets: minimum 44x44px, 8px gap between adjacent
+- Visible labels on all form inputs (placeholder is not a label)
+- Skip links for keyboard navigation

package/.claude/skills/team-visual-a11y/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: team-visual-a11y
+description: Unified team skill for visual accessibility QA. OKLCH color contrast, typography readability, focus management, WCAG AA/AAA audit at rendered level. Uses team-worker agent architecture. Triggers on "team visual a11y", "accessibility audit", "visual a11y".
+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__emulate, mcp__chrome-devtools__lighthouse_audit, mcp__chrome-devtools__navigate_page, mcp__chrome-devtools__resize_page
+---
+
+# Team Visual Accessibility
+
+Deep visual accessibility QA: OKLCH-based perceptual color contrast, typography readability at all viewports, focus-visible completeness, WCAG AA/AAA audit at rendered level. 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-visual-a11y", 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       |
+           [3 auditors spawn in PARALLEL]   |
+        color-auditor  typo-auditor  focus-auditor
+                    |       |       |
+                    +---+---+---+---+
+                        v
+               remediation-planner
+                        |
+                        v
+               fix-implementer (inner_loop)
+                        |
+                        v
+               [re-audit: color + focus in PARALLEL]
+```
+
+## Role Registry
+
+| Role | Path | Prefix | Inner Loop |
+|------|------|--------|------------|
+| coordinator | [roles/coordinator/role.md](roles/coordinator/role.md) | -- | -- |
+| color-auditor | [roles/color-auditor/role.md](roles/color-auditor/role.md) | COLOR-* | false |
+| typo-auditor | [roles/typo-auditor/role.md](roles/typo-auditor/role.md) | TYPO-* | false |
+| focus-auditor | [roles/focus-auditor/role.md](roles/focus-auditor/role.md) | FOCUS-* | false |
+| remediation-planner | [roles/remediation-planner/role.md](roles/remediation-planner/role.md) | REMED-* | false |
+| fix-implementer | [roles/fix-implementer/role.md](roles/fix-implementer/role.md) | FIX-* | true |
+
+## 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**: `VA`
+- **Session path**: `.workflow/.team/VA-<slug>-<date>/`
+- **team_name**: `visual-a11y`
+- **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: "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 (@<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/oklch-standards.md](specs/oklch-standards.md) -- OKLCH color accessibility rules
+- [specs/wcag-matrix.md](specs/wcag-matrix.md) -- WCAG 2.1 criteria matrix
+- [specs/typography-scale.md](specs/typography-scale.md) -- Typography accessibility rules
+- [specs/focus-patterns.md](specs/focus-patterns.md) -- Focus management patterns
+
+## Session Directory
+
+```
+.workflow/.team/VA-<slug>-<date>/
++-- .msg/
+|   +-- messages.jsonl         # Team message bus
+|   +-- meta.json              # Pipeline config + GC state
++-- audits/
+|   +-- color/                 # Color auditor output
+|   |   +-- color-audit-001.md
+|   +-- typography/            # Typography auditor output
+|   |   +-- typo-audit-001.md
+|   +-- focus/                 # Focus auditor output
+|       +-- focus-audit-001.md
++-- remediation/               # Remediation planner output
+|   +-- remediation-plan.md
++-- fixes/                     # Fix implementer output
+|   +-- fix-summary-001.md
++-- re-audit/                  # Re-audit output (GC loop)
+|   +-- color-audit-002.md
+|   +-- focus-audit-002.md
++-- evidence/                  # Screenshots, traces
+```
+
+## 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 |
+| Chrome DevTools unavailable | Degrade to static analysis only |