docs: Experience Audit + Component Maturity Model
- 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.
This commit is contained in:
Bernt
@@ -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+)
|
||||
@@ -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**
|
||||
Reference in New Issue
Block a user