Grok Build – Der umfassende Praxisleitfaden

Titel: Grok Build – Der umfassende Praxisleitfaden. Der Coding-Agent von xAI richtig einsetzen

Praxisbuch (Deutsch) über Grok Build: den Coding-Agenten von xAI/SpaceXAI – interaktive TUI, Headless/CI, ACP und die Steuerknöpfe drumherum (Plan Mode, Subagents, Worktrees, AGENTS.md, Skills, MCP, Permissions). Stand der Fakten: Juli–Aug 2026 (CLI 0.2.x).

Stil: klar, unaufgeregt, praxisnah – analog zum Schwesterprojekt ../ki-claude (Der Claude-Code-Harness). Kein Marketing, keine leeren Versprechen. Konzepte → Sessions → nachbaubare Configs.

Schwerpunkt: 70–75 % praktische Verwendung.

---

Für wen

Stufe	Kapitel	Fokus
Einstieg	00, 01	Lesevertrag, Modell vs. Harness, Surfaces
Setup & Alltag	02, 03	Install, Auth, TUI, Shortcuts, Modes
Kern-Workflows	04 … 07	Plan Mode, Subagents, Worktrees, AGENTS.md
Erweiterbarkeit	08, 09	Skills, Plugins, Hooks, MCP
Automation	10, 11	Headless, CI, ACP/IDE
Steuerung	12 … 14	Memory, Permissions, Sandbox, Config
Praxis & Nachschlagen	15 … 18	Use-Cases, Best Practices, Vergleich, Cheatsheets

Einstieg für alle: 00-vorwort.md.

---

Lesepfad (empfohlen)

1. Vorwort – für wen, Konventionen, Lesevertrag
2. Einführung – Harness-Mentalmodell, Surfaces, Grenzen
3. Installation – installieren, anmelden, erste sichere Aufgaben
4. TUI – Scrollback, Prompt, Modes, Slash-Commands
5. Plan Mode – Plan → kommentieren → freigeben → implementieren
6. Subagents & Worktrees – parallel und isoliert arbeiten
7. AGENTS.md – Projektregeln, die Sessions überleben
8. Skills / MCP – Erweiterbarkeit ohne Chaos
9. Headless / ACP – CI, Scripting, IDE
10. Memory, Permissions, Config – Kontext und Sicherheit steuern
11. Use-Cases – durchgängige Produktions-Workflows
12. Best Practices & Anhang – Troubleshooting und Schnellreferenz

Du darfst springen. Die Kapitel sind so geschrieben, dass Querverweise greifen, ohne dass du alles linear gelesen haben musst.

Anfänger-Lesepfad (erste Session ~90–120 Min., dann Woche 1): Vorwort → 01 skimmen → 02 (mit beispiele/todo-cli) → 03 nur Day-1-Cockpit → diese Woche 04 + 07 minimal. Details im Vorwort.

---

Verzeichnisstruktur

ki-grok/
├── README.md
├── AGENTS.md                 # Prinzipien für Agents (Autoren-Harness)
├── CLAUDE.md                 # operativer Kompass (Build, Layout, Do/Don’t)
├── ADAPTIONEN.md             # Übernahmen aus ../ki-claude
├── abbildungen.md            # Inventar + Captions der Illustrationen
├── prompts/gemini/           # Gemini/Imagen-Prompts (KEY/MUST/SHOULD/NICE + Cover)
├── .grok/                    # Grok: rules, skills, slash-commands
├── 00-vorwort.md
├── 01-einfuehrung-und-philosophie.md
├── …                         # 02–18 Kapitelquellen
├── 18-anhang-schnellreferenz.md
├── assets/                   # cover/ + illustrations/ (JPG nach Generierung)
├── vorlagen/                 # kopierfertige Configs (für Leser)
├── beispiele/                # Mitmach-Material (für Leser)
├── pdf/, scripts/, justfile  # PDF-Pipeline
└── .gitignore

Illustrationen: Katalog und Workflow in abbildungen.md; Prompts in prompts/gemini/.

---

Vorlagen und Beispiele

