Lock down the application skeleton before AI agents write UI code.

Giving a coding agent DESIGN.md sets your colors, fonts, and border radii. Across multi-session prompts, the interface still drifts structurally: container widths shift, primary actions move, 8-field forms open inside narrow modals, and filter state disappears on F5 refresh.

AGENTS.md Brain: module boundaries, build and test rules
DESIGN.md Skin: color tokens, typography, radii, shadows
UX.md Skeleton: app shell, route graph, 4-state views
npx skills add SolidStateNetwork/ux.md --skill ux-md-generator --copy -y

Interactive Archetype Blueprint Inspector

Keyboard-first issue tracker with 240px left rail, 540px ?inspect= slide-over drawer, and Cmd+K palette.

Desktop Shell Budget 1008px / 1280px
Verified Routes 4 routes (3 archetypes)
Overlay Threshold Modal <= 4 fields
Strict Linter Status PASS (0 errors)
npx ux-md init --archetype b2b-saas-workspace --project "LinearFlow Workspace"

Validated Reference Blueprints (5 Core Archetypes)

Every specification below passes all 16 deterministic rules in validate-ux.mjs --strict.

Archetype ID Reference Project Left Nav Min Canvas Routes Scroll Owner Interactive Wireframe & Source
b2b-saas-workspace Linear-Style B2B Issue Workspace 240px 720px 4 inner-canvas
ai-chat-canvas AI Chat & Artifact Split-Canvas Workspace 260px 420px 4 split-pane
analytics-dashboard Stripe-Style Telemetry & Revenue Analytics Dashboard 220px 760px 4 inner-canvas
ecommerce-storefront High-Conversion E-Commerce Storefront & Cart Funnel 240px 760px 4 window
developer-tool Cloud Infrastructure & Database Developer Workbench 220px 760px 3 inner-canvas

1. Add UX.md to AGENTS.md or CLAUDE.md

Paste this contract into your repository's AGENTS.md or CLAUDE.md so coding agents validate layout math and route parity before editing UI components:

## UI & UX Architecture Contract
- Visual tokens (colors, typography, radii, shadows): see DESIGN.md
- Structural layout (app shell budget, page archetypes, route graph, modal vs. drawer thresholds, 4-state views, and layout primitives): see UX.md
- Validate before committing UI changes: npx ux-md validate UX.md --strict --check-code

2. Zero-Dependency MCP Server & GitHub Action

Expose ux_extract, ux_generate, ux_validate, ux_scaffold, ux_preview, and ux_diff to Claude Desktop, Cursor, Windsurf, or OpenCode via Model Context Protocol:

{
  "mcpServers": {
    "ux-md": {
      "command": "npx",
      "args": ["-y", "ux-md", "mcp"]
    }
  }
}