OSVauco/docs/AGENT_RULEBOOK.md

4.4 KiB

VAUCO OS — AGENTRLEBOOK.md

Eier: OPS-Computer-Hub

Sist oppdatert: 2026-05-18 2026-05-18 CEST

Godkjent av: Chris Christiansen


Hensikt

Immutable regler for alle 4 tråder. Ingen tråd kan overstyre disse. Endringer krever eksplisitt godkjenning fra Chris.


LOCK LIST — ALDRI ENDRE

Parameter Verdi
GCP Account chris.christiansen@vauco.no
Forbudte kontoer tinius.vauger, ccv, jason.vauger
GCP Project propane-will-491900-m5 (Jason-v1)
Billing 0171F6-057E6B-A260BA
Org vauco.no / 155051211891
Region us-central1 — ALDRI us-west1
SDK from google import genai — ALDRI vertexai.generative_models
Agent-rammeverk Google ADK (tillatt) — andre må eksplisitt ADK_GODKJENT av Chris
GitHub user chrischristiansen-glitch
Canonical repo OSVauco
Canonical branch main

HITL-GATES — STOPP OG SPØR ALLTID

  1. DEPLOY GODKJENT — før deploy til Cloud Run
  2. MERGE APPROVED — før merge til main
  3. DEEP DREAM GODKJENT — før strategisk vokabular eksponeres
  4. COST GODKJENT — før endringer som påvirker billing
  5. IAM_GODKJENT — før IAM-endringer eller ny service account
  6. NEWREPO — før opprettelse av ny repo

BOOT-PROTOKOLL — kjøres av ALLE tråder ved oppstart

  1. Branch-discovery: list alle branches, finn mest aktiv (ahead av default)
    • Hvis 1+ branch er 10+ commits ahead: STOPP og spør Chris
    • Standard: OSVauco/main er canonical for dette prosjektet
  2. Les eid fil + MASTER_HANDOFF_v2 + ROADMAP fra riktig branch
  3. Bekreft i én linje: Boot OK — branch X, HEAD Y, oppgave Z

VOCABULARY FIREWALL

Type Ord Regel
Offentlig (OK overalt) Token Ledger, VVN, Provenance, File signature, Client identity record, Cognitive contribution, The system Fritt bruk
Strategisk (KUN internt) Pregeverdi, Deep Dream, Vauco-arv, Pregesignatur, T-konto, Work of Living, Pregeverk KUN i deep-dream/-mappe

KOST-DISIPLIN

  • $3/dag hard cap per tråd
  • gemini-2.5-flash for enkle steg, pro for komplekse
  • ALDRI rekursive modell-loops
  • Hvis tråden bruker $1 på én oppgave: STOPP, rapporter, spør
  • 80%/95%/100% quota stops aktive

FRICTION-REGLER (kodifisert lærdom)

TASK-FRICTION-001: Branch-discovery-before-read

Preflight må advare hvis non-default branch er 10+ commits ahead. Implementer i: scripts/preflight-check.sh

TASK-FRICTION-002: SYSTEM_STATE_AGENT_BOOT autogenerering

Boot-script skriver fersk state-fil ved hver tråd-oppstart. Implementer i: scripts/boot-state.sh (EXEC eier)

TASK-FRICTION-003: Eierskap-matrise håndhevet i pre-commit

Pre-commit hook avviser commit hvis fil endres av feil tråd. Implementer i: .githooks/pre-commit (OPS eier)


KORREKSJONS-REGEL

Ground truth wins always.

  1. Innrøm direkte i én setning
  2. Oppdater eid fil med korreksjon
  3. Fortsett ALDRI forsvar gamle posisjoner.

KOMMUNIKASJON MELLOM TRÅDER

  • ML-TRÅD: Chris kopierer melding over
  • Filer flyter via GitHub (OSVauco + tjeneste-repoer)
  • Aldri direkte tråd-til-tråd — alt via committed MD eller Chris

EIERSKAP-MATRISE

Fil Eier Andre kan
VAUCO_OS_MASTER_HANDOFF_v2.md OPS lese
VAUCO_OS_ROADMAP.md PLAN lese, foreslå patch via PR
SYSTEM_STATE_AGENT_BOOT.md EXEC lese
docs/AGENTRLEBOOK.md OPS lese
docs/ARCHITECTURE.md PLAN lese, foreslå patch via PR
docs/LEARNINGS.md OPS lese, foreslå append
docs/RISKREGISTER.md AUDIT lese
docs/PLANBOARD.md AUDIT lese
CHANGELOG.md OPS lese
TODO.md EXEC lese

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


EOF v1.0 — 2026-05-18 — OPS-Computer-Hub