aiox-core 5.0.2 → 5.0.4

package/pro/squads/design/checklists/designops-maturity-checklist.md

@@ -0,0 +1,518 @@
+# designops-maturity-checklist
+
+> Comprehensive checklist for assessing DesignOps maturity using Dave Malouf's 5-level model across the Three Lenses framework.
+
+## Overview
+
+This checklist provides detailed criteria for each maturity level across all three lenses. Use it to assess current state, identify gaps, and track progress toward target maturity.
+
+## How to Use
+
+1. Go through each section and check items that are TRUE for your organization
+2. Calculate the percentage of items checked per level
+3. Your maturity level is the highest level where you have >80% items checked
+4. Use unchecked items as improvement targets
+
+---
+
+## LEVEL 1: AD HOC
+
+> "No formal DesignOps - everything is reactive and individual"
+
+### How We Work (Level 1)
+
+**Workflow Management**
+- [ ] Each designer creates their own process
+- [ ] Projects start without clear briefs or requirements
+- [ ] No standard review or feedback process
+- [ ] Handoffs happen ad hoc, often through email or chat
+- [ ] No version control or history for design files
+
+**Tooling**
+- [ ] Designers use whatever tools they prefer
+- [ ] No shared tool subscriptions or standardization
+- [ ] Asset sharing happens through email or local drives
+- [ ] No design system or component library
+
+**Collaboration**
+- [ ] Design reviews happen sporadically or not at all
+- [ ] Feedback is informal and inconsistent
+- [ ] Designers work in isolation from each other
+- [ ] No regular touchpoints with engineering or PM
+
+### How We Grow (Level 1)
+
+**Hiring**
+- [ ] Hiring happens only when urgently needed
+- [ ] Interview process varies by interviewer
+- [ ] No standard portfolio review criteria
+- [ ] Job descriptions are created last-minute
+
+**Onboarding**
+- [ ] New hires figure things out on their own
+- [ ] No documentation of how things work
+- [ ] No buddy or mentor assignment
+- [ ] First project assignment is random
+
+**Career Development**
+- [ ] No career ladder exists
+- [ ] Promotion criteria unclear or inconsistent
+- [ ] Performance reviews are informal or absent
+- [ ] No skills development framework
+
+**Learning**
+- [ ] No training budget or program
+- [ ] Learning happens on personal time
+- [ ] No conference attendance support
+- [ ] Skills gaps not tracked or addressed
+
+### How We Thrive (Level 1)
+
+**Culture**
+- [ ] No articulated design values
+- [ ] Feedback culture varies by manager
+- [ ] Recognition is rare or inconsistent
+- [ ] Design is seen as a service function
+
+**Community**
+- [ ] Designers rarely interact with each other
+- [ ] No design guild or community events
+- [ ] No knowledge sharing sessions
+- [ ] No design critiques or show-and-tells
+
+**Well-being**
+- [ ] Workload is not monitored
+- [ ] Work-life balance not discussed
+- [ ] Burnout is common
+- [ ] No mental health support
+
+**Advocacy**
+- [ ] Design leadership not visible to executives
+- [ ] No executive sponsor for design
+- [ ] Design not involved in strategic decisions
+- [ ] Design value not understood by organization
+
+**Level 1 Indicators:**
+- "Everyone does things differently"
+- "I don't know where to find X"
+- "We're always putting out fires"
+- "I feel isolated from other designers"
+
+---
+
+## LEVEL 2: EMERGING
+
+> "Basic standardization beginning - some awareness of need"
+
+### How We Work (Level 2)
+
+**Workflow Management**
+- [ ] Some basic processes are documented
+- [ ] Project briefs exist but are inconsistent
+- [ ] Review process exists but not always followed
+- [ ] Handoff templates starting to emerge
+- [ ] Some attempt at file organization
+
+**Tooling**
+- [ ] Primary design tool selected (Figma, Sketch, etc.)
+- [ ] Most designers using the same tool
+- [ ] Shared cloud storage for assets
+- [ ] Basic component library starting
+
+**Collaboration**
+- [ ] Some design reviews happening regularly
+- [ ] Feedback templates or guidelines exist
+- [ ] Occasional cross-designer collaboration
+- [ ] Some touchpoints with engineering/PM
+
+### How We Grow (Level 2)
+
+**Hiring**
+- [ ] Basic interview process documented
+- [ ] Standard job description templates
+- [ ] Some portfolio review criteria
+- [ ] Recruiting pipeline exists
+
+**Onboarding**
+- [ ] Basic onboarding checklist exists
+- [ ] Tool access documented
+- [ ] Some written documentation
+- [ ] Informal mentor assignment
+
+**Career Development**
+- [ ] Draft career ladder exists
+- [ ] Some performance review process
+- [ ] Promotion discussions happening
+- [ ] Basic job levels defined
+
+**Learning**
+- [ ] Occasional training offered
+- [ ] Some conference attendance
+- [ ] Informal skill sharing
+- [ ] Learning needs discussed
+
+### How We Thrive (Level 2)
+
+**Culture**
+- [ ] Design values discussed informally
+- [ ] Some recognition happening
+- [ ] Feedback encouraged by some managers
+- [ ] Design starting to be valued
+
+**Community**
+- [ ] Occasional team gatherings
+- [ ] Some design critiques happening
+- [ ] Informal knowledge sharing
+- [ ] Cross-team connections starting
+
+**Well-being**
+- [ ] Workload discussed in 1:1s
+- [ ] Some flexibility offered
+- [ ] Awareness of burnout risk
+- [ ] Manager check-ins happening
+
+**Advocacy**
+- [ ] Design leader has some visibility
+- [ ] Some stakeholder relationships
+- [ ] Design input sought occasionally
+- [ ] Value starting to be recognized
+
+**Level 2 Indicators:**
+- "We're trying to standardize but it's inconsistent"
+- "Some teams are better than others"
+- "Champions are driving change"
+- "We know we need to improve"
+
+---
+
+## LEVEL 3: DEFINED
+
+> "Clear processes and standards exist - adoption is growing"
+
+### How We Work (Level 3)
+
+**Workflow Management**
+- [ ] Standard workflow documented and communicated
+- [ ] Project brief template used consistently
+- [ ] Review process defined with clear criteria
+- [ ] Handoff process documented and followed
+- [ ] Version control practices established
+- [ ] Design sprints/rituals defined
+
+**Tooling**
+- [ ] Tool stack fully standardized (>90% adoption)
+- [ ] Tool governance and guidelines exist
+- [ ] Design system with documented components
+- [ ] Asset library organized and maintained
+- [ ] Prototyping tools standardized
+- [ ] Integration with dev tools established
+
+**Collaboration**
+- [ ] Regular design reviews scheduled
+- [ ] Critique process established
+- [ ] Cross-functional rituals defined
+- [ ] Communication standards exist
+- [ ] Stakeholder engagement process defined
+
+### How We Grow (Level 3)
+
+**Hiring**
+- [ ] Structured interview process with rubrics
+- [ ] Portfolio review criteria documented
+- [ ] Hiring pipeline actively managed
+- [ ] Diversity considerations integrated
+- [ ] Candidate experience designed
+
+**Onboarding**
+- [ ] 90-day onboarding program exists
+- [ ] Buddy/mentor program established
+- [ ] Tool training curriculum defined
+- [ ] First project guidance provided
+- [ ] Culture introduction included
+- [ ] Onboarding feedback collected
+
+**Career Development**
+- [ ] Career ladder published and understood
+- [ ] Skills matrix defined
+- [ ] Performance reviews structured
+- [ ] Promotion criteria documented
+- [ ] IC and management tracks clear
+- [ ] Growth conversations regular
+
+**Learning**
+- [ ] Training program established
+- [ ] Conference budget allocated
+- [ ] Skill sharing sessions regular
+- [ ] External courses supported
+- [ ] Learning goals set annually
+
+### How We Thrive (Level 3)
+
+**Culture**
+- [ ] Design values articulated and shared
+- [ ] Psychological safety actively cultivated
+- [ ] Feedback culture documented
+- [ ] Recognition program exists
+- [ ] Inclusion initiatives active
+
+**Community**
+- [ ] Design guild/community established
+- [ ] Regular critiques scheduled
+- [ ] Show and tell sessions regular
+- [ ] Cross-team connections supported
+- [ ] External community engagement
+
+**Well-being**
+- [ ] Workload management process exists
+- [ ] Work-life balance supported
+- [ ] Mental health resources available
+- [ ] Burnout prevention discussed
+- [ ] Remote/hybrid support defined
+
+**Advocacy**
+- [ ] Design leadership visible to executives
+- [ ] Executive sponsor identified
+- [ ] Design input in key decisions
+- [ ] Design value metrics shared
+- [ ] Strategic partnerships formed
+
+**Level 3 Indicators:**
+- "We have processes and most people follow them"
+- "New hires know what to expect"
+- "We measure some things"
+- "Design is recognized as important"
+
+---
+
+## LEVEL 4: MANAGED
+
+> "Metrics-driven optimization - continuous improvement"
+
+### How We Work (Level 4)
+
+**Workflow Management**
+- [ ] Workflows measured and optimized
+- [ ] Process improvements driven by data
+- [ ] Bottlenecks identified and addressed
+- [ ] Efficiency metrics tracked
+- [ ] Continuous improvement cycles
+
+**Tooling**
+- [ ] Tool usage measured and optimized
+- [ ] Design system metrics tracked
+- [ ] Component adoption measured
+- [ ] Integration effectiveness measured
+- [ ] Tool ROI calculated
+- [ ] Automation implemented where possible
+
+**Collaboration**
+- [ ] Collaboration effectiveness measured
+- [ ] Cross-functional satisfaction tracked
+- [ ] Review process optimized for quality
+- [ ] Handoff success rate high (>90%)
+- [ ] Proactive improvement culture
+
+### How We Grow (Level 4)
+
+**Hiring**
+- [ ] Hiring metrics tracked and optimized
+- [ ] Quality of hire measured
+- [ ] Candidate experience surveyed
+- [ ] Diversity metrics tracked
+- [ ] Continuous process improvement
+
+**Onboarding**
+- [ ] Time to productivity measured
+- [ ] Onboarding NPS/satisfaction tracked
+- [ ] Program continuously improved
+- [ ] High retention of new hires
+
+**Career Development**
+- [ ] Career satisfaction measured
+- [ ] Internal mobility tracked
+- [ ] Skill gaps identified systematically
+- [ ] Development ROI measured
+- [ ] High internal promotion rate
+
+**Learning**
+- [ ] Learning effectiveness measured
+- [ ] Skills improvement tracked
+- [ ] Training ROI calculated
+- [ ] Continuous learning culture
+
+### How We Thrive (Level 4)
+
+**Culture**
+- [ ] Culture health measured
+- [ ] Values actively reinforced
+- [ ] High psychological safety scores
+- [ ] Strong recognition culture
+- [ ] Inclusion metrics tracked
+
+**Community**
+- [ ] Community health measured
+- [ ] High participation rates
+- [ ] Cross-team projects common
+- [ ] External engagement active
+- [ ] Knowledge sharing systematic
+
+**Well-being**
+- [ ] Well-being metrics tracked
+- [ ] Low burnout indicators
+- [ ] High work-life satisfaction
+- [ ] Proactive support provided
+
+**Advocacy**
+- [ ] Design influence measured
+- [ ] Strategic impact documented
+- [ ] Executive relationships strong
+- [ ] Design at the table for key decisions
+- [ ] Industry recognition starting
+
+**Level 4 Indicators:**
+- "We use data to make decisions"
+- "We continuously improve based on metrics"
+- "Design is seen as strategic"
+- "Our people are highly engaged"
+
+---
+
+## LEVEL 5: OPTIMIZED
+
+> "Industry-leading operations - innovation and excellence"
+
+### How We Work (Level 5)
+
+**Workflow Management**
+- [ ] Best-in-class processes
+- [ ] AI/automation integrated
+- [ ] Predictive optimization
+- [ ] Industry benchmark performance
+- [ ] Innovation in workflows
+- [ ] Others copy our approaches
+
+**Tooling**
+- [ ] Leading-edge tool stack
+- [ ] Custom tooling where needed
+- [ ] High automation level
+- [ ] Design system is exemplary
+- [ ] Integration excellence
+- [ ] Contributing to tool ecosystem
+
+**Collaboration**
+- [ ] Seamless cross-functional work
+- [ ] Industry-leading handoff process
+- [ ] High stakeholder satisfaction
+- [ ] Proactive partnership model
+- [ ] Innovation in collaboration
+
+### How We Grow (Level 5)
+
+**Hiring**
+- [ ] Talent magnet organization
+- [ ] Top candidates seek us out
+- [ ] World-class interview experience
+- [ ] Industry-leading diversity
+- [ ] Hiring thought leadership
+
+**Onboarding**
+- [ ] Exemplary onboarding program
+- [ ] Very fast time to productivity
+- [ ] High new hire satisfaction
+- [ ] Program copied by others
+
+**Career Development**
+- [ ] Career destination company
+- [ ] World-class development
+- [ ] High internal mobility
+- [ ] Leaders developed internally
+- [ ] Career framework shared externally
+
+**Learning**
+- [ ] Learning organization culture
+- [ ] Cutting-edge training
+- [ ] Conference speakers common
+- [ ] Knowledge shared externally
+- [ ] Learning innovation
+
+### How We Thrive (Level 5)
+
+**Culture**
+- [ ] Design-led culture recognized
+- [ ] Exemplary psychological safety
+- [ ] Strong employer brand
+- [ ] Culture documented and shared
+- [ ] Industry culture benchmark
+
+**Community**
+- [ ] Thriving internal community
+- [ ] External community leadership
+- [ ] Thought leadership from team
+- [ ] Conference speakers regular
+- [ ] Open source contributions
+
+**Well-being**
+- [ ] Industry-leading well-being
+- [ ] Exceptional work satisfaction
+- [ ] Sustainable performance
+- [ ] Well-being innovation
+
+**Advocacy**
+- [ ] Design at highest strategic level
+- [ ] CDO or equivalent role
+- [ ] Design drives business strategy
+- [ ] Industry influence
+- [ ] Case studies published
+- [ ] Awards and recognition
+
+**Level 5 Indicators:**
+- "Others want to learn from us"
+- "We're speaking at conferences about this"
+- "Top talent wants to work here"
+- "Design drives our competitive advantage"
+
+---
+
+## SCORING GUIDE
+
+### Calculate Your Score
+
+For each level, count checked items and calculate percentage:
+
+| Level | Total Items | Checked | Percentage | Pass (>80%)? |
+|-------|-------------|---------|------------|--------------|
+| 1 | [count] | [checked] | [%] | [Y/N] |
+| 2 | [count] | [checked] | [%] | [Y/N] |
+| 3 | [count] | [checked] | [%] | [Y/N] |
+| 4 | [count] | [checked] | [%] | [Y/N] |
+| 5 | [count] | [checked] | [%] | [Y/N] |
+
+**Your Maturity Level:** Highest level with >80% items checked
+
+### Score by Lens
+
+| Lens | L1 | L2 | L3 | L4 | L5 |
+|------|----|----|----|----|-------|
+| How We Work | [%] | [%] | [%] | [%] | [%] |
+| How We Grow | [%] | [%] | [%] | [%] | [%] |
+| How We Thrive | [%] | [%] | [%] | [%] | [%] |
+
+### Gap Analysis
+
+Unchecked items at your current target level = improvement backlog
+
+**Priority 1 (Quick Wins):** Unchecked items that are low effort
+**Priority 2 (Strategic):** Unchecked items that are high impact
+**Priority 3 (Foundation):** Prerequisites for higher-level items
+
+---
+
+## USAGE NOTES
+
+1. **Be honest** - Aspirational checking doesn't help
+2. **Evidence-based** - Check only if you have evidence
+3. **Re-assess quarterly** - Track progress over time
+4. **Focus on next level** - Don't try to jump levels
+5. **All lenses matter** - Balance improvement across lenses
+
+> "You can't skip maturity levels - organizations evolve in stages." - Dave Malouf

