24 lines
1.2 KiB
Markdown
24 lines
1.2 KiB
Markdown
# 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
|
|
|
|
1. `docs/AI_CONTEXT.md` - Systembild, harte Regeln, Ausnahmen-Kurzliste
|
|
2. `HOMELAB_ARCHITECTURE_MASTER_V2.md` - Architektur-Zielbild
|
|
3. `docs/WORKFLOW.md` - verbindlicher GitOps-/No-Drift-Ablauf
|
|
4. die betroffene `docker-compose.yml` bzw. das betroffene Runbook (Index: `docs/README.md`)
|
|
|
|
## Nicht verhandelbar
|
|
|
|
- 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`.
|