Aura Design System

DESIGN.md (narrative spec)

Installs the agent rule into .agents/rules and the project root DESIGN.md (narrative spec). Add with shadcn as @aura/rule-design-md.

Aura DESIGN.md

Installation

pnpm dlx shadcn@latest add @aura/rule-design-md

DESIGN.md at the repo root is the narrative design specification for Aura (theme, color roles, typography, 13px grid, motion, product principles).

  • MUST: When implementing UI, aligning with brand, or reasoning about Aura tokens, read and follow DESIGN.md together with the Aura skill at .agents/skills/aura/.
  • SHOULD: Prefer tokens and patterns in DESIGN.md over ad-hoc styling or one-off hex values.
  • MUST NOT: Duplicate long design tables into rules or skills. Always-on rules state process policy; the Aura skill holds design guardrails; DESIGN.md holds the narrative detail.

DESIGN.md flavors

Themes over Aura. Generate one from any design with the generate-design-md skill, then give its link to the agent in your project.

Feature map

The only project documentation is a feature map in the Obsidian vault, updated in the PR that changes a feature. No progress logs.

On this page

Aura DESIGN.mdInstallation