An open source design system that's fully customizable and agent ready
TypeScript
schema_version: 1 template_version: 3 kind: architecture id: architecture: authority: draft archive_reason: null superseded_by: null approved_by: null approved_at: null owners: [] applies_to: [] verified_by: [] deciding_specs: [spec:AST-000/DEC-0]
architecture
Contract at a glance
| Area | Contract |
|---|---|
| Governing contract | <Observable current decisions this architecture serves; write “None” when no product contract changes.> |
| System behavior | <Shipped system behavior, including the decisive invariant, boundary, or precedence rule.> |
| End-user impact | <Who is affected, in what state, and what improves, worsens, or remains unchanged.> |
| Builder impact | <Which implementation decisions, coordination work, or workarounds this architecture removes or adds.> |
| Compatibility/readiness | <Compatibility effect; authority and implementation state; material evidence still pending.> |
| Review checks | <Reject specific boundary violations, mechanism leaks into product API, or lost invariants/evidence distinctions already forbidden below.> |
| Governing rules | <Deciding specs and only the current clauses needed to justify this projection.> |
This table is a review projection; the body below is authoritative.
Purpose
System model
Boundaries and invariants
- INV1 —
<invariant>.<What MUST remain true in the shipped system.>
Change coupling
Owning code
<path or public module>—<responsibility>
Deciding specs
spec:AST-000/DEC-0—<observable behavior decision; architecture records never treat implementation evidence as product authority>
Verification
| Invariant | Evidence | Failure signal |
|---|---|---|
| INV1 | <test or observable evidence> |
<what fails when the invariant breaks> |