chore: move wiki links to meta/astryx
Name the human design review instead of the bare 'L3', and link it
Repoint two more pointers at the sections that exist
Fix every piped wiki link: GitHub treats the text after the pipe as the page name
Delete the superseded hardening and auditor pages; repoint every link at the rubric
Reroute links from the collapsed auditor sections to the rubric Design Conventions, API Conventions, the Accessibility Checklist, Component Lifecycle and the Night Watch role summary all pointed at auditor sections that no longer exist. Each now points at the rubric section that carries the check, with the convention pages still owning what the rule is.
Correct the neutral gray token names to the ones that exist --color-secondary, --color-muted and --color-wash are not in packages/core/src/theme/tokens.stylex.ts. The real roles are --color-neutral (self-contained elements), --color-background-muted (containers with content), --color-track (slim rails) and --color-background-body (page level).
Split reorder visuals into drag and drop rows
Clarify transient reorder opacity exception
Document reorder interaction state
Updated Design Conventions (markdown)
Design Conventions: refine State Representations visuals - Add Hovered (Ring style) row for field hover (emphasized border + inset ring) - Show a selected radio in the Filled-style example - Use a basic stepper (no error states) for the Edge-style example - Drop the checkbox-list image from the Depressed-style row - Split Loading (skeleton) from Processing (spinner); add an input-with-spinner example - Muted status: use a warning banner + destructive button (both carry the muted colored background) - Inverted status: show only positive/negative badges - Give agent states the shared Visuals/Representation columns, left blank
Design Conventions: content-first restructure - Condense intro into a concise marker-usage table (objective/assisted/judgment + who verifies) - Move audit mechanics (lens, check IDs, output contract) out to the Component Auditor; keep this page content-first - Reformat Design Foundations: standalone 'Why it matters' lead-in, then a header-less table of Principle / Smells / Got it right - Add a compact 'What's checkable, and where it's checked' pointer table
Design Conventions: restructure state sections by driver and prominence - Rename section headings to 'User/System/Agent Interaction States Visuals' - Move Disabled into System interaction states - Label states as 'State (variant style)' (e.g. Selected (Depressed style)) - Split System status by prominence tier: Muted (inputs + in-flow surfaces), Inverted (badges + high-severity toasts), Temporal (toasts + tooltips) - Add a Temporal row (tooltip + default toast) for brief high-prominence states - One consolidated description per row; rows may show several example images - Capture real selected list/nav items (SideNav, TreeList) and toggle buttons for Selected (Depressed style); fix previously-broken image references
Design Conventions: retitle foundations, fold Generative description column - Foundation headings use 'Title (Category)' format instead of <sub> suffix (e.g. 'Consistent vertical rhythm (Size | Density)') - Generative States table folds its Description column into the State column, matching the Foundation and Async tables
Design Conventions: split state rows by distinct visual treatment - Split Focused into Focused and Focused (Input) - Split Selected into 5 rows by what's being selected: Toggles (checkbox/ radio/switch), Control (segmented), Navigation (tabs/outline/stepper), Container (cards), List (nav item/list row) - Merge Loading and Processing into one row; add input-family loading examples (skeleton placeholder, busy input group) - Fold the status prominence tiers into the Async table (each status row shows its tiers side by side) instead of a separate table - Add the Outline component as a Navigation selection visual
Design Conventions: format foundation Smells as bullet lists Break each foundation's Smells cell from a packed run-on paragraph into a bulleted list (one smell per line, bold term leading) for readability.
Design Conventions: colocate state visuals in the state table; drop gray canvas - Trim state screenshots to the component on its own clean surface (no gray padding canvas, no white bleed) - Merge the separate image tables into the main state table: each state row now holds its own visuals with inline description + API/ARIA reference
Design Conventions: simplify State Representations - Drop the per-archetype columns (action/input/control/container); show one summary row per state with an approved-visuals count - Fold API/ARIA into each state's description - Enlarge the state visuals (width 240) so the image is the main reference - Standardize caption format: backticked token(s) + how it's applied
Design Conventions: foundations as tables; 'minimize visuals per state' Reformat the Design Foundations section from stacked bold-paragraph cards into a label-column table per foundation (Principle / Why / Smells / Got it right) for scannability. Reword the principle to 'minimize visuals per state'.
Add Design Conventions page Design-side sibling of API Conventions: the intention behind token choices (foundations), standard state representations across component archetypes, and how design quality is evaluated. - Wire the Contributing Design Review section and Home index to the new page - Component Auditor gains a Design Conventions dimension for the objectively-checkable rules (spacing grid, concentric radius, contrast, type hierarchy, motion safety, stacking); subjective visual judgment stays in Hardening Layer 3