maestro-flow 0.5.36 → 0.5.37

package/.claude/skills/team-visual-a11y/specs/typography-scale.md

@@ -1,165 +1,165 @@
-# Typography Accessibility Standards
-
-Reference guide for typography readability analysis. Used by typo-auditor and fix-implementer roles.
-
-## Font Stack Hierarchy
-
-| Purpose | Category | Example | Usage |
-|---------|----------|---------|-------|
-| Display | Serif | Cormorant Garamond, Georgia, serif | Headings, hero text |
-| Body | Sans-serif | Instrument Sans, Inter, system-ui, sans-serif | Paragraphs, UI text |
-| Mono | Monospace | Space Grotesk, Fira Code, monospace | Code blocks, labels |
-
-### System Font Stack (Fallback)
-
-```css
---font-body: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
---font-mono: ui-monospace, "Cascadia Code", "Fira Code", Menlo, monospace;
-```
-
-## Responsive Size Scale
-
-### clamp() Formula Pattern
-
-```css
-/* clamp(minimum, preferred, maximum) */
-/* preferred = slope * 100vw + intercept */
-/* slope = (max - min) / (max-viewport - min-viewport) */
-```
-
-### Recommended Scale
-
-| Element | clamp() Value | Min (320px) | Max (1400px) | WCAG |
-|---------|--------------|-------------|-------------|------|
-| Hero | `clamp(2.5rem, 7vw, 4.5rem)` | 40px | 72px | -- |
-| Section title | `clamp(1.75rem, 4vw, 2.5rem)` | 28px | 40px | -- |
-| H1 | `clamp(2rem, 5vw, 3rem)` | 32px | 48px | -- |
-| H2 | `clamp(1.5rem, 3vw, 2.25rem)` | 24px | 36px | -- |
-| H3 | `clamp(1.25rem, 2vw, 1.75rem)` | 20px | 28px | -- |
-| Body | `clamp(1rem, 1vw + 0.875rem, 1.25rem)` | 16px | 20px | 1.4.4 |
-| Small/caption | 14px (fixed floor) | 14px | 14px | 1.4.4 |
-
-### Absolute Minimums
-
-| Element | Minimum | Rationale |
-|---------|---------|-----------|
-| Body text | 16px | WCAG 1.4.4 baseline readability |
-| Small text / caption | 14px | Absolute floor for legibility |
-| Interactive labels | 14px | Touch/click target readability |
-
-**Never**: Set body text below 14px at any viewport width.
-
-## Line Height Scale
-
-| Element Type | Range | Optimal | Rationale |
-|-------------|-------|---------|-----------|
-| Body text | 1.5 - 1.75 | 1.625 | WCAG 1.4.12, optimal readability |
-| Headings | 1.1 - 1.3 | 1.2 | Tight for visual impact, still readable |
-| Code blocks | 1.5 - 1.7 | 1.6 | Generous for scanning |
-| Buttons/labels | 1.2 - 1.5 | 1.3 | Compact UI element |
-| Lists | 1.4 - 1.6 | 1.5 | Slightly tighter than body |
-
-### Line Height Rules
-
-- Use unitless values (not px or em) for proper inheritance
-- `line-height: 1.5` (unitless) is preferred over `line-height: 24px` (fixed)
-- WCAG 1.4.12 requires text to remain readable at 1.5x font-size line-height
-
-## Letter Spacing Scale
-
-| Element Type | Range | Optimal | Notes |
-|-------------|-------|---------|-------|
-| Display headings | -0.02em to 0 | -0.015em | Tight for visual weight |
-| Body text | 0 (default) | 0 | Browser default is optimal |
-| Uppercase labels | 0.05em - 0.1em | 0.08em | Open for legibility |
-| Monospace code | 0.08em - 0.15em | 0.1em | Wide for character distinction |
-| Small caps | 0.05em - 0.08em | 0.06em | Slight opening |
-
-### WCAG 1.4.12 Override Requirements
-
-Content must remain readable when user applies:
-- Letter spacing: 0.12em
-- Word spacing: 0.16em
-- These overrides should not cause content overflow or overlap
-
-## Reading Width
-
-| Metric | Optimal | Acceptable | Flag |
-|--------|---------|-----------|------|
-| Characters per line | 66ch | 45-75ch | < 45 (too narrow) or > 75 (too wide) |
-| Container max-width | 65ch | 60ch-75ch | > 80ch |
-| Content column width | Up to 900px | Up to 1000px | > 1000px without columns |
-
-### Implementation
-
-```css
-/* Preferred: ch-based */
-.content { max-width: 70ch; }
-
-/* Alternative: px-based */
-.content { max-width: 700px; }
-
-/* With centering */
-.content {
-  max-width: 70ch;
-  margin-inline: auto;
-  padding-inline: 1rem;
-}
-```
-
-## Font Loading Strategy
-
-### font-display Values
-
-| Value | Behavior | Recommended For |
-|-------|----------|----------------|
-| `swap` | Show fallback immediately, swap when loaded | Body text |
-| `optional` | Show fallback, swap only if already cached | Display/decorative fonts |
-| `fallback` | Brief invisible period (~100ms), then fallback | Important fonts |
-| `block` | Invisible text up to 3s | Avoid for body text |
-| `auto` | Browser decides | Avoid (unpredictable) |
-
-### Best Practices
-
-```css
-/* Body font: swap for immediate readability */
-@font-face {
-  font-family: "Body Font";
-  src: url("body.woff2") format("woff2");
-  font-display: swap;
-}
-
-/* Display font: optional to prevent layout shift */
-@font-face {
-  font-family: "Display Font";
-  src: url("display.woff2") format("woff2");
-  font-display: optional;
-}
-```
-
-### Preloading Critical Fonts
-
-```html
-<link rel="preload" href="/fonts/body.woff2" as="font" type="font/woff2" crossorigin>
-```
-
-### Fallback Stack Requirements
-
-- Every custom font must have a system fallback
-- Fallback should have similar metrics (x-height, width) to minimize layout shift
-- Use `size-adjust`, `ascent-override`, `descent-override` for metric matching
-
-## Responsive Typography Checklist
-
-| # | Check | Standard | Method |
-|---|-------|----------|--------|
-| 1 | Body text >= 16px at 320px | WCAG 1.4.4 | Computed style at mobile viewport |
-| 2 | No text below 14px at any viewport | Best practice | Search for font-size values |
-| 3 | clamp() min >= 14px | Best practice | Parse clamp() functions |
-| 4 | Line-height unitless | Best practice | Search for px/em line-height |
-| 5 | Body line-height 1.5-1.75 | WCAG 1.4.12 | Computed style check |
-| 6 | Reading width 45-75ch | Best practice | Measure container + font size |
-| 7 | font-display: swap on body | Best practice | Parse @font-face rules |
-| 8 | System fallback defined | Best practice | Parse font-family stacks |
-| 9 | 200% zoom no overflow | WCAG 1.4.4 | Zoom test |
-| 10 | Text spacing override safe | WCAG 1.4.12 | Apply overrides, check layout |
+# Typography Accessibility Standards
+
+Reference guide for typography readability analysis. Used by typo-auditor and fix-implementer roles.
+
+## Font Stack Hierarchy
+
+| Purpose | Category | Example | Usage |
+|---------|----------|---------|-------|
+| Display | Serif | Cormorant Garamond, Georgia, serif | Headings, hero text |
+| Body | Sans-serif | Instrument Sans, Inter, system-ui, sans-serif | Paragraphs, UI text |
+| Mono | Monospace | Space Grotesk, Fira Code, monospace | Code blocks, labels |
+
+### System Font Stack (Fallback)
+
+```css
+--font-body: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+--font-mono: ui-monospace, "Cascadia Code", "Fira Code", Menlo, monospace;
+```
+
+## Responsive Size Scale
+
+### clamp() Formula Pattern
+
+```css
+/* clamp(minimum, preferred, maximum) */
+/* preferred = slope * 100vw + intercept */
+/* slope = (max - min) / (max-viewport - min-viewport) */
+```
+
+### Recommended Scale
+
+| Element | clamp() Value | Min (320px) | Max (1400px) | WCAG |
+|---------|--------------|-------------|-------------|------|
+| Hero | `clamp(2.5rem, 7vw, 4.5rem)` | 40px | 72px | -- |
+| Section title | `clamp(1.75rem, 4vw, 2.5rem)` | 28px | 40px | -- |
+| H1 | `clamp(2rem, 5vw, 3rem)` | 32px | 48px | -- |
+| H2 | `clamp(1.5rem, 3vw, 2.25rem)` | 24px | 36px | -- |
+| H3 | `clamp(1.25rem, 2vw, 1.75rem)` | 20px | 28px | -- |
+| Body | `clamp(1rem, 1vw + 0.875rem, 1.25rem)` | 16px | 20px | 1.4.4 |
+| Small/caption | 14px (fixed floor) | 14px | 14px | 1.4.4 |
+
+### Absolute Minimums
+
+| Element | Minimum | Rationale |
+|---------|---------|-----------|
+| Body text | 16px | WCAG 1.4.4 baseline readability |
+| Small text / caption | 14px | Absolute floor for legibility |
+| Interactive labels | 14px | Touch/click target readability |
+
+**Never**: Set body text below 14px at any viewport width.
+
+## Line Height Scale
+
+| Element Type | Range | Optimal | Rationale |
+|-------------|-------|---------|-----------|
+| Body text | 1.5 - 1.75 | 1.625 | WCAG 1.4.12, optimal readability |
+| Headings | 1.1 - 1.3 | 1.2 | Tight for visual impact, still readable |
+| Code blocks | 1.5 - 1.7 | 1.6 | Generous for scanning |
+| Buttons/labels | 1.2 - 1.5 | 1.3 | Compact UI element |
+| Lists | 1.4 - 1.6 | 1.5 | Slightly tighter than body |
+
+### Line Height Rules
+
+- Use unitless values (not px or em) for proper inheritance
+- `line-height: 1.5` (unitless) is preferred over `line-height: 24px` (fixed)
+- WCAG 1.4.12 requires text to remain readable at 1.5x font-size line-height
+
+## Letter Spacing Scale
+
+| Element Type | Range | Optimal | Notes |
+|-------------|-------|---------|-------|
+| Display headings | -0.02em to 0 | -0.015em | Tight for visual weight |
+| Body text | 0 (default) | 0 | Browser default is optimal |
+| Uppercase labels | 0.05em - 0.1em | 0.08em | Open for legibility |
+| Monospace code | 0.08em - 0.15em | 0.1em | Wide for character distinction |
+| Small caps | 0.05em - 0.08em | 0.06em | Slight opening |
+
+### WCAG 1.4.12 Override Requirements
+
+Content must remain readable when user applies:
+- Letter spacing: 0.12em
+- Word spacing: 0.16em
+- These overrides should not cause content overflow or overlap
+
+## Reading Width
+
+| Metric | Optimal | Acceptable | Flag |
+|--------|---------|-----------|------|
+| Characters per line | 66ch | 45-75ch | < 45 (too narrow) or > 75 (too wide) |
+| Container max-width | 65ch | 60ch-75ch | > 80ch |
+| Content column width | Up to 900px | Up to 1000px | > 1000px without columns |
+
+### Implementation
+
+```css
+/* Preferred: ch-based */
+.content { max-width: 70ch; }
+
+/* Alternative: px-based */
+.content { max-width: 700px; }
+
+/* With centering */
+.content {
+  max-width: 70ch;
+  margin-inline: auto;
+  padding-inline: 1rem;
+}
+```
+
+## Font Loading Strategy
+
+### font-display Values
+
+| Value | Behavior | Recommended For |
+|-------|----------|----------------|
+| `swap` | Show fallback immediately, swap when loaded | Body text |
+| `optional` | Show fallback, swap only if already cached | Display/decorative fonts |
+| `fallback` | Brief invisible period (~100ms), then fallback | Important fonts |
+| `block` | Invisible text up to 3s | Avoid for body text |
+| `auto` | Browser decides | Avoid (unpredictable) |
+
+### Best Practices
+
+```css
+/* Body font: swap for immediate readability */
+@font-face {
+  font-family: "Body Font";
+  src: url("body.woff2") format("woff2");
+  font-display: swap;
+}
+
+/* Display font: optional to prevent layout shift */
+@font-face {
+  font-family: "Display Font";
+  src: url("display.woff2") format("woff2");
+  font-display: optional;
+}
+```
+
+### Preloading Critical Fonts
+
+```html
+<link rel="preload" href="/fonts/body.woff2" as="font" type="font/woff2" crossorigin>
+```
+
+### Fallback Stack Requirements
+
+- Every custom font must have a system fallback
+- Fallback should have similar metrics (x-height, width) to minimize layout shift
+- Use `size-adjust`, `ascent-override`, `descent-override` for metric matching
+
+## Responsive Typography Checklist
+
+| # | Check | Standard | Method |
+|---|-------|----------|--------|
+| 1 | Body text >= 16px at 320px | WCAG 1.4.4 | Computed style at mobile viewport |
+| 2 | No text below 14px at any viewport | Best practice | Search for font-size values |
+| 3 | clamp() min >= 14px | Best practice | Parse clamp() functions |
+| 4 | Line-height unitless | Best practice | Search for px/em line-height |
+| 5 | Body line-height 1.5-1.75 | WCAG 1.4.12 | Computed style check |
+| 6 | Reading width 45-75ch | Best practice | Measure container + font size |
+| 7 | font-display: swap on body | Best practice | Parse @font-face rules |
+| 8 | System fallback defined | Best practice | Parse font-family stacks |
+| 9 | 200% zoom no overflow | WCAG 1.4.4 | Zoom test |
+| 10 | Text spacing override safe | WCAG 1.4.12 | Apply overrides, check layout |

