An open source design system that's fully customizable and agent ready
TypeScript
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)