Skip to content

An open source design system that's fully customizable and agent ready

TypeScript
2.6 KB
Raw Blame

schema_version: 1 template_version: 2 kind: design id: design: authority: draft archive_reason: null superseded_by: null approved_by: null approved_at: null owners: [] review_triggers: [visual, interaction] verified_by: [] architecture: [architecture:] components: [component:] families: [family:] deciding_specs: [spec:AST-000/DEC-0]

design specification

User intent

Design principles

  • DR1 — <principle>. <The experience MUST …>

Anatomy and hierarchy

Role Purpose Required relationship
<role> <purpose> <relationship>

State representation

State Required representation Allowed variation
<state> <what must remain perceivable> <what themes/components may vary>

Responsive and input behavior

  • DR2 — <contract>. <At this constraint/input mode, the experience MUST …>

Accessibility intent

Representative examples

Visual references

Asset State Theme or mode Viewport What it demonstrates Alt text
./assets/<design-id>/<file>.png <state> <mode> <size or n/a> <decision> <description>

Component contract links

  • component:<Name>/FR1 implements design:<surface>/DR1.

Decision log

DEC-1 — <human design decision>

Reference: design:<surface>/DEC-1 Decider: <person>, <YYYY-MM-DD>

<Reason and user impact.>

Open questions

  • OQ1 — <human design question>

Content boundary

This file does not define prop syntax, implementation structure, current audit scores, or consumer examples. It links to those owners.