package/pro/squads/design/checklists/ds-a11y-release-gate-checklist.md

@@ -0,0 +1,45 @@
+# Design System A11y Release Gate Checklist
+
+**Purpose:** Block releases when accessibility standards governance is stale or incomplete.  
+**Scope:** Design System components, tokens, patterns, and accessibility contracts.
+
+## 1) Canonical Artifacts
+
+- [ ] `docs/design-system/accessibility/manifest.json` exists
+- [ ] `docs/design-system/accessibility/sources/wcag-22-criteria.pt-BR.md` exists
+- [ ] `docs/design-system/accessibility/checklists/wcag-22-master-checklist.md` exists
+- [ ] `scripts/accessibility/generate_wcag_checklist.cjs` exists
+- [ ] `scripts/accessibility/validate_a11y_checklists.cjs` exists
+
+## 2) Checklist Integrity
+
+- [ ] Total criteria = `87`
+- [ ] Active criteria = `86`
+- [ ] Removed/obsolete criteria = `1`
+- [ ] `4.1.1` marked as removed/obsolete
+- [ ] WCAG 2.2 additions are present (`2.4.11`, `2.4.12`, `2.4.13`, `2.5.7`, `2.5.8`, `3.2.6`, `3.3.7`, `3.3.8`, `3.3.9`)
+- [ ] No duplicate criterion IDs
+
+## 3) Freshness Governance
+
+- [ ] `last_verified_at` is within `max_age_days`
+- [ ] Sources list in `manifest.json` is present and valid
+- [ ] Review cadence is documented (`monthly` or stricter)
+
+## 4) Command Gates
+
+- [ ] `npm run checklists:a11y:generate` passes
+- [ ] `npm run validate:a11y-checklists` passes
+- [ ] `node squads/design/scripts/validate-a11y-integration.cjs` passes
+
+## 5) CI/CD Enforcement
+
+- [ ] `.github/workflows/design-ci.yml` includes accessibility checklist validation
+- [ ] Validation runs on changes in `squads/design/**`
+- [ ] Validation runs on changes in `docs/design-system/accessibility/**`
+- [ ] Validation runs on changes in `scripts/accessibility/**`
+
+## Gate Result
+
+- [ ] **APPROVED** - release allowed
+- [ ] **BLOCKED** - missing checks above

