From 8ee9965378f1a503633a2a544e1c395ff031f603 Mon Sep 17 00:00:00 2001 From: Bernt Date: Thu, 2 Jul 2026 11:32:25 +0000 Subject: [PATCH] docs: Experience Audit + Component Maturity Model MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - EXPERIENCE_AUDIT_QA.md (v1.0, DRAFT): - Audit framework: 6 questions per screen - Screen 1: quiXzoom Onboarding — 3s ✅, R→D ⚠️, Decision ✅ - Issue: 'kr' used instead of USD/EUR (Valutaregel violation) - Issue: Launch date creates hesitation - Screen 2: Landvex Process — 3s ✅, R→D ✅, Decision ✅ - Issue: Technical terms in step descriptions - Action items: currency update, date removal, verb simplification - Next screens: Dashboard, Map View, Search, Mission Details, Results - COMPONENT_MATURITY.md (v1.0, LOCKED): - Three levels: Foundation → Validated → Canonical - Foundation: RFC approved, passes 13 DoD criteria - Validated: used in 3 real screens, passes Experience Audit - Canonical: used in 5 screens, 2 sprints stable, other components inherit - Promotion process with verification requirements - Current status: all 4 components at Foundation level Rationale: Observe first, standardize second. Components become Canonical only after proving value in real screens. Experience Audit identifies gaps before building components. Maturity model prevents premature standardization. --- docs/design/COMPONENT_MATURITY.md | 80 +++++++++++++++++ docs/design/EXPERIENCE_AUDIT_QA.md | 137 +++++++++++++++++++++++++++++ 2 files changed, 217 insertions(+) create mode 100644 docs/design/COMPONENT_MATURITY.md create mode 100644 docs/design/EXPERIENCE_AUDIT_QA.md diff --git a/docs/design/COMPONENT_MATURITY.md b/docs/design/COMPONENT_MATURITY.md new file mode 100644 index 000000000..6e4a8416c --- /dev/null +++ b/docs/design/COMPONENT_MATURITY.md @@ -0,0 +1,80 @@ +# COMPONENT MATURITY MODEL + +**Maturity Levels for Design System Components** + +| | | +|---|---| +| **Version** | 1.0 | +| **Status** | LOCKED | +| **Scope** | All Landvex & quiXzoom components | + +--- + +## Maturity Levels + +### Level 1: Foundation + +**Criteria:** +- RFC approved +- Follows COMPONENT_TEMPLATE.md +- Passes all 13 Definition of Done criteria +- Documented in Compliance Matrix + +**Meaning:** The component is specified and stable. + +### Level 2: Validated + +**Criteria:** +- Used in at least 3 real screens +- Passes Experience Audit +- No critical issues found +- Feedback from at least 2 users or user proxies + +**Meaning:** The component works in practice. + +### Level 3: Canonical + +**Criteria:** +- Used in at least 5 real screens +- No open issues for 2 sprints +- Other components inherit from it +- Documented as reference implementation + +**Meaning:** The component is the standard for future development. + +--- + +## Current Status + +| Component | Level | Evidence | Next Step | +|-----------|-------|----------|-----------| +| Button | Foundation | RFC-001 approved | Use in 3 screens → Validated | +| Input | Foundation | RFC-002 approved | Use in 3 screens → Validated | +| Select | Foundation | RFC-003 approved | Use in 3 screens → Validated | +| Card | Foundation | RFC-004 approved | Use in 3 screens → Validated | + +--- + +## Promotion Process + +| From | To | Requirement | Verified By | +|------|-----|-------------|-------------| +| Foundation | Validated | 3 real screens + Experience Audit | Design Review | +| Validated | Canonical | 5 screens + 2 sprints stable + inheritance | Architecture Review | + +--- + +## ÄNDRINGSHISTORIA + +| Version | Datum | Beskrivning | +|---------|-------|-------------| +| 1.0 | 2026-07-02 | Initial maturity model: Foundation → Validated → Canonical | + +--- + +## STATUS + +**LOCKED** + +- Mindre revideringar: 1.x-serien +- Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+) diff --git a/docs/design/EXPERIENCE_AUDIT_QA.md b/docs/design/EXPERIENCE_AUDIT_QA.md new file mode 100644 index 000000000..32bfb311e --- /dev/null +++ b/docs/design/EXPERIENCE_AUDIT_QA.md @@ -0,0 +1,137 @@ +# EXPERIENCE AUDIT — QUI XZOOM + LANDVEX + +**Audit of Real Screens Against Landvex Core Principle** + +| | | +|---|---| +| **Version** | 1.0 | +| **Status** | DRAFT — In progress | +| **Date** | 2026-07-02 | +| **Auditor** | AI Agent | + +--- + +## Audit Framework + +### The Six Questions + +| # | Question | Answer | +|---|----------|--------| +| 1 | Does the user understand the purpose in 3 seconds? | ✅ / ⚠️ / ❌ | +| 2 | Is "Reality → Decision" visible in the flow? | ✅ / ⚠️ / ❌ | +| 3 | Is there a clear primary decision? | ✅ / ⚠️ / ❌ | +| 4 | Is there visual noise? | List items | +| 5 | What is the user's decision on this screen? | Free text | +| 6 | What information can be removed without harming the decision? | Free text | + +### Scoring + +| Symbol | Meaning | +|--------|---------| +| ✅ | Pass — no issues | +| ⚠️ | Warning — needs improvement | +| ❌ | Fail — blocks decision-making | + +--- + +## Screen 1: quiXzoom Onboarding / Landing + +**Reference:** Image shared 2026-07-02 + +### Audit + +| # | Question | Answer | Notes | +|---|----------|--------|-------| +| 1 | 3-second understanding | ✅ | "Fota. Skicka in. Tjäna pengar." — instantly clear | +| 2 | Reality → Decision visible | ⚠️ | Shows "Reality → Money" not "Reality → Decision" | +| 3 | Clear primary decision | ✅ | "Sign up" or "Find missions" | +| 4 | Visual noise | — | Clean, minimal | +| 5 | User's decision | "Should I join quiXzoom?" | | +| 6 | Removable information | Launch date (August 2026) — creates hesitation | | + +### Issues + +| Severity | Issue | Recommendation | +|----------|-------|----------------| +| Medium | "kr" used instead of USD/EUR | Update per Valutaregel (MEMORY.md §0) | +| Low | Launch date creates hesitation | Remove or de-emphasize | + +### Core Principle Alignment + +**Verdict:** ⚠️ Partial — shows "Reality → Money" for Zoomers, not "Reality → Decision" for decision-makers. + +**Note:** This is correct for the audience (Zoomers), but quiXzoom should also have a decision-maker landing page. + +--- + +## Screen 2: Landvex Decision Intelligence Process + +**Reference:** Image shared 2026-07-02 + +### Audit + +| # | Question | Answer | Notes | +|---|----------|--------|-------| +| 1 | 3-second understanding | ✅ | Gauge immediately visible | +| 2 | Reality → Decision visible | ✅ | Five steps clearly shown | +| 3 | Clear primary decision | ✅ | "Should I invest/repair/act?" | +| 4 | Visual noise | — | Minimal, focused | +| 5 | User's decision | "Should I act on this information?" | | +| 6 | Removable information | Technical terms ("AI analysis", "standardized indices") | | + +### Issues + +| Severity | Issue | Recommendation | +|----------|-------|----------------| +| Low | Technical terms in step descriptions | Replace with business verbs per Core Principle | + +### Core Principle Alignment + +**Verdict:** ✅ Strong — follows "From Reality → Decision" flow. + +**Improvement:** Simplify step labels to business verbs (already documented in LANDVEX_CORE_PRINCIPLE.md). + +--- + +## Summary + +| Screen | 3s | R→D | Decision | Noise | Overall | +|--------|-----|-----|----------|-------|---------| +| quiXzoom Onboarding | ✅ | ⚠️ | ✅ | — | ⚠️ | +| Landvex Process | ✅ | ✅ | ✅ | — | ✅ | + +--- + +## Action Items + +1. **quiXzoom:** Update currency from "kr" to USD/EUR per Valutaregel +2. **quiXzoom:** Consider removing or de-emphasizing launch date +3. **Landvex:** Update process diagram with business verbs (already in Core Principle) +4. **Both:** Continue audit with Dashboard, Map View, Search, Results + +--- + +## Next Screens to Audit + +| Priority | Screen | Product | +|----------|--------|---------| +| 1 | Dashboard | Landvex | +| 2 | Map View | Landvex | +| 3 | Search | Landvex | +| 4 | Mission Details | quiXzoom | +| 5 | Results/Decision View | Landvex | +| 6 | Settings/Profile | Both | + +--- + +## ÄNDRINGSHISTORIA + +| Version | Datum | Beskrivning | +|---------|-------|-------------| +| 1.0 | 2026-07-02 | Initial audit: quiXzoom onboarding, Landvex process | + +--- + +## STATUS + +**DRAFT — Awaiting more screens**