Architecture Decision Records

These pages surface every accepted design decision on the Astro Starlight docs site. Run pnpm run adrs after adding or renaming a file in docs/adr-*.mdx.

For AI tooling, start with this overview, the Storybook MCP (for component-level decisions), or docs/adrs/docs-index.json, then open the specific ADRs that govern the task. Do not use a bundled ADR document.

32 accepted ADRs

• Design Tokens — ADR-001
• Radius And Shape — ADR-002
• Typography And Density — ADR-003
• Motion And Interaction — ADR-004
• Accessibility And Release Gates — ADR-005
• Color And Theming — ADR-006
• Print Discipline — ADR-007
• Border Surface And Overlay Discipline — ADR-008
• Icon Role Placement And Layout — ADR-009
• Component Architecture And Catalog — ADR-010
• Variants And Composition — ADR-011
• Input Control Sizing — ADR-012
• Locale And Number Formatting — ADR-013
• Build Buy Or Wrap — ADR-014
• Interaction Contracts — ADR-015
• Storybook Ia And Navigation — ADR-016
• Documentation Truthfulness — ADR-017
• Docs Authoring Format — ADR-018
• Draft And Deprecation State — ADR-019
• Docs Folder Convention And Ia — ADR-020
• Code Examples And Llm Prompts — ADR-021
• Mermaid Diagram Selection — ADR-022
• Observability And Wide Events Logging — ADR-023
• Engineering Standards — ADR-024
• Identity Auth And Secrets — ADR-025
• Llm Agent Workflow And Token Discipline — ADR-026
• Default Tech Stack — ADR-027
• Platform Foundations — ADR-028
• Multi Tenancy By Default — ADR-029
• Legal Document Architecture — ADR-030
• Legal Drafting And Court Conventions — ADR-031
• Legal Output And Pdf Workflow — ADR-032