diff --git a/MASTERPLAN.md b/MASTERPLAN.md
new file mode 100644
index 0000000..61df8e4
--- /dev/null
+++ b/MASTERPLAN.md
@@ -0,0 +1,139 @@
+# VAUCO MASTERPLAN — Chris Christiansen
+**Sist oppdatert: 2026-05-23 03:00 CEST**
+**Status: Repo ferdig — GCP gjenstår**
+
+---
+
+## KONTEKST — Hva vi bygger
+
+Ett AI-drevet operativsystem (OPAX) som kjører på Google Cloud.
+Du er første kunde. Når det virker for deg → selg det til andre.
+
+**Repo-oversikt:**
+| Repo | Hva det er |
+|---|---|
+| `OSVauco` | Regler, GCP-scripts, agenter, docs — KJERNEN |
+| `vauco-gemini-tui-bridge` | Din TUI-cockpit |
+| `vauco-os` | Det kundene bruker |
+| `vauco-bootstrap` | Onboarding av nye kunder |
+| `deep-dream` | Strategisk visjon — aldri deploy herfra |
+
+---
+
+## FASE A — Ferdigstill kjernen (GCP oppe)
+**Mål: Agenten din er live på Google Cloud | Tid: Ca. 2 timer**
+
+```
+[ ] A1 — cp .env.example .env og fyll inn verdier
+        PROJECT_ID=propane-will-491900-m5
+        REGION=us-central1
+        BILLING_ACCOUNT_ID=0171F6-057E6B-A260BA
+        ALERT_EMAIL=chris.christiansen@vauco.no
+        ORCHESTRATOR_MODEL=gemini-2.0-flash
+        SUBAGENT_MODEL=gemini-2.0-flash
+
+[ ] A2 — bash infrastructure/00-authcheck.sh
+[ ] A3 — bash infrastructure/01-setupenv.sh
+[ ] A4 — bash infrastructure/07-rag-setup.sh
+[ ] A5 — bash infrastructure/08-memorybank-setup.sh
+[ ] A6 — bash infrastructure/05-cloudrun-deploy.sh
+[ ] A7 — bash infrastructure/04-observability-setup.sh
+[ ] A8 — bash infrastructure/03-teardown.sh  <- KJØR HVER KVELD
+```
+
+---
+
+## FASE B — Sikring og CI/CD
+**Mål: Bare du kan nå agenten. CI/CD oppe. | Tid: Ca. 1 time**
+
+```
+[ ] B1 — bash infrastructure/02-deploy.sh  (IAP på opax.vauco.no)
+[ ] B2 — bash infrastructure/06-cicd-setup.sh  (GitHub → Cloud Build)
+        OBS: Krever manuelt steg i GCP Console for GitHub OAuth
+```
+
+---
+
+## FASE C — Første salgsmodul
+**Mål: Ny kunde oppe på 30 minutter | Tid: Ukesarbeid**
+
+```
+[ ] C1 — Pakk vauco-bootstrap som onboarding-produkt
+[ ] C2 — Pakk vauco-os som kundens grensesnitt
+[ ] C3 — Første kunde: Medioteq (europe-north1, separat GCP-prosjekt)
+```
+
+**Salgspitch per modul:**
+| Modul | Pitch |
+|---|---|
+| OPAX-MCP | "AI-assistent som driver GCP-infrastrukturen din — uten DevOps" |
+| vauco-os | "Ferdig AI-operativsystem for din bedrift — oppe på 30 min" |
+| Gemini TUI bridge | "Chat med Gemini i terminalen — ingen nettleser" |
+| vauco-bootstrap | "Nytt GCP-miljø fra null til live — automatisk" |
+
+---
+
+## HURTIGKOMMANDOER — bruk i alle fremtidige tråder
+
+**Gjenoppta sesjon:**
+> "Act as OSVauco-NMTMD-GCOS. Resume from [FASE X / STEG Y]. Repo: chrischristiansen-glitch/OSVauco. Project: propane-will-491900-m5, Region: us-central1. Follow HITL, 50k credit budget, 7d progress reporting."
+
+**Statusrapport:**
+> "Give me an OSVauco Status Report using the 7c template."
+
+**Fortsett uten pause:**
+> "Start a new browsing phase under the current 50 000-credit budget and continue the plan."
+
+**Hång / 404:**
+> "Skip the current page/URL, log it as invalid source, and continue the plan using other sources."
+
+**Push til repo:**
+> "Push [filnavn] directly to chrischristiansen-glitch/OSVauco on branch main."
+
+---
+
+## HUSKELISTE — Viktige valg
+
+| Valg | Hvorfor |
+|---|---|
+| `us-central1` alltid | ALDRI `us-west1` — låst i AGENT_RULEBOOK |
+| `gemini-2.0-flash` | Rask og billig |
+| `google.adk.Agent` (ikke LlmAgent) | Bekreftet GA-API |
+| `load_memory_tool` | Bekreftet fra adk-python samples |
+| CMEK ikke for RAG Engine | Ikke støttet (OQ-03) |
+| CI/CD `--no-traffic` | Manuell trafikkbytte — HITL |
+| Idempotente scripts | Trygt å kjøre flere ganger |
+| `03-teardown.sh` hver kveld | Agent Runtimes koster 24/7 |
+
+---
+
+## DRIFTSKOSTNADER
+
+| Scenario | Kostnad/mnd |
+|---|---|
+| Bare deg (dev, teardown daglig) | ~$25–75 |
+| 1 betalende kunde (lett prod) | ~$115–280 |
+| Medioteq-type (klinisk, compliance) | ~$220–350 |
+
+Breakeven: 1 kunde til $300–500/mnd dekker alle kostnader.
+Ikke bygg kost-analyse-system nå — spør agenten når GCP er oppe.
+
+---
+
+## KJENTE HULL
+
+| ID | Hva | Workaround |
+|---|---|---|
+| OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only |
+| OQ-02 | RAG Engine regional availability | Default us-central1 |
+| OQ-03 | CMEK ikke for RAG Engine | VPC-SC only |
+| OQ-04 | Cloud Build GitHub OAuth | Manuelt i Console |
+| OQ-05 | gcloud alpha monitoring ustabil | Fallback || true |
+| OQ-06 | Memory Bank auto-discovery | Eksplisitt env var |
+| OQ-07 | Monitoring email flag-format | Teste i dev |
+| OQ-08 | VPC connector e2-micro regional | Default us-central1 |
+
+---
+
+*OSVauco-NMTMD-GCOS | propane-will-491900-m5 | us-central1*
+*GitHub: chrischristiansen-glitch/OSVauco*