Files
boc/docs/design
Bernt edf1e6e0d6 docs: Foundation Freeze v1.0 complete + Experience Audit + Core Principle Check
- FOUNDATIONS-v1.0.md updated:
  - Added Landvex Core Principle and Design Constitution to frozen foundations
  - Added Core Principle Rules to invariants (2.4)
  - Reordered component priority: Modal, Search, Map Panel, Navigation, Table, Data Grid
  - Reflects business value: search and maps are central to Landvex

- EXPERIENCE_AUDIT.md (v1.0, LOCKED):
  - Four questions for every screen:
    1. Can purpose be understood in 3 seconds?
    2. Is 'Reality → Decision' visible?
    3. Is it obvious what the user should do?
    4. Does everything contribute to the decision?
  - Three-second rule levels with verification method
  - Audit process: select screens → apply questions → prioritize fixes → verify
  - Example audit format
  - Core Principle Check for RFCs: 4 questions before approval

- COMPONENT_TEMPLATE.md updated:
  - Added Core Principle section to template
  - Requires: decision support, cognitive load reduction, 3-second understanding

- RFC_DEFINITION_OF_DONE.md updated:
  - Added Core Principle as criterion #2 (was 12 criteria, now 13)
  - Exit criteria: must pass all 13

Rationale: Freeze foundation with Core Principle as highest authority.
Experience audit ensures all screens support decision-making.
Core Principle Check prevents components that don't serve the user.
Business-value prioritization: search and maps before tables.
2026-07-02 11:28:08 +00:00
..

Landvex Design System

Documentation Structure

docs/design/
├── README.md                    # This file
├── COMPLIANCE_MATRIX.md         # Component readiness tracking
├── LANDVEX_DESIGN_CONSTITUTION.md  # UX principles (Level 3)
├── LANDVEX_DESIGN_SPECIFICATION.md # Technical contract (Level 5)
├── foundations/                 # Frozen foundations
│   ├── FOUNDATIONS-v1.0.md      # Freeze contract
│   ├── TOKEN_PHILOSOPHY.md      # Token rules
│   ├── SEMANTIC_COLOR_SYSTEM.md # Color tokens
│   ├── GRID_ELEVATION.md        # Layout & depth
│   ├── AI_DESIGN_PRINCIPLES.md  # AI governance
│   ├── COMPONENT_TEMPLATE.md    # RFC template
│   ├── RFC_DEFINITION_OF_DONE.md # Quality gate
│   ├── DESIGN_ANTI_PATTERNS.md  # Forbidden patterns
│   ├── COMPONENT_DECISION_TREE.md # Selection guide
│   ├── GLOSSARY.md              # Common language
│   ├── BRAND_PALETTE.md         # Brand colors
│   └── RELEASE_DEFINITION.md    # Release gates
├── components/                  # Component RFCs
│   ├── RFC-002-Input.md
│   ├── RFC-003-Select.md
│   └── RFC-004-Card.md
└── platform/                    # Cross-cutting governance
    └── README.md

Status

Foundations v1.0 — FROZEN

Components build on foundations. Foundations do not change without v2.0 RFC.