Frontend Design
Ship distinctive, production-grade UI — not interchangeable template aesthetics.
Session boot
See ../ns-harness/references/session-boot.md. Read .nextstage-harness/rules/architecture-rules.md and layer-specific frontend rules when present.
Context to load
| File |
When |
docs/context/design-brief.md |
Always check first — tokens, typography, motion |
docs/context/stack-confirmed.md |
Framework and CSS approach |
.nextstage-harness/rules/*frontend* |
Project conventions |
references/react-analytics-ui.md |
React stack + KPIs, charts, timelines, tables, sources, alerts |
If design-brief.md is missing, infer stack from architecture rules and ask one focused question on brand direction before large UI work.
When the stack is React and the work includes dashboards or analytics UI, read references/react-analytics-ui.md before implementing — default chart library: Recharts.
When to use
- New pages, layouts, or component libraries
- Visual refresh of existing screens
- Design-brief alignment or token application
- Reducing "generic AI UI" (purple gradients, identical card grids)
Workflow
- Audit — screenshot or read existing UI patterns in the codebase; note framework (React, Vue, Blade, etc.).
- Anchor — apply
design-brief.md or establish a minimal direction (type scale, spacing, accent, motion level).
- Design — composition, hierarchy, states (hover, focus, empty, error), responsive breakpoints.
- Implement — minimal diff; match project file structure and naming.
- Verify — keyboard focus, contrast, reduced-motion respect.
See references/anti-slop.md and references/checklist.md.
Principles
- One strong visual idea per screen — not every trend at once.
- Typography carries hierarchy — do not rely on color alone.
- Motion with purpose — micro-interactions for feedback, not decoration loops.
- Accessible by default — semantic HTML, labels, focus rings.
Integration with ns-spec-driven
When invoked from the SDD face skill, stay scoped to UI tasks — do not expand into requirements or task generation.
Forbidden
- Backend API design or database schema
- Replacing
ns-reviewer for MR gates
- Ignoring project CSS/component conventions when they exist
1---2name: ns-frontend-design3description: (NS) Distinctive production UI — layout, typography, motion, polish; avoids AI-slop aesthetics. Use when building/refining pages, components, dashboards, KPI/analytics views, charts, forms, design-brief work, or better UI/UX — even if they do not say "design". Load docs/context/design-brief.md when present. Do NOT use for backend-only, requirements writing, or full SDD (ns-spec-driven).4license: Apache-2.05---67# Frontend Design89Ship **distinctive, production-grade UI** — not interchangeable template aesthetics.1011## Session boot1213See `../ns-harness/references/session-boot.md`. Read `.nextstage-harness/rules/architecture-rules.md` and layer-specific frontend rules when present.1415## Context to load1617| File | When |18| ---- | ---- |19| `docs/context/design-brief.md` | Always check first — tokens, typography, motion |20| `docs/context/stack-confirmed.md` | Framework and CSS approach |21| `.nextstage-harness/rules/*frontend*` | Project conventions |22| `references/react-analytics-ui.md` | React stack + KPIs, charts, timelines, tables, sources, alerts |2324If `design-brief.md` is missing, infer stack from architecture rules and ask **one** focused question on brand direction before large UI work.2526When the stack is **React** and the work includes dashboards or analytics UI, read `references/react-analytics-ui.md` before implementing — default chart library: **Recharts**.2728## When to use2930- New pages, layouts, or component libraries31- Visual refresh of existing screens32- Design-brief alignment or token application33- Reducing "generic AI UI" (purple gradients, identical card grids)3435## Workflow36371. **Audit** — screenshot or read existing UI patterns in the codebase; note framework (React, Vue, Blade, etc.).382. **Anchor** — apply `design-brief.md` or establish a minimal direction (type scale, spacing, accent, motion level).393. **Design** — composition, hierarchy, states (hover, focus, empty, error), responsive breakpoints.404. **Implement** — minimal diff; match project file structure and naming.415. **Verify** — keyboard focus, contrast, reduced-motion respect.4243See `references/anti-slop.md` and `references/checklist.md`.4445## Principles4647- **One strong visual idea** per screen — not every trend at once.48- **Typography carries hierarchy** — do not rely on color alone.49- **Motion with purpose** — micro-interactions for feedback, not decoration loops.50- **Accessible by default** — semantic HTML, labels, focus rings.5152## Integration with ns-spec-driven5354When invoked from the SDD face skill, stay scoped to UI tasks — do not expand into requirements or task generation.5556## Forbidden5758- Backend API design or database schema59- Replacing `ns-reviewer` for MR gates60- Ignoring project CSS/component conventions when they exist