Files
boc/docs/design
Bernt 656f3bf1c2 docs: Decision Model v1.0 — LOCKED for Field Trials
- Decision Object Contract v1.0 frozen:
  - 7 fields: Decision, Why, Evidence, Confidence, Consequence, Action, Business Impact
  - Changes require v1.1 + migration note + revalidation
  - Implementation/presentation not frozen

- Status: LOCKED — Validated for Field Trials
  - Not 'Final' — signals internal validation complete, real-world proof pending

- Three pending tests defined:
  1. Decision Invariance Test (same structure across all scenarios)
  2. Evidence Variation Test (same object regardless of evidence type)
  3. Explainability Invariance Test (Decision → Finding → Evidence → Observation → Reality)

- Freeze date: 2026-07-02
- Next: Run tests, then move to 3 real customer cases

Rationale: Freeze contract before testing so tests validate a locked model,
not a moving target. 'Field Trial Ready' signals proven internally but
awaiting real-world validation.
2026-07-02 12:16:04 +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.