package/.claude/skills/team-visual-a11y/specs/wcag-matrix.md

@@ -1,133 +1,133 @@
-# WCAG 2.1 Criteria Matrix
-
-Reference matrix for visual accessibility audit. Maps WCAG success criteria to audit methods and responsible roles.
-
-## Criteria Covered by This Team
-
-| Criterion | Level | Automated | Manual | Check Method | Primary Role |
-|-----------|-------|-----------|--------|-------------|-------------|
-| 1.4.3 Contrast (Minimum) | AA | Yes | - | Color ratio calculation (4.5:1 normal, 3:1 large) | color-auditor |
-| 1.4.6 Contrast (Enhanced) | AAA | Yes | - | Color ratio calculation (7:1 normal, 4.5:1 large) | color-auditor |
-| 1.4.11 Non-text Contrast | AA | Partial | Yes | UI component border/fill contrast >= 3:1 | color-auditor |
-| 1.4.4 Resize Text | AA | Yes | - | 200% zoom, no content loss | typo-auditor |
-| 1.4.12 Text Spacing | AA | Partial | Yes | Override line-height 1.5x, letter-spacing 0.12em, word-spacing 0.16em | typo-auditor |
-| 2.1.1 Keyboard | A | Partial | Yes | Tab through all interactive elements | focus-auditor |
-| 2.1.2 No Keyboard Trap | A | - | Yes | Tab can escape all contexts (except intentional traps with Escape) | focus-auditor |
-| 2.4.1 Bypass Blocks | A | Yes | - | Skip link present and functional | focus-auditor |
-| 2.4.3 Focus Order | A | - | Yes | Logical tab sequence | focus-auditor |
-| 2.4.7 Focus Visible | AA | Partial | Yes | Visible focus indicator on all interactive elements | focus-auditor |
-| 2.4.11 Focus Not Obscured (Min) | AA | - | Yes | Focus indicator not hidden by overlays, sticky headers | focus-auditor |
-| 2.5.8 Target Size (Minimum) | AA | Yes | - | Minimum 24x24px CSS pixel touch targets | focus-auditor |
-| 4.1.2 Name, Role, Value | A | Yes | - | ARIA roles, labels, and states on interactive elements | focus-auditor |
-| 4.1.3 Status Messages | AA | Partial | Yes | aria-live regions for dynamic status updates | focus-auditor |
-
-## Audit Method Legend
-
-| Method | Description |
-|--------|-------------|
-| Automated | Can be verified programmatically (CSS parsing, contrast calculation) |
-| Manual | Requires human judgment or runtime interaction |
-| Partial | Automated detection of presence, manual verification of correctness |
-
-## Criterion Details
-
-### 1.4.3 Contrast (Minimum) - AA
-
-**Requirement**: Text and images of text have a contrast ratio of at least 4.5:1 (3:1 for large text).
-
-**Large text definition**: >= 18pt (24px) or >= 14pt bold (18.66px bold).
-
-**Exceptions**: Decorative text, logos, inactive UI components.
-
-**Check**: Extract foreground/background colors -> calculate contrast ratio -> compare against threshold.
-
-### 1.4.6 Contrast (Enhanced) - AAA
-
-**Requirement**: Text has contrast ratio of at least 7:1 (4.5:1 for large text).
-
-**Check**: Same as 1.4.3 but with higher thresholds.
-
-### 1.4.11 Non-text Contrast - AA
-
-**Requirement**: UI components and graphical objects have at least 3:1 contrast against adjacent colors.
-
-**Applies to**: Buttons, inputs, icons, focus indicators, charts, custom controls.
-
-**Check**: Extract border/fill colors of UI components -> calculate contrast against background.
-
-### 1.4.4 Resize Text - AA
-
-**Requirement**: Text can be resized up to 200% without loss of content or functionality.
-
-**Check**: Zoom to 200% -> verify no horizontal scrolling, no content clipping, no overlap.
-
-### 1.4.12 Text Spacing - AA
-
-**Requirement**: Content must remain readable when user overrides:
-- Line height to 1.5x font size
-- Paragraph spacing to 2x font size
-- Letter spacing to 0.12x font size
-- Word spacing to 0.16x font size
-
-**Check**: Apply overrides via JavaScript/CSS -> verify no content loss or overlap.
-
-### 2.1.1 Keyboard - A
-
-**Requirement**: All functionality available via keyboard (Enter, Space, Tab, Arrow keys, Escape).
-
-**Check**: Tab to every interactive element -> activate with Enter/Space -> navigate composites with Arrows.
-
-### 2.1.2 No Keyboard Trap - A
-
-**Requirement**: Keyboard focus can be moved away from any component using standard keys.
-
-**Exception**: Modal dialogs that trap focus intentionally (must have Escape to exit).
-
-**Check**: Tab forward and backward through all elements -> verify escape from all containers.
-
-### 2.4.1 Bypass Blocks - A
-
-**Requirement**: Mechanism to bypass repeated content blocks (skip links, landmarks, headings).
-
-**Check**: Verify skip link as first focusable element, target exists, focus moves correctly.
-
-### 2.4.3 Focus Order - A
-
-**Requirement**: Focus order preserves meaning and operability (logical sequence).
-
-**Check**: Tab through page -> verify order matches visual/reading order.
-
-### 2.4.7 Focus Visible - AA
-
-**Requirement**: Keyboard focus indicator is visible on all interactive elements.
-
-**Check**: Tab to each element -> verify visible outline/border/shadow change.
-
-### 2.4.11 Focus Not Obscured (Minimum) - AA
-
-**Requirement**: Focused element is not entirely hidden by other content (sticky headers, overlays, banners).
-
-**Check**: Tab through elements near sticky/fixed positioned elements -> verify focus indicator partially visible.
-
-### 2.5.8 Target Size (Minimum) - AA
-
-**Requirement**: Interactive targets are at least 24x24 CSS pixels, or have adequate spacing.
-
-**Exceptions**: Inline links within text, user agent default controls, essential presentation.
-
-**Check**: Measure interactive element dimensions -> verify >= 24x24px or adequate spacing.
-
-### 4.1.2 Name, Role, Value - A
-
-**Requirement**: All UI components have accessible name, role, and state programmatically determined.
-
-**Check**: Verify interactive elements have:
-- Accessible name (text content, aria-label, aria-labelledby)
-- Appropriate role (native HTML or ARIA role)
-- Current state (aria-expanded, aria-pressed, aria-selected, aria-checked)
-
-### 4.1.3 Status Messages - AA
-
-**Requirement**: Status messages can be programmatically determined through role or properties without receiving focus.
-
-**Check**: Verify dynamic content updates use `aria-live` or appropriate roles (`status`, `alert`, `log`).
+# WCAG 2.1 Criteria Matrix
+
+Reference matrix for visual accessibility audit. Maps WCAG success criteria to audit methods and responsible roles.
+
+## Criteria Covered by This Team
+
+| Criterion | Level | Automated | Manual | Check Method | Primary Role |
+|-----------|-------|-----------|--------|-------------|-------------|
+| 1.4.3 Contrast (Minimum) | AA | Yes | - | Color ratio calculation (4.5:1 normal, 3:1 large) | color-auditor |
+| 1.4.6 Contrast (Enhanced) | AAA | Yes | - | Color ratio calculation (7:1 normal, 4.5:1 large) | color-auditor |
+| 1.4.11 Non-text Contrast | AA | Partial | Yes | UI component border/fill contrast >= 3:1 | color-auditor |
+| 1.4.4 Resize Text | AA | Yes | - | 200% zoom, no content loss | typo-auditor |
+| 1.4.12 Text Spacing | AA | Partial | Yes | Override line-height 1.5x, letter-spacing 0.12em, word-spacing 0.16em | typo-auditor |
+| 2.1.1 Keyboard | A | Partial | Yes | Tab through all interactive elements | focus-auditor |
+| 2.1.2 No Keyboard Trap | A | - | Yes | Tab can escape all contexts (except intentional traps with Escape) | focus-auditor |
+| 2.4.1 Bypass Blocks | A | Yes | - | Skip link present and functional | focus-auditor |
+| 2.4.3 Focus Order | A | - | Yes | Logical tab sequence | focus-auditor |
+| 2.4.7 Focus Visible | AA | Partial | Yes | Visible focus indicator on all interactive elements | focus-auditor |
+| 2.4.11 Focus Not Obscured (Min) | AA | - | Yes | Focus indicator not hidden by overlays, sticky headers | focus-auditor |
+| 2.5.8 Target Size (Minimum) | AA | Yes | - | Minimum 24x24px CSS pixel touch targets | focus-auditor |
+| 4.1.2 Name, Role, Value | A | Yes | - | ARIA roles, labels, and states on interactive elements | focus-auditor |
+| 4.1.3 Status Messages | AA | Partial | Yes | aria-live regions for dynamic status updates | focus-auditor |
+
+## Audit Method Legend
+
+| Method | Description |
+|--------|-------------|
+| Automated | Can be verified programmatically (CSS parsing, contrast calculation) |
+| Manual | Requires human judgment or runtime interaction |
+| Partial | Automated detection of presence, manual verification of correctness |
+
+## Criterion Details
+
+### 1.4.3 Contrast (Minimum) - AA
+
+**Requirement**: Text and images of text have a contrast ratio of at least 4.5:1 (3:1 for large text).
+
+**Large text definition**: >= 18pt (24px) or >= 14pt bold (18.66px bold).
+
+**Exceptions**: Decorative text, logos, inactive UI components.
+
+**Check**: Extract foreground/background colors -> calculate contrast ratio -> compare against threshold.
+
+### 1.4.6 Contrast (Enhanced) - AAA
+
+**Requirement**: Text has contrast ratio of at least 7:1 (4.5:1 for large text).
+
+**Check**: Same as 1.4.3 but with higher thresholds.
+
+### 1.4.11 Non-text Contrast - AA
+
+**Requirement**: UI components and graphical objects have at least 3:1 contrast against adjacent colors.
+
+**Applies to**: Buttons, inputs, icons, focus indicators, charts, custom controls.
+
+**Check**: Extract border/fill colors of UI components -> calculate contrast against background.
+
+### 1.4.4 Resize Text - AA
+
+**Requirement**: Text can be resized up to 200% without loss of content or functionality.
+
+**Check**: Zoom to 200% -> verify no horizontal scrolling, no content clipping, no overlap.
+
+### 1.4.12 Text Spacing - AA
+
+**Requirement**: Content must remain readable when user overrides:
+- Line height to 1.5x font size
+- Paragraph spacing to 2x font size
+- Letter spacing to 0.12x font size
+- Word spacing to 0.16x font size
+
+**Check**: Apply overrides via JavaScript/CSS -> verify no content loss or overlap.
+
+### 2.1.1 Keyboard - A
+
+**Requirement**: All functionality available via keyboard (Enter, Space, Tab, Arrow keys, Escape).
+
+**Check**: Tab to every interactive element -> activate with Enter/Space -> navigate composites with Arrows.
+
+### 2.1.2 No Keyboard Trap - A
+
+**Requirement**: Keyboard focus can be moved away from any component using standard keys.
+
+**Exception**: Modal dialogs that trap focus intentionally (must have Escape to exit).
+
+**Check**: Tab forward and backward through all elements -> verify escape from all containers.
+
+### 2.4.1 Bypass Blocks - A
+
+**Requirement**: Mechanism to bypass repeated content blocks (skip links, landmarks, headings).
+
+**Check**: Verify skip link as first focusable element, target exists, focus moves correctly.
+
+### 2.4.3 Focus Order - A
+
+**Requirement**: Focus order preserves meaning and operability (logical sequence).
+
+**Check**: Tab through page -> verify order matches visual/reading order.
+
+### 2.4.7 Focus Visible - AA
+
+**Requirement**: Keyboard focus indicator is visible on all interactive elements.
+
+**Check**: Tab to each element -> verify visible outline/border/shadow change.
+
+### 2.4.11 Focus Not Obscured (Minimum) - AA
+
+**Requirement**: Focused element is not entirely hidden by other content (sticky headers, overlays, banners).
+
+**Check**: Tab through elements near sticky/fixed positioned elements -> verify focus indicator partially visible.
+
+### 2.5.8 Target Size (Minimum) - AA
+
+**Requirement**: Interactive targets are at least 24x24 CSS pixels, or have adequate spacing.
+
+**Exceptions**: Inline links within text, user agent default controls, essential presentation.
+
+**Check**: Measure interactive element dimensions -> verify >= 24x24px or adequate spacing.
+
+### 4.1.2 Name, Role, Value - A
+
+**Requirement**: All UI components have accessible name, role, and state programmatically determined.
+
+**Check**: Verify interactive elements have:
+- Accessible name (text content, aria-label, aria-labelledby)
+- Appropriate role (native HTML or ARIA role)
+- Current state (aria-expanded, aria-pressed, aria-selected, aria-checked)
+
+### 4.1.3 Status Messages - AA
+
+**Requirement**: Status messages can be programmatically determined through role or properties without receiving focus.
+
+**Check**: Verify dynamic content updates use `aria-live` or appropriate roles (`status`, `alert`, `log`).

