code-ai-installer 1.2.0 → 1.3.0

package/.agents/wix_self_hosted_embedded_script/agents/claude.json

@@ -1,13 +1,13 @@
 {
   "name": "wix_self_hosted_embedded_script",
   "display_name": "Самохостируемый встроенный скрипт для Wix",
-  "description": "Практический runbook для Wix Self-Hosted Embedded Script: HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
+  "description": "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
   "default_prompt": "Используй $wix_self_hosted_embedded_script, когда задача относится к навыку \"Самохостируемый встроенный скрипт для Wix\".",
   "triggers": [
     "wix_self_hosted_embedded_script",
     "wix self hosted embedded script",
     "Самохостируемый встроенный скрипт для Wix",
-    "Практический runbook для Wix Self-Hosted Embedded Script"
+    "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready"
   ],
   "capabilities": [
     "wix",

package/.agents/wix_self_hosted_embedded_script/agents/copilot.json

@@ -1,13 +1,13 @@
 {
   "name": "wix_self_hosted_embedded_script",
   "display_name": "Самохостируемый встроенный скрипт для Wix",
-  "description": "Практический runbook для Wix Self-Hosted Embedded Script: HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
+  "description": "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
   "default_prompt": "Используй $wix_self_hosted_embedded_script, когда задача относится к навыку \"Самохостируемый встроенный скрипт для Wix\".",
   "triggers": [
     "wix_self_hosted_embedded_script",
     "wix self hosted embedded script",
     "Самохостируемый встроенный скрипт для Wix",
-    "Практический runbook для Wix Self-Hosted Embedded Script"
+    "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready"
   ],
   "capabilities": [
     "wix",

package/.agents/wix_self_hosted_embedded_script/agents/gemini.json

@@ -1,13 +1,13 @@
 {
   "name": "wix_self_hosted_embedded_script",
   "display_name": "Самохостируемый встроенный скрипт для Wix",
-  "description": "Практический runbook для Wix Self-Hosted Embedded Script: HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
+  "description": "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
   "default_prompt": "Используй $wix_self_hosted_embedded_script, когда задача относится к навыку \"Самохостируемый встроенный скрипт для Wix\".",
   "triggers": [
     "wix_self_hosted_embedded_script",
     "wix self hosted embedded script",
     "Самохостируемый встроенный скрипт для Wix",
-    "Практический runbook для Wix Self-Hosted Embedded Script"
+    "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready"
   ],
   "capabilities": [
     "wix",

package/.agents/wix_self_hosted_embedded_script/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Самохостируемый встроенный скрипт для Wix"
-  short_description: "Практический runbook для Wix Self-Hosted Embedded Script: HTTPS локально, install webhook, embe…"
+  short_description: "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, emb…"
   default_prompt: "Используй $wix_self_hosted_embedded_script, когда задача относится к навыку \"Самохостируемый встроенный скрипт для Wix\"."
 dependencies:
   tools: []

package/.agents/wix_self_hosted_embedded_script/agents/qwen.json

@@ -1,13 +1,13 @@
 {
   "name": "wix_self_hosted_embedded_script",
   "display_name": "Самохостируемый встроенный скрипт для Wix",
-  "description": "Практический runbook для Wix Self-Hosted Embedded Script: HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
+  "description": "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready.",
   "default_prompt": "Используй $wix_self_hosted_embedded_script, когда задача относится к навыку \"Самохостируемый встроенный скрипт для Wix\".",
   "triggers": [
     "wix_self_hosted_embedded_script",
     "wix self hosted embedded script",
     "Самохостируемый встроенный скрипт для Wix",
-    "Практический runbook для Wix Self-Hosted Embedded Script"
+    "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready"
   ],
   "capabilities": [
     "wix",

package/.agents/wix_self_hosted_embedded_script/agents/skill.yaml

@@ -1,13 +1,13 @@
 version: 1
 name: "wix_self_hosted_embedded_script"
 display_name: "Самохостируемый встроенный скрипт для Wix"
-description: "Практический runbook для Wix Self-Hosted Embedded Script: HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready."
+description: "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready."
 default_prompt: "Используй $wix_self_hosted_embedded_script, когда задача относится к навыку \"Самохостируемый встроенный скрипт для Wix\"."
 triggers:
   - "wix_self_hosted_embedded_script"
   - "wix self hosted embedded script"
   - "Самохостируемый встроенный скрипт для Wix"
-  - "Практический runbook для Wix Self-Hosted Embedded Script"
+  - "Практический runbook для Wix Self-Hosted Embedded Script — HTTPS локально, install webhook, embed script, resolve appInstanceId, DB-driven widget config, частые ошибки и проверка DEMO-ready"
 capabilities:
   - "wix"
   - "self"

package/AGENTS.yaml

@@ -59,6 +59,7 @@ skills:
   - "qa_browser_testing"
   - "qa_e2e_playwright"
   - "qa_manual_run"
+  - "qa_regression_baseline"
   - "qa_security_smoke_tests"
   - "qa_test_plan"
   - "qa_ui_a11y_smoke"
@@ -74,6 +75,7 @@ skills:
   - "state_zustand_beast_practices"
   - "styling_css_stack"
   - "system_design_checklist"
+  - "tailwind_beast_practices"
   - "tanstack_beast_practices"
   - "tdd_workflow"
   - "testing_strategy_js"

package/agents/conductor.md

@@ -224,6 +224,56 @@
 
 ---
 
+## Conflict Resolution Protocol (между агентами)
+
+Если два агента не согласны (например, DEV vs ARCH по ADR, REV vs DEV по P0, UX vs PM по scope):
+
+1. **Зафиксировать конфликт** — кто, о чём, позиции сторон (1–2 предложения каждая)
+2. **Эскалация к Conductor** — дирижёр собирает аргументы обеих сторон
+3. **Решение:**
+   - Если конфликт по архитектуре → Architect имеет final say (через ADR)
+   - Если конфликт по продукту/scope → PM имеет final say (через PRD update)
+   - Если конфликт по UX/стилю → UX Designer имеет final say (через Design Decision Log)
+   - Если конфликт по безопасности → Reviewer имеет final say (override P0)
+   - Если конфликт между финальными инстанциями → пользователь решает
+4. **Зафиксировать решение** — в Master Checklist + ADR (если архитектурное)
+5. **Уведомить обе стороны** — final decision + обоснование
+
+🔴 P0 если: конфликт не зафиксирован и стороны реализуют разные решения параллельно.
+
+---
+
+## Retrospective Template (после каждого Release Gate)
+
+После каждого RG (GO или NO-GO) дирижёр проводит ретроспективу:
+
+### Формат ретроспективы
+```
+## Retrospective — [RG-xx] [дата]
+
+### Что прошло хорошо (Keep)
+- ...
+
+### Что можно улучшить (Improve)
+- ...
+
+### Что делать по-другому (Change)
+- ...
+
+### Action Items
+| # | Действие | Владелец | Срок | Приоритет |
+|---|----------|----------|------|-----------|
+| 1 | ...      | ...      | ...  | P1/P2     |
+```
+
+### Правила:
+- Action Items с приоритетом P1+ → добавляются в `docs/tasks-backlog.md`
+- Ретроспектива обязательна при **NO-GO** (с root cause analysis)
+- Ретроспектива рекомендована при **GO** (для фиксации best practices)
+- Длительность: ≤15 минут
+
+---
+
 ## Используемые skills (вызовы)
 - $board
 - $handoff

package/agents/devops.md

@@ -134,6 +134,37 @@ lint → typecheck → unit tests → integration tests → build → deploy (st
 
 ---
 
+## Incident Response & Disaster Recovery
+
+### Incident Response Protocol
+При инциденте в prod:
+1. **Detect** — alert (PagerDuty / Slack / manual) → определить severity (SEV1–SEV3)
+2. **Triage** — назначить on-call, собрать контекст (логи/метрики/traces)
+3. **Mitigate** — rollback / hotfix / feature flag disable
+4. **Communicate** — уведомить stakeholders (Conductor, PM)
+5. **Resolve** — корневая причина устранена, подтверждена smoke-тестами
+6. **Postmortem** — зафиксировать timeline, root cause, action items (≤48ч после инцидента)
+
+| Severity | Время реакции | Эскалация | Пример |
+|----------|--------------|-----------|--------|
+| SEV1 | ≤15 мин | Conductor + PM + Architect | Данные потеряны / сервис полностью down |
+| SEV2 | ≤1 час | Conductor | Ключевой flow сломан, workaround есть |
+| SEV3 | ≤4 часа | — | Деградация производительности, некритичный UI баг |
+
+### Disaster Recovery (DR)
+- **Backup strategy:** автоматический бэкап БД ≥ 1 раз/сутки, retention ≥ 7 дней
+- **Recovery Point Objective (RPO):** максимально допустимая потеря данных (по умолчанию ≤ 24ч для MVP)
+- **Recovery Time Objective (RTO):** максимальное время восстановления (по умолчанию ≤ 1ч для MVP)
+- **DR test:** проверять восстановление из бэкапа ≥ 1 раз/квартал
+- **Multi-region:** определить необходимость (по compliance/SLA)
+
+🔴 P0 если:
+- нет бэкапов БД в prod
+- нет задокументированного плана восстановления
+- RPO/RTO не определены для критичных данных
+
+---
+
 ## Anti-Patterns (что запрещено)
 - Секреты в коде, .env файлах в репо, git history
 - HTTP в prod (только HTTPS)
@@ -254,7 +285,6 @@ INFRASTRUCTURE STATUS: Approved ✅ / Pending ⏳
 
 ## HANDOFF (Mandatory)
 - Every DevOps output must end with a completed `Handoff Envelope`.
-- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR DEV`, `HTTPS STATUS`, `SECRETS STATUS`, `INFRASTRUCTURE STATUS`.
 - Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR DEV`, `HTTPS STATUS`, `SECRETS STATUS`, `CONTAINER RELOAD STATUS`, `INFRASTRUCTURE STATUS`.
 - If `OPEN ITEMS` is not empty, include owner and due date per item.
 - Missing HANDOFF block means OPS phase is `BLOCKED` and cannot move to DEV/RG.

package/agents/orchestrator.claude.json

@@ -53,6 +53,7 @@
     "qa_browser_testing",
     "qa_e2e_playwright",
     "qa_manual_run",
+    "qa_regression_baseline",
     "qa_security_smoke_tests",
     "qa_test_plan",
     "qa_ui_a11y_smoke",
@@ -68,6 +69,7 @@
     "state_zustand_beast_practices",
     "styling_css_stack",
     "system_design_checklist",
+    "tailwind_beast_practices",
     "tanstack_beast_practices",
     "tdd_workflow",
     "testing_strategy_js",

package/agents/orchestrator.copilot.json

@@ -53,6 +53,7 @@
     "qa_browser_testing",
     "qa_e2e_playwright",
     "qa_manual_run",
+    "qa_regression_baseline",
     "qa_security_smoke_tests",
     "qa_test_plan",
     "qa_ui_a11y_smoke",
@@ -68,6 +69,7 @@
     "state_zustand_beast_practices",
     "styling_css_stack",
     "system_design_checklist",
+    "tailwind_beast_practices",
     "tanstack_beast_practices",
     "tdd_workflow",
     "testing_strategy_js",

package/agents/orchestrator.gemini.json

@@ -53,6 +53,7 @@
     "qa_browser_testing",
     "qa_e2e_playwright",
     "qa_manual_run",
+    "qa_regression_baseline",
     "qa_security_smoke_tests",
     "qa_test_plan",
     "qa_ui_a11y_smoke",
@@ -68,6 +69,7 @@
     "state_zustand_beast_practices",
     "styling_css_stack",
     "system_design_checklist",
+    "tailwind_beast_practices",
     "tanstack_beast_practices",
     "tdd_workflow",
     "testing_strategy_js",

package/agents/orchestrator.openai.yaml

@@ -52,6 +52,7 @@ catalog:
     - "qa_browser_testing"
     - "qa_e2e_playwright"
     - "qa_manual_run"
+    - "qa_regression_baseline"
     - "qa_security_smoke_tests"
     - "qa_test_plan"
     - "qa_ui_a11y_smoke"
@@ -67,6 +68,7 @@ catalog:
     - "state_zustand_beast_practices"
     - "styling_css_stack"
     - "system_design_checklist"
+    - "tailwind_beast_practices"
     - "tanstack_beast_practices"
     - "tdd_workflow"
     - "testing_strategy_js"

package/agents/orchestrator.qwen.json

@@ -53,6 +53,7 @@
     "qa_browser_testing",
     "qa_e2e_playwright",
     "qa_manual_run",
+    "qa_regression_baseline",
     "qa_security_smoke_tests",
     "qa_test_plan",
     "qa_ui_a11y_smoke",
@@ -68,6 +69,7 @@
     "state_zustand_beast_practices",
     "styling_css_stack",
     "system_design_checklist",
+    "tailwind_beast_practices",
     "tanstack_beast_practices",
     "tdd_workflow",
     "testing_strategy_js",

package/agents/reviewer.md

@@ -248,7 +248,6 @@ CONTAINER RELOAD VERIFIED: ✅ / ❌
 
 ## HANDOFF (Mandatory)
 - Every REV output must end with a completed `Handoff Envelope`.
-- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR NEXT PHASE`, `MERGE STATUS`.
 - Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR NEXT PHASE`, `MERGE STATUS`, `CONTAINER RELOAD VERIFIED`.
 - If `OPEN ITEMS` is not empty, include owner and due date per item.
 - Missing HANDOFF block means REV phase is `BLOCKED` and cannot move to QA/RG.

package/agents/senior_full_stack.md

@@ -184,6 +184,7 @@
 - $wix_self_hosted_embedded_script
 - (условно) $wix_iframe_sdk
 - (условно) $react_15_3_wix_iframe
+- $tailwind_beast_practices
 
 ---
 

package/agents/tester.md

@@ -217,6 +217,7 @@ Tester не обязан писать всю автоматизацию сам,
 - $qa_api_contract_tests
 - $qa_security_smoke_tests
 - $qa_ui_a11y_smoke
+- $qa_regression_baseline
 
 ---
 
@@ -314,7 +315,6 @@ CONTAINER RELOAD VERIFIED: ✅ / ❌
 
 ## HANDOFF (Mandatory)
 - Every QA output must end with a completed `Handoff Envelope`.
-- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR RELEASE`, `RELEASE RECOMMENDATION`.
 - Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR RELEASE`, `RELEASE RECOMMENDATION`, `CONTAINER RELOAD VERIFIED`.
 - If `OPEN ITEMS` is not empty, include owner and due date per item.
 - Missing HANDOFF block means QA phase is `BLOCKED` and cannot move to RG.

package/agents/ux_ui_designer.md

@@ -1,4 +1,4 @@
-<!-- codex: reasoning=medium; note="UX flows/spec; raise to high for complex parity review" -->
+<!-- codex: reasoning=medium; note="UX flows/spec; raise to high for complex parity review" -->
 # Agent: UX/UI Designer
 
 ## Назначение
@@ -161,7 +161,7 @@
 - $design_parity_review
 - $design_systems
 - $ui_a11y_smoke_review
-- $google_stitch_skill — AI UI generation через StitchMCP (rapid ideation после Approved UX Proposal)
+- $google_stitch — AI UI generation через StitchMCP (rapid ideation после Approved UX Proposal)
 
 ---
 

package/locales/en/.agents/a11y_baseline/SKILL.md

@@ -1,41 +1,260 @@
----
-name: a11y_baseline
-description: Minimum baseline accessibility for web UI: keyboard navigation, focus management, form labels, ARIA for interactive components, error messages.
----
-
-#Skill: A11y Baseline (minimum)
-
-## Goal
-Set minimum accessibility requirements that can be tested and implemented in the MVP.
-
-## Exit
-List of a11y requirements for the project + notes on key components.
-
-## Minimum Requirements (MVP)
-1) **Keyboard navigation**
-- All interactive elements are accessible from the keyboard
-- Tab order is logical
-- No trick traps
-
-2) **Focus states**
-- Visible focus for all interactive elements
-- In modals: focus moves inside and returns back when closed
-
-3) **Forms**
-- Each field has a label (visible or aria-label)
-- Errors are assigned to a field (the error description is read by assistive technologies)
-- Required fields are marked and clear
-
-4) **ARIA (where needed)**
-- Dialog: role="dialog" + aria-modal
-- Tabs, dropdowns, comboboxes - correct roles/attributes (if we use custom ones)
-
-5) **Error messaging**
-- Errors are clear, without “unknown error”
-- There are actions: retry/close/fix
-
-## Receipt for tester
-- You can go through key flows without a mouse
-- In modal, focus does not leak
-- Forms announce label/errors
-- Custom components have ARIA and work with assistive technologies
+---
+name: a11y_baseline
+description: Minimum baseline accessibility for web UI — keyboard navigation, focus management, form labels, ARIA for interactive components, error messages.
+---
+
+# Skill: A11y Baseline
+
+Minimal requirements accessibility for MVP. For testing → `$qa_ui_a11y_smoke`.
+
+**Sections:**
+1. [Requirements by WCAG](#1-requirements)
+2. [Component A11y Table](#2-components)
+3. [Code Examples](#3-examples)
+4. [Verification](#4-verification)
+5. [Output Template](#5-output)
+
+---
+
+## 1. Requirements by WCAG 2.1 AA
+
+### 1.1 Keyboard (WCAG 2.1.1, 2.1.2)
+
+| # | Requirement | WCAG | Severity |
+|---|------------|------|----------|
+| A-01 | All interactive elements reachable via Tab | 2.1.1 (A) | 🔴 P0 |
+| A-02 | No keyboard traps (always can Tab out) | 2.1.2 (A) | 🔴 P0 |
+| A-03 | Focus order is logical (DOM order matches visual) | 2.4.3 (A) | 🟠 P1 |
+| A-04 | Shortcuts don't conflict with assistive tech | 2.1.4 (A) | 🟡 P2 |
+
+### 1.2 Focus (WCAG 2.4.7)
+
+| # | Requirement | WCAG | Severity |
+|---|------------|------|----------|
+| A-05 | Visible focus indicator on all interactive elements | 2.4.7 (AA) | 🔴 P0 |
+| A-06 | Focus indicator ≥ 2px in contrast | 1.4.11 (AA) | 🟠 P1 |
+| A-07 | Modal: focus moves inside on open | — (UX) | 🟠 P1 |
+| A-08 | Modal: focus returns to trigger on close | — (UX) | 🟠 P1 |
+| A-09 | No `outline: none` without `:focus-visible` replacement | — | 🔴 P0 |
+
+### 1.3 Forms (WCAG 1.3.1, 3.3.x)
+
+| # | Requirement | WCAG | Severity |
+|---|------------|------|----------|
+| A-10 | Every input has `<label>` or `aria-label` | 1.3.1 (A) | 🔴 P0 |
+| A-11 | Required fields have `aria-required="true"` or visual marker | 1.3.1 (A) | 🟠 P1 |
+| A-12 | Error messages associated via `aria-describedby` | 3.3.1 (A) | 🟠 P1 |
+| A-13 | Error messages are descriptive (not just "Invalid") | 3.3.3 (AA) | 🟠 P1 |
+| A-14 | Form submission feedback announced (toast + aria-live) | 4.1.3 (AA) | 🟠 P1 |
+
+### 1.4 Content (WCAG 1.1.1, 1.3.1)
+
+| # | Requirement | WCAG | Severity |
+|---|------------|------|----------|
+| A-15 | Images have `alt` text (or `alt=""` for decorative) | 1.1.1 (A) | 🟠 P1 |
+| A-16 | One `<h1>` per page with logical heading hierarchy | 1.3.1 (A) | 🟠 P1 |
+| A-17 | Semantic HTML used (`<button>`, `<nav>`, `<main>`) | 1.3.1 (A) | 🟠 P1 |
+| A-18 | Language attribute set (`<html lang="en">`) | 3.1.1 (A) | 🟡 P2 |
+
+### 1.5 Contrast & Visual (WCAG 1.4.x)
+
+| # | Requirement | WCAG | Severity |
+|---|------------|------|----------|
+| A-19 | Text contrast ≥ 4.5:1 (normal) / 3:1 (large text ≥ 18px) | 1.4.3 (AA) | 🟠 P1 |
+| A-20 | Non-text UI contrast ≥ 3:1 (borders, icons) | 1.4.11 (AA) | 🟡 P2 |
+| A-21 | Color is not the only means to convey meaning | 1.4.1 (A) | 🟠 P1 |
+| A-22 | `prefers-reduced-motion` respected (or opt-in animations) | 2.3.3 (AAA) | 🟡 P2 |
+
+---
+
+## 2. Component A11y Table
+
+### Required ARIA per component type
+
+| Component | Element | Required ARIA | Keyboard |
+|-----------|---------|--------------|----------|
+| **Button** | `<button>` | — (native) | Enter/Space → activate |
+| **Link** | `<a href>` | — (native) | Enter → navigate |
+| **Input** | `<input>` | `aria-invalid`, `aria-describedby` | — |
+| **Select** | `<select>` or `[role="listbox"]` | `aria-expanded`, `aria-selected` | Arrow keys |
+| **Checkbox** | `<input type="checkbox">` | — (native) | Space → toggle |
+| **Switch** | `[role="switch"]` | `aria-checked` | Space → toggle |
+| **Tabs** | `[role="tablist"]` + `[role="tab"]` | `aria-selected`, `aria-controls` | Arrow keys → navigate |
+| **Modal** | `[role="dialog"]` | `aria-modal="true"`, `aria-labelledby` | Escape → close, focus trap |
+| **Toast** | `[role="status"]` or `[aria-live="polite"]` | — | Auto-announced |
+| **Tooltip** | `[role="tooltip"]` | `aria-describedby` on trigger | Escape → dismiss |
+| **Spinner** | — | `aria-busy="true"` on container | — |
+| **Skeleton** | — | `aria-hidden="true"` | — |
+| **Table** | `<table>` | `<th scope="col/row">` | — |
+| **Dropdown** | `[role="menu"]` | `aria-expanded`, `aria-haspopup` | Arrow keys, Enter, Escape |
+
+---
+
+## 3. Code Examples
+
+### Focus management: Modal
+
+```jsx
+// ✅ Correct modal focus management
+function Modal({ isOpen, onClose, children }) {
+  const closeRef = useRef(null);
+  const triggerRef = useRef(null);
+
+  useEffect(() => {
+    if (isOpen) {
+      closeRef.current?.focus(); // Focus moves inside modal
+    } else {
+      triggerRef.current?.focus(); // Focus returns to trigger
+    }
+  }, [isOpen]);
+
+  return (
+    <div
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby="modal-title"
+    >
+      <h2 id="modal-title">Confirm Delete</h2>
+      {children}
+      <button ref={closeRef} onClick={onClose}>Cancel</button>
+    </div>
+  );
+}
+```
+
+### Form field with error
+
+```jsx
+// ✅ Correct form field a11y
+function FormField({ id, label, error, required, children }) {
+  const errorId = `${id}-error`;
+
+  return (
+    <div>
+      <label htmlFor={id}>
+        {label}
+        {required && <span aria-hidden="true"> *</span>}
+      </label>
+      {React.cloneElement(children, {
+        id,
+        'aria-required': required,
+        'aria-invalid': !!error,
+        'aria-describedby': error ? errorId : undefined,
+      })}
+      {error && (
+        <p id={errorId} role="alert" className="error-text">
+          {error}
+        </p>
+      )}
+    </div>
+  );
+}
+```
+
+### Focus visible CSS
+
+```css
+/* ✅ Correct focus management */
+/* Remove default but keep for keyboard users */
+*:focus {
+  outline: none;
+}
+
+*:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+
+/* ❌ DON'T: Remove focus for everyone */
+*:focus {
+  outline: none; /* breaks keyboard navigation! */
+}
+```
+
+### Toast with aria-live
+
+```jsx
+// ✅ Toast that screen readers announce
+function ToastContainer({ toasts }) {
+  return (
+    <div aria-live="polite" aria-atomic="true">
+      {toasts.map(toast => (
+        <div key={toast.id} role="status">
+          {toast.message}
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+---
+
+## 4. Verification
+
+### Automated tools
+
+| Tool | What it checks | How to run |
+|------|---------------|-----------|
+| **axe DevTools** | WCAG violations, missing ARIA | Browser extension → Scan |
+| **Lighthouse a11y** | Overall a11y score (target ≥ 90) | DevTools → Lighthouse |
+| **eslint-plugin-jsx-a11y** | JSX a11y rules in code | `npm install eslint-plugin-jsx-a11y` |
+
+### Manual checks
+
+| Check | How |
+|-------|-----|
+| Keyboard navigation | Tab through entire page without mouse |
+| Focus visible | Every focused element has visible outline |
+| Screen reader | Test with NVDA/VoiceOver |
+| Color contrast | axe DevTools or Lighthouse |
+
+### Acceptance criteria for Tester
+
+```markdown
+- [ ] All P0 interactive flows completable via keyboard
+- [ ] All form fields have labels (visible or aria-label)
+- [ ] Modals trap focus and return on close
+- [ ] Error messages linked to fields (aria-describedby)
+- [ ] No `outline: none` without focus-visible replacement
+- [ ] Lighthouse a11y score ≥ 90
+```
+
+---
+
+## 5. Output Template
+
+```markdown
+# A11y Baseline: <Project/Feature>
+
+**Date:** YYYY-MM-DD
+**Author:** UX/UI Designer Agent
+**WCAG Target:** 2.1 AA
+
+## Requirements Summary
+| Category | Total | P0 | P1 | P2 |
+|----------|:-----:|:---:|:---:|:---:|
+| Keyboard | 4 | 2 | 1 | 1 |
+| Focus | 5 | 2 | 3 | 0 |
+| Forms | 5 | 1 | 4 | 0 |
+| Content | 4 | 0 | 3 | 1 |
+| Visual | 4 | 0 | 2 | 2 |
+| **Total** | **22** | **5** | **13** | **4** |
+
+## Component A11y Requirements
+<section 2 table>
+
+## Acceptance Criteria for Tester
+<section 4 checklist>
+
+## Notes / Exceptions
+- <any project-specific exceptions>
+```
+
+---
+
+## See also
+- `$qa_ui_a11y_smoke` — a11y smoke testing
+- `$ui_inventory` — component inventory (includes a11y notes)
+- `$styling_css_stack` — CSS a11y patterns (focus-visible, prefers-reduced-motion)
+- `$ux_spec` — UX Spec (screens with states)