grok-bot
96fa0b5e93
Tighten header clearance (headsep 0.12″) and print toc-depth 1, refresh docs/handoff, and rebuild the 6×9 grayscale interior.
Der Codex-Harness
Titel: Der Codex-Harness – AGENTS.md, Sandbox, MCP und Workflows in der Praxis
Praxisbuch (Deutsch) über OpenAI Codex: ein allgemeiner Coding-Agent in Terminal, IDE, ChatGPT App/Web und Cloud – und der Harness, mit dem du ihn steuerst (Tools, Approvals, Sandbox, AGENTS.md, Sessions, CI/Cloud). Stand der Fakten: Mitte/Ende 2026.
Stil: klar, unaufgeregt, praxisnah. Kein Marketing, keine leeren Versprechen. Konzepte → Beispiele → nachbaubare Configs. Eigenständig und ohne Feature-Vergleichskapitel zu anderen Coding-Agents (kurze, faire Einordnung in Kap. 7.9).
Für wen
| Stufe | Kapitel | Fokus |
|---|---|---|
| Tag-1-Einstieg | 01 | Installation, Project Trust, erste Session, Sicherheit |
| Einsteiger | 02, 03 | AGENTS.md, Sandbox/Approvals, Explore–Plan–Code–Verify–Commit |
| Fortgeschrittene | 04, 05 | Config-Hierarchie, MCP, Skills, Hooks, Subagents, Plugins |
| Experten & Teams | 06, 07 | CI, Cloud, Enterprise, Context/Sessions, Troubleshooting, kritische Einordnung |
| Nachschlagewerk | 08, 09 | Cheatsheets, Glossar; stabile Kernvorlagen (Anhang A) |
Einstieg für alle: 00-einleitung.md. Kapitel 1–3 reichen für den produktiven Alltag; 4–6 bei konkretem Schmerz.
Lesepfad (empfohlen)
Zielgruppe: Entwickler mit Terminal-Basics (cd, Dateien lesen; für Übungen Python-venv). Kein reines Non-Coder-Buch.
- Einleitung – Modell vs. Harness, Agent-Schleife, Lesevertrag oder zuerst Kap. 1
- Tag-1 – installieren, todo-cli, Approvals, Diff
- Grundlagen – AGENTS.md (weich) und Sandbox/Approvals (hart)
- Alltag – Plan, Review, Git – hier darfst du wochenlang bleiben
- Fortgeschritten – Config-Hierarchie, Profiles, Rules, multi-repo
- Erweiterungen – MCP / Skills / Hooks / Subagents / Plugins
- Teams & CI – Baseline, non-interactive, Cloud, Compliance-Orientierung
- Best Practices – Context, Sessions, Symptom→Fix, kritische Einordnung
- Anhang – Cheatsheets (Kap. 8) und stabile Kernvorlagen (Anhang A / Kap. 9)
Kapitel (Einzeiler)
| Datei | Inhalt |
|---|---|
| 00-einleitung.md | Allgemeiner Coding-Agent; Modell vs. Harness; Agent-Schleife; Lesepfade |
| 01-laien-einstieg.md | Install, Auth, Project Trust, erste Übungen am todo-cli |
| 02-grundlagen-und-konfiguration.md | AGENTS.md und Sandbox/Approvals (weich vs. hart) |
| 03-alltag-und-workflows.md | Plan, Diff, Review, Git-Alltag, Modelle |
| 04-fortgeschrittene-konfiguration.md | Config-Hierarchie, Profiles, Rules, Trust, Sessions |
| 05-mcp-skills-hooks-agents-plugins.md | Erweiterbarkeit und Härtegrade |
| 06-teams-enterprise-ci.md | Team-Baseline, CI, Cloud, Compliance |
| 07-best-practices-troubleshooting.md | Context, Sessions, Symptom→Fix, Doku-Drift, Grenzen & Trade-offs |
| 08-anhang-cheatsheets.md | Flags, Pfade, Patterns, Vorlagen-Index, Glossar |
| 09-anhang-a-kernvorlagen.md | Stabile Kernvorlagen im PDF (Hybrid: Buch-Minima + Online-ZIPs) |
Verzeichnisstruktur
ki-codex/
├── README.md
├── AGENTS.md # Regeln für Agents am Buch (Autoren-Harness)
├── .grok/ # Grok: rules, skills, slash-commands
├── 00-einleitung.md … 09-anhang-a-kernvorlagen.md
├── abbildungen.md # Bildkatalog (Konzept + SCREEN)
├── assets/illustrations/ # Konzept-Figuren für PDF
├── assets/screenshots/ # Terminal-Screendumps
├── scripts/screenshots/ # Capture-Pipeline
├── vorlagen/ # kopierfertig für Leser
├── beispiele/
│ ├── todo-cli/ # Mitmach-Mini-Projekt
│ └── configs/ # config.toml + CI-Gerüst
├── prompts/ # Autoren-Prompts (nicht Manuskript)
├── research/ # Autoren-Research (nicht Manuskript)
├── justfile # assemble / pdf / qa
├── scripts/
└── pdf/
Vorlagen und Beispiele
Hybrid: Im PDF liefert Anhang A die stabilen Kernvorlagen. Vollständige und laufend aktualisierte Materialien liegen im Begleit-Service (versionierte ZIPs).
Begleit-Service: https://books.maatini.space/projects/codex-harness/ — Stand & Drift, Errata, Material, Schnelle Hilfe, Feedback.
| Pfad | Inhalt |
|---|---|
vorlagen/AGENTS.md.minimal.md |
Minimale Repo-AGENTS.md |
vorlagen/AGENTS.md.team.md |
Team-Baseline |
vorlagen/config.permissions.toml |
Sandbox + Approvals |
vorlagen/skills/verify/SKILL.md |
Verify-Skill |
vorlagen/PLAN.md.skeleton.md |
Feature-Plan-Skeleton |
beispiele/todo-cli/ |
Mini-Python-CLI inkl. AGENTS.md |
beispiele/configs/ |
Repo-Config + GitHub-Actions-Gerüst |
Konventionen im Text
- Jetzt selbst machen: Übungen im Terminal
- Kern in einem Satz / Kern: Abschnittsthese
- Achtung: echte Risiken (Trust, Secrets, Full Access, CI-Rechte) – sparsam
- Was du jetzt kannst / Nächste Schritte: Abschluss größerer Abschnitte
- Platzhalter:
YOUR_TOKEN,your-org/your-repo– nie echte Secrets
Build (optional)
Voraussetzungen: just, pandoc, TeX Live (LuaLaTeX, KOMA scrbook), Fonts je nach Template.
just assemble # Kapitel → build/book.md
just pdf # → dist/codex-harness.pdf
just qa # Keyword-/Struktur-Checks
just clean
Quellen
Primär: Codex Docs · Produkt: openai.com/codex
Bei Abweichung zwischen Buch und Doku: Konzept behalten, Syntax der Doku (Lesevertrag in Kapitel 00 und Drift-Vorgehen in Kapitel 07).
Autoren-Material (nicht im PDF-Manuskript)
prompts/buch-erstellung-codex.md– Erstellungsauftragresearch/codex-achsen.md– interne Achsen (nicht als Kapitel übernehmen)AGENTS.md– Regeln für Agents, die am Buch arbeiten.grok/– Grok Build: rules, skills, commands
Typischer Mitautor-Workflow: Kapitel editieren → bei Bedarf just pdf && just qa → Lektorat/Review über Skills bzw. Grok-Commands (/pdf, /lektorat, /review, /status).