Files
boc/docs/design/foundations/RFC_DEFINITION_OF_DONE.md
T
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

2.2 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 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

Role Responsibility
Author Self-check all criteria before requesting review
Reviewer Verify criteria 17, 910
Automated Verify criteria 8 (lint)
QA Verify criterion 12

Exit Criteria

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

MAY merge with criteria 13 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+)