From 905af1b6d1eb1bf6dd1c37fd758c4068be3b118d Mon Sep 17 00:00:00 2001
From: Bernt <bernt@aamos.systems>
Date: Thu, 2 Jul 2026 11:25:00 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20Landvex=20Core=20Principle=20=E2=80=94?=
 =?UTF-8?q?=20From=20Reality=20=E2=86=92=20Decision?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- LANDVEX_CORE_PRINCIPLE.md (v1.0, LOCKED):
  - Single promise: From reality → decision
  - Five steps: Question → Collect → Analyze → Calculate → Decision
  - Business verbs, not technical terms
  - Three-second rule: 3s/10s/60s understanding levels
  - Gauge: Video → AI → Score
  - Applies to all communication, UX, documentation, AI

- LANDVEX_DESIGN_CONSTITUTION.md:
  - Added §0: From Reality → Decision as highest principle
  - Five steps in Swedish
  - Three-second rule
  - Gauge explanation
  - Positioned before Introduction as foundational principle

Rationale: Landvex sells one thing — from reality to decision.
Every screen, illustration, and presentation must follow this flow.
Business verbs make it human. Three-second rule makes it scannable.
Gauge makes it instantly understandable.
---
 docs/design/LANDVEX_CORE_PRINCIPLE.md      | 139 +++++++++++++++++++++
 docs/design/LANDVEX_DESIGN_CONSTITUTION.md |  20 +++
 2 files changed, 159 insertions(+)
 create mode 100644 docs/design/LANDVEX_CORE_PRINCIPLE.md

diff --git a/docs/design/LANDVEX_CORE_PRINCIPLE.md b/docs/design/LANDVEX_CORE_PRINCIPLE.md
new file mode 100644
index 000000000..e3fe9f382
--- /dev/null
+++ b/docs/design/LANDVEX_CORE_PRINCIPLE.md
@@ -0,0 +1,139 @@
+# LANDVEX CORE PRINCIPLE
+
+**From Reality → Decision**
+
+| | |
+|---|---|
+| **Version** | 1.0 |
+| **Status** | LOCKED |
+| **Scope** | All Landvex products, communication, UX, documentation |
+
+---
+
+## The Single Promise
+
+**Landvex sells one thing: From reality → decision.**
+
+Not AI. Not video. Not index. Not data.
+
+**From reality → decision.**
+
+---
+
+## The Five Steps
+
+Every screen, illustration, and presentation must follow this flow:
+
+```
+Du har en fråga
+      ↓
+Vi samlar verkligheten
+      ↓
+Vi analyserar
+      ↓
+Vi räknar om
+      ↓
+Du får ett beslut
+```
+
+### 1. Du har en fråga
+
+**Not:** "Define the decision"
+**But:** "What do you want to know?"
+
+Examples:
+- Should we invest here?
+- Does the road need repair?
+- Is the area safe?
+
+### 2. Vi samlar verkligheten
+
+**Not:** "Reality capture via quiXzoom"
+**But:** "We collect reality"
+
+Sources:
+- Mobile phones
+- Drones
+- Cameras
+
+### 3. Vi analyserar
+
+**Not:** "AI analysis and contradiction check"
+**But:** "We find what doesn't match"
+
+Or: "We compare reality with official data"
+
+### 4. Vi räknar om
+
+**Not:** "Standardized indices"
+**But:** "We calculate everything into a score (0–100)"
+
+### 5. Du får ett beslutsunderlag
+
+**Not:** "Answer in 24–72 hours"
+**But:** "You get a decision basis"
+
+Delivery time is secondary. Decision value is primary.
+
+---
+
+## The Three-Second Rule
+
+Every screen, illustration, and presentation must be understandable at three levels:
+
+| Time | Understanding |
+|------|---------------|
+| **3 seconds** | What does the system do? |
+| **10 seconds** | The process from input to decision basis |
+| **60 seconds** | Why the result is useful for the business |
+
+---
+
+## The Gauge
+
+The gauge is central. It shows:
+
+```
+VIDEO
+  ↓
+ AI
+  ↓
+ 87
+```
+
+In one second, the user understands: **"Video becomes a score."**
+
+That is Landvex.
+
+---
+
+## Application
+
+### Communication
+All marketing, sales, and presentation materials follow the five steps.
+
+### UX
+Every screen follows the three-level rule.
+
+### Documentation
+Every document starts with the five steps.
+
+### AI
+Every AI output follows the five steps.
+
+---
+
+## ÄNDRINGSHISTORIA
+
+| Version | Datum | Beskrivning |
+|---------|-------|-------------|
+| 1.0 | 2026-07-02 | Initial core principle: From reality → decision |
+
+---
+
+## STATUS
+
+**LOCKED**
+
+- Mindre revideringar: 1.x-serien
+- Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+)
diff --git a/docs/design/LANDVEX_DESIGN_CONSTITUTION.md b/docs/design/LANDVEX_DESIGN_CONSTITUTION.md
index dd7db38a9..63a0a6d78 100644
--- a/docs/design/LANDVEX_DESIGN_CONSTITUTION.md
+++ b/docs/design/LANDVEX_DESIGN_CONSTITUTION.md
@@ -13,6 +13,26 @@
 
 ---
 
+## 0. FROM REALITY → DECISION
+
+Landvex har ett enda syfte: omvandla verklighet till handling.
+
+**De fem stegen:**
+1. **Du har en fråga** — Vad vill du veta?
+2. **Vi samlar verkligheten** — Mobiler, drönare, kameror
+3. **Vi analyserar** — Vi hittar det som inte stämmer
+4. **Vi räknar om** — Allt blir ett betyg (0–100)
+5. **Du får ett beslutsunderlag** — Inom 24–72 timmar
+
+**Tresekundersregeln:**
+- **3 sekunder:** Förstå vad systemet gör
+- **10 sekunder:** Förstå processen från fråga till beslut
+- **60 sekunder:** Förstå varför resultatet är användbart
+
+**Mätaren:** Video → AI → Betyg. På en sekund: "Video blir ett betyg." Det är Landvex.
+
+---
+
 ## 1. INTRODUKTION
 
 Landvex är inte en traditionell webbplats.