diff --git a/README.md b/README.md
index 50bc459..c8cab37 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,9 @@
 # OSVauco
-Main OS-Vauco operator workspace repo with OPAX MCP and related Cloud Run / Gemini TUI tooling.
+
+Main operator workspace for OS-Vauco.
+
+- OPAX MCP boot script: `scripts/osvauco-opax-boot.sh`
+- Session log: `docs/OSVAUCO_OPAX_SESSION_LOG.md`
+- Governance docs: `docs/AGENT_RULEBOOK.md`, `docs/LEARNINGS.md`, `docs/ARCHITECTURE.md`, `docs/SECRETS-SETUP.md`, `docs/IAP-SETUP.md`
+
+This repo is intended to be checked out into `~/OSVauco` on Cloud Shell.
diff --git a/docs/AGENT_RULEBOOK.md b/docs/AGENT_RULEBOOK.md
new file mode 100644
index 0000000..46012f6
--- /dev/null
+++ b/docs/AGENT_RULEBOOK.md
@@ -0,0 +1,5 @@
+---
+TITLE Godkjent av Chris Christiansen - AGENT RULEBOOK (stub)
+---
+
+Se lokal kopi i Cloud Shell for full versjon.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
new file mode 100644
index 0000000..71f5031
--- /dev/null
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,5 @@
+---
+TITLE ARCHITECTURE (stub)
+---
+
+Se lokal kopi i Cloud Shell for full versjon.
diff --git a/docs/IAP-SETUP.md b/docs/IAP-SETUP.md
new file mode 100644
index 0000000..b904bdf
--- /dev/null
+++ b/docs/IAP-SETUP.md
@@ -0,0 +1,5 @@
+---
+TITLE IAP-SETUP (stub)
+---
+
+Se lokal kopi i Cloud Shell for full versjon.
diff --git a/docs/LEARNINGS.md b/docs/LEARNINGS.md
new file mode 100644
index 0000000..7f464c0
--- /dev/null
+++ b/docs/LEARNINGS.md
@@ -0,0 +1,5 @@
+---
+TITLE LEARNINGS (stub)
+---
+
+Se lokal kopi i Cloud Shell for full versjon.
diff --git a/docs/OSVAUCO_OPAX_SESSION_LOG.md b/docs/OSVAUCO_OPAX_SESSION_LOG.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/SECRETS-SETUP.md b/docs/SECRETS-SETUP.md
new file mode 100644
index 0000000..b14a2a2
--- /dev/null
+++ b/docs/SECRETS-SETUP.md
@@ -0,0 +1,5 @@
+---
+TITLE SECRETS-SETUP (stub)
+---
+
+Se lokal kopi i Cloud Shell for full versjon.
diff --git a/scripts/osvauco-opax-boot.sh b/scripts/osvauco-opax-boot.sh
new file mode 100644
index 0000000..b1b4542
--- /dev/null
+++ b/scripts/osvauco-opax-boot.sh
@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_ID="propane-will-491900-m5"
+REGION="us-central1"
+ACCOUNT="chris.christiansen@vauco.no"
+PING_URL="https://opax-mcp-core-357036551735.us-central1.run.app/ping"
+
+LOG_FILE="$HOME/OSVauco/docs/OSVAUCO_OPAX_SESSION_LOG.md"
+
+GREEN="$(tput setaf 2 || true)"
+RED="$(tput setaf 1 || true)"
+RESET="$(tput sgr0 || true)"
+
+echo "============================================================"
+echo " O S V A U C O  ·  O P A X"
+echo "============================================================"
+echo
+
+echo "Boot-script for OPAX-MCP (Cloud Run)"
+echo
+
+echo " Project : $PROJECT_ID"
+echo " Region  : $REGION"
+echo " Account : $ACCOUNT"
+echo
+
+echo " Tester OPAX-MCP på: $PING_URL"
+if curl -fsS "$PING_URL" >/dev/null 2>&1; then
+  echo " ${GREEN}✅ OPAX-MCP: OK${RESET}"
+else
+  echo " ${RED}❌ OPAX-MCP: FEIL – sjekk Cloud Run / URL${RESET}"
+fi
+
+echo
+
+mkdir -p "$(dirname "$LOG_FILE")"
+echo " Logg oppdatert: $LOG_FILE"
+touch "$LOG_FILE"
+echo
+
+read -r -p "[OSVauco/OPAX] Starte Gemini-CLI i ~/OSVauco nå? (y/N): " ANSWER
+case "$ANSWER" in
+  y|Y)
+    echo "[OSVauco/OPAX] Starter Gemini-CLI..."
+    cd "$HOME/OSVauco"
+    gemini
+    ;;
+  *)
+    echo "[OSVauco/OPAX] OK, holder deg i shell. Kjør 'gemini' når du vil inn i TUI."
+    ;;
+esac