ki-grok/CLAUDE.md

CLAUDE.md — Grok Build Praxisleitfaden (Buch-Repo)

This file provides guidance to Claude Code (and compatible agents) when working in this repository.

Dies ist ein deutschsprachiges Praxisbuch über Grok Build – kein App-Stack. Prinzipien und Qualitätsregeln: AGENTS.md. Adaptionen aus den Schwesterprojekten (ki-claude, ki-codex): ADAPTIONEN.md.

Build & QA

just assemble    # Kapitel → build/book.md
just pdf         # → dist/grok-build-praxisleitfaden.pdf (A4 eBook)
just pdf-draft   # Draft mit Wasserzeichen
just pdf-plain   # ohne gestyltes Template
just pdf-print   # KDP Interior 6×9 Grayscale → dist/…-print.pdf
just qa          # PDF-Checks eBook (Seiten, Keywords, Fonts)
just qa-print    # PDF-Checks Print (6×9, Gray-Stage)
just all         # pdf + qa
just all-print   # pdf-print + qa-print
just clean

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

PDF nur bauen, wenn der Task es verlangt. Nach dem Build bei Bedarf just qa bzw. just qa-print.

Layout (Source of Truth)

Pfad	Inhalt
00-vorwort.md … 18-anhang-schnellreferenz.md	Kapitel (kanonisch)
vorlagen/	kopierfertige Configs für Leser
beispiele/	Mitmach-Beispiele
pdf/, scripts/, justfile	PDF-Pipeline
assets/	Bilder für PDF
.grok/	Autoren-Harness (Agents am Buch)

Conventions

• Deutsch im Manuskript; Produktnamen/Pfade original (AGENTS.md, config.toml, grok).
• Callouts nicht umformatieren:
  • > **Kern in einem Satz:** … / > **Kern:** …
  • > **Achtung:** … (sparsam)
  • **Jetzt selbst machen** für Übungen
• Kapitel-Abschluss wo vorgesehen: Was du jetzt kannst / Nächste Schritte.
• Keine Secrets; Platzhalter YOUR_TOKEN.
• Beispiele und Terminal-Sessions lauffähig und kommentiert halten.
• 70–75 % Praxis-Fokus; kein Claude-Code-Jargon in Grok-Kapiteln mischen.

Agent notes

• Bei Unklarheit: nachfragen statt raten. Fakten: ~/.grok/docs/user-guide/ + dieses Repo.
• Stand der Fakten im Buch: Juli–Aug 2026 (CLI 0.2.x) – UI-Labels können driften.
• Chirurgische Edits: nur Task-relevante Stellen; Ton „erfahrener Kollege“.
• Keine erfundenen npm/poetry/React-Stacks für dieses Repo.
• pdf/templates/*, pdf/filters/*, pdf/styles/* nur bei explizitem Auftrag.
• Plan vor größeren Mehrdatei-Änderungen; Erfolgskriterien prüfbar formulieren.
• Details: .grok/rules/; Skills: pdf-bauen, pdf-print, lektorat, kapitel-review, humanizer, update-pics.