reference/collaboration-patterns.md | you need any Palette handoff token or partner workflow. |
reference/page-flow-patterns.md | you are fixing empty, error, loading, offline, onboarding, navigation, search, filter, or dashboard UX. |
reference/ux-writing-patterns.md | you are changing CTA labels, error messages, confirmations, success copy, or tone. |
reference/mobile-ux-patterns.md | the issue involves touch, gestures, thumb reach, keyboard overlap, or mobile navigation. |
reference/accessibility-patterns.md | you need WCAG 2.2 AA, keyboard, screen reader, contrast, or reduced-motion rules. |
reference/microinteraction-patterns.md | you are implementing feedback states, toasts, optimistic UI, or destructive-action safeguards. |
reference/ux-evaluation.md | you need the heuristic template, SUS ranges, UX metrics, or before/after report shape. |
reference/interaction-anti-patterns.md | you need a fast audit for interaction mistakes and destructive-action failures. |
reference/cognitive-load-anti-patterns.md | you need choice, hierarchy, progressive disclosure, or information-density guidance. |
reference/perceived-performance-patterns.md | you are choosing between skeletons, spinners, progress bars, or optimistic UI. |
reference/wcag22-inclusive-design.md | you need WCAG 2.2 deltas, inclusive design rules, or AV-pattern audits. |
reference/ai-assist-patterns.md | You are designing or reviewing AI-powered interface elements. |
reference/keyboard-navigation-patterns.md | You need tab-order rules, focus-ring requirements, shortcut-system design, roving tabindex, or focus-trap patterns. |
reference/mobile-touch-patterns.md | You need thumb-zone layout, tap-target sizing, gesture affordances, haptic vocabulary, safe-area, or keyboard-avoidance guidance. |
reference/forms-ux-patterns.md | You are deciding field order, validation timing, error-voice direction, progressive disclosure, multi-step flow, or autofill/password-manager cooperation. |
reference/error-states.md | You are designing error UX as a system — failure classification (validation/permission/server/network), message hierarchy, recovery paths, inline vs toast vs page placement, retry/undo, post-error empty-state handoff. |
reference/empty-states.md | You are designing empty states — first-use, zero-results, post-clear, post-error variants with onboarding cues, templates, and primary-action vs invitation-copy decisions. |
reference/loading-states.md | You need latency-band strategy (skeleton ≤1s, spinner 1–10s, determinate progress >10s, optimistic UI for retries), perceived-speed tactics, and skeleton-vs-spinner-vs-shimmer choice. |
_common/UX_TRENDS_2026.md | You need 2025-2026 usability and navigation evidence — NN/g navigation guidelines, hamburger / split-button anti-patterns, WCAG 2.2 AA baseline, agentic UX patterns. Read §2 IA and §1 Design a11y. |
_common/OPUS_5_AUTHORING.md | You are sizing the review report, deciding adaptive thinking depth at REVIEW, or front-loading scope tier at SCAN. Critical for Palette: P3, P5. |
_common/PROPORTION_AND_SPACING.md | You are judging spacing/layout usability with numbers — touch-target floors (WCAG 2.5.8 24px vs 2.5.5 44px vs Apple 44pt vs Material 48dp), text measure (45-75ch, WCAG 1.4.8 80-char cap), WCAG 1.4.12 text-spacing overrides, and the inner ≤ outer proximity rule (§4) that decides whether grouping reads correctly. Use §1 evidence tiers to keep spec-level findings separate from craft convention in a review report. |
_common/PROOF_CARRYING.md | You generate state_proof (every interactive component declares hover / focus / disabled / loading / error / empty states) + responsive_proof (mobile / tablet / desktop viewport assertions, 320 / 768 / 1280 minimum) in nexus acceptance Phase 2B. Coordinates with weave (state machine spec) for state coverage gating. |
reference/autorun-schema.md | You are emitting the AUTORUN _STEP_COMPLETE block — Palette-specific Output/Next schema. |