Build or reshape a user-facing surface. Planning a feature without UI work stays on /w-plan. Installing a primitive stays on /w-shadcn. Do not invent PRODUCT.md or DESIGN.md. Follow existing tokens and root DESIGN.md when present. Do not install animation libraries or design-detector hooks.
Load frontend-design for visual direction, composition-patterns for reusable APIs, and web-design-guidelines for the UI code checklist. Durable jobs live in matching MDX/README/DESIGN.md.
- Name the job, the person, and the surface mode: Operate (app/task), Persuade (marketing), or Read (docs).
- Use the brief, existing screens, or a stated aesthetic. If the repo has tokens and shared components, inspect those first.
- Prefer shared primitives. Compose at the second call site. Do not extract a compound API for a one-off route. Do not lift server data into a client provider.
- Mobile-first layout, visible focus, keyboard path,
prefers-reduced-motion. Do not add a new motion library. - Cover loading, empty, error, success, and overflow as applicable.
- Implement the smallest slice that completes the job.
- Inspect desktop and mobile together. Exercise primary interactions and keyboard navigation. Critique screenshots. Fix evidenced issues in one batch. Confirm with at most one more pass, then stop. If browser tools are missing, say so. A type check is not visual QA.
- Optional:
/w-a11yagainst existing a11y docs and tests (do not invent a WCAG level). Playwright E2E only when an existing spec covers the path. - Docs:
/w-docsif behavior or commands changed.