Pfad	Inhalt
vorlagen/AGENTS.md.minimal.md	Minimale Projekt-AGENTS.md
vorlagen/AGENTS.md.team.md	Team-Baseline-AGENTS.md
vorlagen/config.toml.beispiel.toml	User/Project-Config-Ausschnitte
vorlagen/config.permissions.toml	[permission] Allow/Deny-Minimum
vorlagen/config.mcp.toml	MCP-Server-Skizzen ([mcp_servers.*])
vorlagen/PLAN.md.skeleton.md	Plan-Mode-Skeleton
vorlagen/hooks/	Hook-JSON + Scripts (Guard, Format)
vorlagen/skills/, vorlagen/agents/, vorlagen/plugins/	Verify-Skill, Security-Agent, Plugin-Baseline
vorlagen/user/	Persönliche User-AGENTS-Skizze
beispiele/	Index der Mitmach-Beispiele
beispiele/todo-cli/	Mini-Python-CLI inkl. AGENTS.md und .grok/-Harness
beispiele/configs/	GHA-Review, Project-Config, MCP-Snippets

---

Konventionen im Text

• Jetzt selbst machen: Übungen, die du im Terminal nachvollziehst (PDF: teal-Callout)
• Kern in einem Satz / Kern: Kapitel- oder Abschnittsthese (PDF: navy-Callout)
• Achtung: echte Risiken – Secrets, Prod, Always-approve, destruktive Shell (PDF: burgundy; sparsam)
• Was du jetzt kannst / Nächste Schritte: Abschluss jedes größeren Abschnitts
• Wie & Warum: Tabellen und Configs sind eingerahmt – Mechanik und Begründung
• Code und Shell: fenced Blocks mit Sprach-Tag
• Platzhalter: YOUR_TOKEN, your-project, xai-… – nie echte Secrets

---

Quellen und Aktualität

Primärquelle: Grok-Build-User-Guide (lokal unter ~/.grok/docs/user-guide/) und die CLI-Hilfe.
Installationswege, Config-Keys und Slash-Commands können sich mit Releases ändern. Bei Abweichungen gilt die aktuelle Doku; dieses Buch nennt den Stand Juli–Aug 2026 und erklärt die stabilen Konzepte dahinter.

Übernahmen aus dem Claude-Code-Schwesterprojekt: ADAPTIONEN.md.

---

PDF bauen

Pipeline analog zu ../ki-claude: just + pandoc + lualatex + KOMA-Template.

Voraussetzungen: pandoc, just, TeX Live (LuaLaTeX, KOMA-Script scrbook), Fonts Charter + DejaVu (eBook), TeX Gyre Heros (Print), optional Pillow.

just pdf        # → dist/grok-build-praxisleitfaden.pdf (A4 eBook)
just pdf-print  # → dist/grok-build-praxisleitfaden-print.pdf (KDP 6×9 Grayscale)
just qa         # eBook-Checks
just qa-print   # Print-Checks (6×9, Gray-Stage)
just all        # pdf + qa
just all-print  # pdf-print + qa-print
just clean

Weitere Targets: just pdf-draft, just pdf-plain, just assemble.

00–18-*.md  →  scripts/assemble_book.py  →  build/book.md
                                              ↓ pandoc + template
                                         dist/*.pdf  (eBook und/oder Print)

Weiterarbeiten am Projekt (Autoren-Harness)

Datei / Ordner	Rolle
AGENTS.md	Prinzipien, Dateirollen, Qualitätsregeln
CLAUDE.md	Build/QA, Layout, Agent notes
ADAPTIONEN.md	Schwesterprojekt-Mapping
.grok/	rules, skills (pdf-bauen, pdf-print, lektorat, …), commands

Autoren-Harness (Root) steuert Agents, die am Buch arbeiten. vorlagen/ und beispiele/ sind Content für Leser des Buchs.

Typischer Mitautor-Workflow: Kapitel editieren → bei Bedarf just pdf && just qa (bzw. Print) → Lektorat/Review über Skills bzw. Grok-Commands (/pdf, /pdf-print, /lektorat, /review, /status).