VAUCO OS — ARCHITECTURE.md

Eier: PLAN-Claude-Architect

Sist oppdatert: 2026-05-18 — OPS-Computer-Hub (bootstrap, tom fil)

Status: STUB — PLAN-Claude-Architect fyller ut ved første boot

Hensikt

Single source of truth for systemarkitektur, komponent-diagram og design-kontrakter. Ingen andre tråder skriver denne filen. Andre tråder kan foreslå patcher via PR.

Komponent-diagram (ASCII)

[Chris / Operatør]
       |
  -----+------+----------+----------+
  |           |          |          |
OPS        EXEC       PLAN       AUDIT
Perplexity Gemini    Claude     Nemotron
Computer   2.5 Pro   Sonnet/    (NMT)
                     Opus
  |           |          |          |
  +-----+-----+----------+----------+
        |
   [GitHub]
   OSVauco (main)
   vauco-bootstrap (main)
        |
   [GCP / Cloud Run]
   project: propane-will-491900-m5
   region: us-central1
        |
   [Gemini API]
   SDK: from google import genai

Tråd-kontrakter

Tråd	Modell	Eid fil	Konnektor
OPS-Computer-Hub	Perplexity Computer	AGENTRLEBOOK.md, LEARNINGS.md, CHANGELOG.md	GitHub web, search
EXEC-Gemini-Workstation	Gemini 2.5 Pro	SYSTEM_STATE_AGENT_BOOT.md, TODO.md	shell, gcloud, git
PLAN-Claude-Architect	Claude Sonnet/Opus	ARCHITECTURE.md (denne), ROADMAP.md	GitHub UI/API
AUDIT-NMT-Critic	Nemotron	RISKREGISTER.md, PLANBOARD.md	read-only alle filer

Regel: En fil — én eier. Andre tråder foreslår via PR, eier merger.

Dataflyt

OPS  --[MD-patch PR]--> PLAN merger
EXEC --[SYSTEM_STATE]--> alle leser
PLAN --[arch-spec PR]--> EXEC implementerer
AUDIT--[PLANBOARD]--> Chris prioriterer

Filer flyter via: GitHub commits på OSVauco/main
Aldri: direkte tråd-til-tråd

Avhengigheter

OSVauco/main er canonical branch for dette prosjektet
Cloud Run avhenger av vauco-gemini-tui-bridge og OPAX-MCP-tjenesten
Bridge avhenger av bridge/-kode + GCP service account vauco-dev
Token economy avhenger av scripts/token_economy.py (planlagt)
Pre-commit hook v2 avhenger av .githooks/pre-commit (planlagt)

Åpne spørsmål (max 3)

Langsiktig repo-struktur?
- A: Behold OSVauco + tjeneste-repoer (nåværende)
- B: Slå sammen til monorepo
- C: Splitt ytterligere per tjeneste
Cloud Run min-instances=0 eller 1?
- A: 0 — kutter idle-kostnad (anbefalt H0)
- B: 1 — ingen cold start latency
- C: Autoscaling med schedule
IAM: vauco-dev service account scope?
- A: Minimal — kun Vertex AI + Firestore
- B: Bred — alle GCP tjenester i prosjektet
- C: Per-skill separate accounts

STUB-NOTAT

Denne filen er opprettet av OPS-Computer-Hub 2026-05-18 som oppstart for dette prosjektet. PLAN-Claude-Architect skal senere erstatte innholdet med komplett draft når Claude-tråden starter. Se plan_claude_architect_prompt.md.

2.9 KiB Raw Blame History