package/pro/squads/design/checklists/ds-accessibility-wcag-checklist.md

@@ -0,0 +1,147 @@
+# Accessibility WCAG AA Checklist
+
+**Purpose:** Ensure WCAG AA compliance for design system components
+**Agent:** Merovingian (Design System Builder)
+**Standard:** WCAG 2.1 Level AA (minimum)
+
+---
+
+## PERCEIVABLE
+
+### Color & Contrast
+- [ ] Text contrast ≥4.5:1 (normal text)
+  → Fix: Use OKLCH color space to find nearest compliant shade. Tool: `*contrast-matrix --fix`
+- [ ] Text contrast ≥3:1 (large text 18px+)
+  → Fix: Large text has a lower threshold. If failing, darken/lighten by 10-15% in OKLCH lightness channel
+- [ ] UI controls contrast ≥3:1
+  → Fix: Borders, icons, and form controls need ≥3:1 against background. Check with `*contrast-matrix --ui-controls`
+- [ ] No color-only indicators (use icons + text)
+  → Fix: Add icon, text label, or pattern alongside color. Example: error state needs red + icon + "Error" text
+
+### Alternative Text
+- [ ] Images have alt text
+  → Fix: Add descriptive alt for informational images, `alt=""` for decorative. Never use `alt="image"` or `alt="photo"`
+- [ ] Decorative images use alt=""
+  → Fix: If image adds no information (dividers, backgrounds), use `alt=""` or CSS `background-image` instead of `<img>`
+- [ ] Icon buttons have aria-label
+  → Fix: Add `aria-label="Close"` (not `aria-label="X"`) to icon-only buttons. Label describes the action, not the icon
+
+---
+
+## OPERABLE
+
+### Keyboard
+- [ ] All interactive elements keyboard accessible
+  → Fix: Use native `<button>`, `<a>`, `<input>` elements. For custom elements, add `tabindex="0"` + `onKeyDown` handler
+- [ ] Tab order logical
+  → Fix: Follow DOM order, never use `tabindex > 0`. Rearrange HTML to match visual layout if needed
+- [ ] Focus indicators visible (outline, ring, etc)
+  → Fix: Add `:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 2px; }`. Never `outline: none` without replacement
+- [ ] No keyboard traps
+  → Fix: Ensure `Escape` closes modals/dropdowns, `Tab` moves to next element, never `tabindex > 0`. Test by tabbing through entire page
+
+### Navigation
+- [ ] Skip links provided (if needed)
+  → Fix: Add `<a href="#main-content" class="skip-link">Skip to main content</a>` as first child of `<body>`
+- [ ] Landmarks used (nav, main, aside)
+  → Fix: Wrap in `<main>`, `<nav>`, `<header>`, `<footer>`. One `<main>` per page. Add `aria-label` to distinguish multiple `<nav>`
+- [ ] Headings hierarchical (h1 → h2 → h3)
+  → Fix: Never skip heading levels (h1 to h3). One `<h1>` per page. Use CSS to style heading appearance independently of level
+
+---
+
+## UNDERSTANDABLE
+
+### Labels
+- [ ] Form inputs have labels
+  → Fix: Add `<label htmlFor="inputId">` for every input. For hidden labels, use `aria-label` or `<VisuallyHidden>` wrapper
+- [ ] Labels associated with inputs (htmlFor/id)
+  → Fix: Match `<label htmlFor="email">` with `<input id="email">`. Both must be unique on the page
+- [ ] Required fields indicated
+  → Fix: Add `aria-required="true"` + visual asterisk. Don't rely on asterisk alone — add "(required)" in label or helper text
+- [ ] Error messages clear and helpful
+  → Fix: Use `aria-describedby` to link error to input. Message should say what's wrong AND how to fix: "Email must include @"
+
+### States
+- [ ] Disabled state indicated visually + aria-disabled
+  → Fix: Use `aria-disabled="true"` (not `disabled` attribute) + `opacity: 0.5` + `pointer-events: none`. This keeps element in tab order
+- [ ] Loading states announced
+  → Fix: Add `aria-busy="true"` to loading container + `aria-live="polite"` region that announces "Loading..." then "Content loaded"
+- [ ] Success/error states clear
+  → Fix: Use `role="alert"` for errors (immediate announcement), `role="status"` for success. Include icon + text, not color alone
+
+---
+
+## ROBUST
+
+### ARIA
+- [ ] Valid ARIA attributes only
+  → Fix: Run `axe-core` or `*aria-audit` to detect invalid attributes. Reference: WAI-ARIA 1.2 spec for valid attribute/role combos
+- [ ] ARIA roles used correctly
+  → Fix: Check that role matches behavior (e.g., `role="button"` needs `tabindex="0"` + Enter/Space handlers). Prefer native elements
+- [ ] aria-label / aria-labelledby present
+  → Fix: Use `aria-label` for simple labels, `aria-labelledby` to reference visible text. Never use both on same element
+- [ ] aria-expanded for collapsible content
+  → Fix: Add `aria-expanded="false"` on trigger button. Toggle to `"true"` on open. Add `aria-controls="panel-id"` pointing to content
+- [ ] aria-live for dynamic content
+  → Fix: Add `aria-live="polite"` to container that receives dynamic updates. Use `"assertive"` only for critical alerts
+
+### HTML
+- [ ] Valid semantic HTML
+  → Fix: Run HTML validator. Replace `<div>` with semantic elements: `<article>`, `<section>`, `<aside>`, `<figure>`
+- [ ] No deprecated elements
+  → Fix: Replace `<center>` with CSS, `<font>` with CSS, `<marquee>` with CSS animation (with `prefers-reduced-motion`)
+- [ ] Proper nesting
+  → Fix: No `<div>` inside `<p>`, no `<button>` inside `<a>`. Check with `axe-core` or HTML validator
+
+---
+
+## Edge Cases
+
+- [ ] **Touch targets:** Interactive elements >= 44x44px on mobile (WCAG 2.5.8)
+  → Fix: Add `min-width: 44px; min-height: 44px` to all interactive elements
+- [ ] **Motion sensitivity:** Animations respect `prefers-reduced-motion` media query
+- [ ] **High contrast mode:** Component visible in Windows High Contrast Mode (`forced-colors: active`)
+  → Fix: Test with `forced-colors: active` media query, ensure borders visible
+- [ ] **Zoom 200%:** Layout doesn't break at 200% browser zoom (WCAG 1.4.4)
+  → Fix: Use relative units (rem/em), test at 200% zoom — no horizontal scroll
+- [ ] **Voice control:** Interactive elements have visible labels matching accessible names (WCAG 2.5.3)
+- [ ] **Live regions:** Screen reader announces dynamic content updates
+  → Fix: Add `aria-live="polite"` to containers that update dynamically
+
+---
+
+**Testing Tools:**
+- axe DevTools (browser extension)
+- WAVE (web accessibility evaluation tool)
+- Keyboard-only navigation
+- Screen reader (NVDA, JAWS, VoiceOver)
+
+**Result:** [ ] WCAG AA ✓ [ ] Issues Found
+
+---
+
+## Scoring
+
+### Point System
+Each checkbox item = 1 point.
+
+| Category | Items | Weight |
+|----------|-------|--------|
+| Perceivable (Color & Contrast + Alternative Text) | 7 | 7pts |
+| Operable (Keyboard + Navigation) | 7 | 7pts |
+| Understandable (Labels + States) | 7 | 7pts |
+| Robust (ARIA + HTML) | 8 | 8pts |
+| Edge Cases | 6 | 6pts |
+| **Total** | **35** | **35pts** |
+
+### Pass/Fail Thresholds
+| Grade | Score | Action |
+|-------|-------|--------|
+| PASS | >= 80% (28+) | Proceed to next phase |
+| CONDITIONAL | 60-79% (21-27) | Fix critical items, re-check |
+| FAIL | < 60% (21-) | Major rework required |
+
+### Auto-Correction
+If items fail:
+- Run `*a11y-audit` for automated checks. Run `*aria-audit` for ARIA validation. Run `*focus-order-audit` for keyboard navigation.