docs: Foundation Freeze v1.0 + directory reorganization
- FOUNDATIONS-v1.0.md:
- Freeze contract for Landvex Design System
- Scope: Motion, AI Principles, Semantic Colors, Grid, Elevation, Typography, RFC Template, Definition of Done
- Reference components: Button, Input, Select, Card (all ~83%)
- Invariants: token rules, component rules, accessibility rules, AI rules
- Change policy: no new foundation concepts without v2.0 RFC
- Versioning: 1.0.x patches, 1.x.0 new components, 2.0.0 new foundations
- Compatibility matrix for all foundations and components
- Directory reorganization:
- docs/design/foundations/ → frozen foundation documents
- docs/design/components/ → component RFCs
- docs/design/README.md → navigation and structure
- Foundation documents moved:
- TOKEN_PHILOSOPHY, SEMANTIC_COLOR_SYSTEM, GRID_ELEVATION
- AI_DESIGN_PRINCIPLES, COMPONENT_TEMPLATE, RFC_DEFINITION_OF_DONE
- DESIGN_ANTI_PATTERNS, COMPONENT_DECISION_TREE, GLOSSARY
- BRAND_PALETTE, RELEASE_DEFINITION, SEMANTIC_COLOR_SYSTEM_REVIEW
- Component RFCs moved:
- RFC-002-Input, RFC-003-Select, RFC-004-Card
Rationale: Clear separation between foundations (stable platform) and
components (built on top). Foundations v1.0 frozen — components can be
added freely within v1.x, but foundations require v2.0 RFC to change.
This prevents gradual erosion of the design system architecture.
Bernt
78436cecc2