From 08b4be7a5d9db3999912d74c48b312174d543134 Mon Sep 17 00:00:00 2001 From: Micha Date: Thu, 11 Jun 2026 19:50:53 +0200 Subject: [PATCH] docs: add AGENTS.md entry point for non-Claude AI agents Codex CLI auto-reads AGENTS.md; file only points to AI_CONTEXT, architecture master, workflow and the binding doc rules - no duplicated content (one fact, one home). Co-Authored-By: Claude Fable 5 --- AGENTS.md | 20 ++++++++++++++++++++ docs/README.md | 1 + 2 files changed, 21 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..c1115dd --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,20 @@ +# 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. +- 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`. diff --git a/docs/README.md b/docs/README.md index 0e3fcb0..3ab0e15 100644 --- a/docs/README.md +++ b/docs/README.md @@ -14,6 +14,7 @@ geloescht (Git-Historie ist das Archiv). Verbindliche Doku-Regeln: | Datei | Zweck | |---|---| | `../README.md` | kurzer Repo-Einstieg | +| `../AGENTS.md` | Einstiegspunkt fuer KI-Agenten (Codex u. a.) | | `../HOMELAB_ARCHITECTURE_MASTER_V2.md` | Architektur-Quelle fuer Netz, Zugriff und Ausnahmen | | `WORKFLOW.md` | verbindlicher GitOps-/No-Drift-Ablauf | | `REPO_MAP.md` | technische Landkarte des Repositories + Doku-Regeln |