Agent Context - Homelab Infra

Typ: Einstieg/Index · Stand: 2026-06-11 · Status: aktiv

Einstiegspunkt fuer KI-Agenten (Codex, Gemini u. a.; Claude nutzt zusaetzlich CLAUDE.md). Kein eigener Inhalt - nur Pflichtpfade.

Vor jeder Arbeit lesen

docs/AI_CONTEXT.md - Systembild, harte Regeln, Ausnahmen-Kurzliste
HOMELAB_ARCHITECTURE_MASTER_V2.md - Architektur-Zielbild
docs/WORKFLOW.md - verbindlicher GitOps-/No-Drift-Ablauf
die betroffene docker-compose.yml bzw. das betroffene Runbook (Index: docs/README.md)

Keine Secret-Werte lesen, zitieren oder schreiben - nur Namen und Pfade.
Codex/Claude-Hostzugriffe fuer Komodo/Unraid sind in docs/SECRETS_MAP.md als Secret-Pfade dokumentiert. Werte niemals ausgeben, loggen oder in Git schreiben; Nutzung nur fuer ausdruecklich angeforderte Host-/Live-Checks.
Keine Deployments, Host-Hotfixes oder Docker-Schreibbefehle ohne ausdrueckliche Anweisung.
Doku-Regeln aus docs/REPO_MAP.md einhalten: ein Fakt, ein Zuhause. Status nur in docs/MASTER_TODO.md, Entscheidungen nur in docs/DECISIONS.md.
Bei Drift oder zwei fehlgeschlagenen Reparaturversuchen: stoppen, docs/GITOPS_DRIFT_RUNBOOK.md.