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/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.
---