Files

T

Bernt 78436cecc2 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.

2026-07-02 11:23:10 +00:00

2.1 KiB

Raw Blame History

RFC DEFINITION OF DONE

Quality Gate for Every RFC Component


Version	1.0
Status	LOCKED
Scope	All Tier 1, 2, 3 components

Checklist

#	Criterion	Requirement	Verified By
1	RFC Structure	100% complete per `COMPONENT_TEMPLATE.md`	Self-check + Review
2	Cognitive Purpose	Documented — what problem does this solve?	Self-check + Review
3	User Expectation	Documented — what does the user expect?	Self-check + Review
4	Interaction Contract	Documented — events, responses, state machine	Self-check + Review
5	Failure Behaviour	Documented — every failure mode handled	Self-check + Review
6	Accessibility Contract	Documented — WCAG 2.1 AA compliance	Self-check + Review
7	AI Contract	Documented — when AI chooses this component	Self-check + Review
8	Token Dependencies	All tokens listed, no hardcoded values	Automated lint
9	Motion	Follows Motion System v1, reduced motion included	Self-check + Review
10	Anti-Patterns	Relevant anti-patterns listed and avoided	Self-check + Review
11	Compliance Matrix	Updated in same PR	Self-check
12	Reference Example	Working implementation or Storybook story	Implementation

Sign-Off

Role	Responsibility
Author	Self-check all criteria before requesting review
Reviewer	Verify criteria 1–7, 9–10
Automated	Verify criteria 8 (lint)
QA	Verify criterion 12

Exit Criteria

MUST pass all 12 criteria before component is marked "Complete" in Compliance Matrix.

MAY merge with criteria 12 pending if implementation is in separate PR.

ÄNDRINGSHISTORIA

Version	Datum	Beskrivning
1.0	2026-07-02	Initial Definition of Done for RFC components

STATUS

LOCKED

Mindre revideringar: 1.x-serien
Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+)

2.1 KiB Raw Blame History Unescape Escape