Skip to content

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

TypeScript
2.9 KB
Raw Blame

schema_version: 4 template_version: 2 kind: system-spec id: spec:AST-000 authority: draft archive_reason: null superseded_by: null approved_by: null approved_at: null phase: proposed | accepted | implementing | shipped | withdrawn owners: [] affects_architecture: [architecture:] affects_families: [family:] affects_contributing: [contributing:] affects_consumer_docs: []

system spec

Intent

Non-goals

  • <adjacent behavior this decision does not settle>
  • Equivalent internal implementations remain valid when they satisfy this contract.
  • Internal modules, files, function names, algorithms, data structures, storage layouts, manifests, journals, locks, transaction protocols, and CI job/workflow topology belong in architecture or implementation unless callers or interoperating systems intentionally depend on that exact mechanism as a public protocol. In that case, state who depends on it and why an equivalent implementation would not satisfy the contract.

Requirements

  • FR1 — <observable behavior>. <The system MUST expose or preserve …>

Platform support

  • Supported feature/engine floor: <matrix or canonical consumer-doc link>
  • Unsupported behavior: <required fallback, graceful degradation, or prohibition>
  • Browser evidence: <evidence layer needed to prove the observable claim; do not prescribe a CI job or workflow name>

Current-state impact

Verification

Contract Verification Representative states Mutation or failure expectation
FR1 <test or evidence> <states> <removing behavior makes this fail>

Decision log

DEC-1 — <behavioral decision>

Reference: spec:AST-000/DEC-1 Decider: <person>, <YYYY-MM-DD>

<Reason, user impact, and observable contract.>

Rejected: <consequential behavioral alternative — why>. Do not record a private implementation merely because it supplied the evidence.

Open questions

  • OQ1 — <question> (checkable | human-design | human-api)