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.
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.
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"]
}
}
}