platform-admin/boc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Foundation Freeze v1.0 complete + Experience Audit + Core Principle Check

Browse Source 
- 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.
This commit is contained in:
Bernt
2026-07-02 11:28:08 +00:00
parent 905af1b6d1
commit edf1e6e0d6
4 changed files with 174 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/design/foundations/COMPONENT_TEMPLATE.md
+5
View File
@@ -22,6 +22,11 @@ Copy this template for each new component. Remove sections that do not apply. Ad
**Design Goal:** One sentence describing the ideal user experience.
**Core Principle:** How does this component support "From Reality → Decision"?
- What decision does it help the user make?
- How does it reduce cognitive load?
- Can it be understood in 3 seconds?
**Tier:** [1 (Canonical) / 2 (Derived) / 3 (Domain)]
**Inherits From:** [Parent component, or "—" if canonical]
docs/design/foundations/FOUNDATIONS-v1.0.md
+18 -7
View File
@@ -17,6 +17,8 @@
| Foundation | Document | Version | Status |
|------------|----------|---------|--------|
| Landvex Core Principle | `LANDVEX_CORE_PRINCIPLE.md` | 1.0 | ✅ Frozen |
| Design Constitution | `LANDVEX_DESIGN_CONSTITUTION.md` | 1.0 | ✅ Frozen |
| Motion System | `MOTION_SYSTEM.md` | 1.0 | ✅ Frozen |
| AI Design Principles | `AI_DESIGN_PRINCIPLES.md` | 1.0 | ✅ Frozen |
| Semantic Color System | `SEMANTIC_COLOR_SYSTEM.md` | 1.0 | ✅ Frozen |
@@ -61,7 +63,14 @@ These rules **MUST NOT** be violated by any component built on Foundations v1.0.
- **MUST** include screen reader support
- **MUST** include reduced motion fallback
### 2.4 AI Rules
### 2.4 Core Principle Rules
- **MUST** support "From Reality → Decision" flow
- **MUST** be understandable in 3 seconds (what), 10 seconds (process), 60 seconds (value)
- **MUST** reduce cognitive load for decision-making
- **MUST** answer: "What decision does this help the user make?"
### 2.5 AI Rules
- **MUST** include AI Contract (when AI chooses this component)
- **MUST** document anti-patterns
@@ -98,6 +107,8 @@ These rules **MUST NOT** be violated by any component built on Foundations v1.0.
| Foundation | Version | Frozen Date |
|------------|---------|-------------|
| Core Principle | 1.0 | 2026-07-02 |
| Design Constitution | 1.0 | 2026-07-02 |
| Motion | 1.0 | 2026-07-02 |
| Semantic Colors | 1.0 | 2026-07-02 |
| Grid | 1.0 | 2026-07-02 |
@@ -127,11 +138,11 @@ These rules **MUST NOT** be violated by any component built on Foundations v1.0.
| Priority | Component | Status |
|----------|-----------|--------|
| 1 | Modal | ⏳ Not started |
| 2 | Navigation | ⏳ Not started |
| 3 | Search | ⏳ Not started |
| 4 | Table | ⏳ Not started |
| 5 | Data Grid | ⏳ Not started |
| 6 | Map Panel | ⏳ Not started |
| 2 | Search | ⏳ Not started |
| 3 | Map Panel | ⏳ Not started |
| 4 | Navigation | ⏳ Not started |
| 5 | Table | ⏳ Not started |
| 6 | Data Grid | ⏳ Not started |
### Future Foundations
@@ -145,7 +156,7 @@ These rules **MUST NOT** be violated by any component built on Foundations v1.0.
| Version | Datum | Beskrivning |
|---------|-------|-------------|
| 1.0 | 2026-07-02 | Initial freeze: Motion, AI Principles, Semantic Colors, Grid, Elevation, Typography, RFC Template, Definition of Done |
| 1.0 | 2026-07-02 | Initial freeze: Core Principle, Design Constitution, Motion, AI Principles, Semantic Colors, Grid, Elevation, Typography, RFC Template, Definition of Done |
---
docs/design/foundations/RFC_DEFINITION_OF_DONE.md
+14 -13
View File
@@ -15,17 +15,18 @@
| # | 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 |
| 2 | **Core Principle** | Supports "From Reality → Decision" | Self-check + Review |
| 3 | **Cognitive Purpose** | Documented — what problem does this solve? | Self-check + Review |
| 4 | **User Expectation** | Documented — what does the user expect? | Self-check + Review |
| 5 | **Interaction Contract** | Documented — events, responses, state machine | Self-check + Review |
| 6 | **Failure Behaviour** | Documented — every failure mode handled | Self-check + Review |
| 7 | **Accessibility Contract** | Documented — WCAG 2.1 AA compliance | Self-check + Review |
| 8 | **AI Contract** | Documented — when AI chooses this component | Self-check + Review |
| 9 | **Token Dependencies** | All tokens listed, no hardcoded values | Automated lint |
| 10 | **Motion** | Follows Motion System v1, reduced motion included | Self-check + Review |
| 11 | **Anti-Patterns** | Relevant anti-patterns listed and avoided | Self-check + Review |
| 12 | **Compliance Matrix** | Updated in same PR | Self-check |
| 13 | **Reference Example** | Working implementation or Storybook story | Implementation |
## Sign-Off
@@ -38,9 +39,9 @@
## Exit Criteria
**MUST** pass all 12 criteria before component is marked "Complete" in Compliance Matrix.
**MUST** pass all 13 criteria before component is marked "Complete" in Compliance Matrix.
**MAY** merge with criteria 12 pending if implementation is in separate PR.
**MAY** merge with criteria 13 pending if implementation is in separate PR.
---