package/.codex/skills/codify-to-knowhow/SKILL.md

@@ -56,7 +56,7 @@ $codify-to-knowhow ".workflow/reference_style/my-style-v1"
 - `<package-path>` (positional, required): Directory containing `knowhow-manifest.json`
 
 **Upstream**: `maestro-ui-codify`, `learn-decompose`, or any skill that generates a manifest
-**Downstream**: `maestro search --category coding`, `maestro spec load --keyword <slug>`
+**Downstream**: `maestro search --category coding`, `maestro load --type spec --keyword <slug>`
 </context>
 
 <manifest_schema>
@@ -398,8 +398,8 @@ Wiki Index: refreshed
 
 Next steps:
   maestro search --category coding    # Browse by role
-  maestro spec load --keyword {slug}    # Load related specs
-  maestro wiki load <id>                # Load full entry
+  maestro load --type spec --keyword {slug}    # Load related specs
+  maestro load --type knowhow --id <id>                # Load full entry
 ```
 
 </execution>

package/.codex/skills/learn-decompose/SKILL.md

@@ -50,7 +50,7 @@ $ARGUMENTS — target path/module and optional flags.
 Parse flags from `$ARGUMENTS`: `-y`/`--yes`, `--patterns <list>`, `--save-spec`, `--save-wiki`, `--continue`, `-c N`.
 Extract remaining text as target path/module.
 
-Resolve target to file list. Load coding specs: `maestro spec load --category coding` for documented patterns and conventions. Load existing patterns from `coding-conventions.md` + `.workflow/specs/learnings.md` for dedup set. Browse wiki: `maestro search --category coding`, load relevant entries.
+Resolve target to file list. Load coding specs: `maestro load --type spec --category coding` for documented patterns and conventions. Load existing patterns from `coding-conventions.md` + `.workflow/specs/learnings.md` for dedup set. Browse wiki: `maestro search --category coding`, load relevant entries.
 
 ### Phase 2: Wave 1 — Parallel Dimension Scans
 

package/.codex/skills/learn-investigate/SKILL.md

@@ -25,7 +25,7 @@ $ARGUMENTS — question text and optional flags.
 
 ### Stage 1: Frame the Question
 - Parse question, generate slug, create investigation directory
-- Load debug specs: `maestro spec load --category debug` for known issues and patterns
+- Load debug specs: `maestro load --type spec --category debug` for known issues and patterns
 - Search prior knowledge: `maestro search --category debug`, wiki search, grep .workflow/specs/learnings.md
 - Write initial `understanding.md`