docs: add MASTERPLAN.md — Fase A/B/C, hurtigkommandoer, kostnader

Added a comprehensive master plan for the VAUCO project, detailing phases, tasks, and operational costs.

2026-05-23 03:44:06 +02:00

4.5 KiB

Raw Blame History

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
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

4.5 KiB Raw Blame History Unescape Escape