Files
ki-grok/abbildungen.md
grok-bot 80e5838432 Align illustration pipeline and add full body figure set.
Use bilder/ as the only drop zone (q90 convert), ship production
JPEGs for all catalog IDs including HTML-rendered S-02…S-07, and
trim redundant cover master from assets/cover.
2026-08-02 21:17:45 +02:00

5.7 KiB
Raw Permalink Blame History

Abbildungen und Gemini-Prompts

Buch: Grok Build – Der umfassende Praxisleitfaden
Stand: 2026-08-02
Zweck: Inventar sinnvoller Abbildungen mit didaktischem Anker und englischen Gemini-Prompts (print-tauglich).

Status (2026-08-02): Inventar + Prompt-Dateien + Manuskript-Einbettungen. Cover: assets/cover/COVER-01B-full.jpg (Master-Roh in bilder/COVER-01B-master.png, Drop-Zone gitignored). Body-Assets: alle 22 geplanten Figuren als JPEG q90 unter assets/illustrations/ (S-02…S-07 aus HTML-Render scripts/_fig_render/ → bilder/ → convert). Inventar-only (kein Body-Embed): K-03, N-01.

  • Im Body geplant: 22 Figuren (+ Cover).
  • Nur Inventar (nicht im Body): K-03 (Redundanz zu K-01), N-01 (NICE, Text reicht).
  • Landscape im Body: {width=90%} (Vorwort/Einführung: {width=80%}); N-03 Portrait: {width=55%}.
  • Copy-paste-Prompts: prompts/gemini/ — Cover + KEY/MUST/SHOULD/NICE.
  • Gesamtliste mit Vollprompts: prompts/gemini/LISTE.md (Übersicht + pro Figur Anker, Caption, Asset, englischer Gemini-Prompt, Render-Target).

Dieses Dokument ist die Source of Truth für Inventar, Captions und Didaktik.


Übersicht

Kategorie Bedeutung Anzahl (Inventar) Im Body
KEY Buch-Herzstück, mentale Modelle 6 5 (ohne K-03)
MUST Kapitel-Essenz 8 8
SHOULD starke Bereicherung 7 7
NICE optional 3 2 (ohne N-01)
Summe 24 22
ID Prio Kapitel Titel Orientierung Asset Body
COVER-01B Cover Titelseite Full book cover 2:3 assets/cover/COVER-01B-full.jpg Cover
K-01 KEY 01 Modell vs. Harness 16:9 assets/illustrations/K-01-modell-vs-harness.jpg ja
K-02 KEY 01 Surfaces: TUI / Headless / ACP 16:9 assets/illustrations/K-02-surfaces-eine-engine.jpg ja
K-03 KEY 01/03 Agent-Tool-Loop + Modes 16:9 assets/illustrations/K-03-agent-tool-loop.jpg nein
K-04 KEY 01/15 Explore → Plan → Code → Verify → Commit 16:9 assets/illustrations/K-04-explore-plan-code-verify-commit.jpg ja
K-05 KEY 08 Weich vs. hart steuern 16:9 assets/illustrations/K-05-weich-vs-hart.jpg ja
K-06 KEY 14 Konfigurations-Precedence 16:9 assets/illustrations/K-06-konfigurations-precedence.jpg ja
M-01 MUST 04 Plan Mode: Review → Approve 16:9 assets/illustrations/M-01-plan-mode-review-approve.jpg ja
M-02 MUST 13 Folder-Trust + Permission-Modes 16:9 assets/illustrations/M-02-folder-trust-permission-modes.jpg ja
M-03 MUST 07 AGENTS.md als Dauerlast / Kompass 16:9 assets/illustrations/M-03-agentsmd-dauerlast-kompass.jpg ja
M-04 MUST 07 Zwei Dateien, zwei Rollen 16:9 assets/illustrations/M-04-zwei-dateien-zwei-rollen.jpg ja
M-05 MUST 05 Subagents als Kontext-Ventil 16:9 assets/illustrations/M-05-subagents-kontext-ventil.jpg ja
M-06 MUST 06 Worktrees: Datei-Isolation 16:9 assets/illustrations/M-06-worktrees-datei-isolation.jpg ja
M-07 MUST 08 Skills vs. Hooks vs. Plugins 16:9 assets/illustrations/M-07-skills-vs-hooks.jpg ja
M-08 MUST 09 MCP: Client, Server, Tools 16:9 assets/illustrations/M-08-mcp-client-server-tools.jpg ja
S-01 SHOULD 00 Lesepfad / Stufen 16:9 assets/illustrations/S-01-lesepfad-stufen.jpg ja
S-02 SHOULD 07 Nested AGENTS.md / Discovery 16:9 assets/illustrations/S-02-nested-agentsmd-discovery.jpg ja
S-03 SHOULD 07 Path-scoped Rules 16:9 assets/illustrations/S-03-path-scoped-rules.jpg ja
S-04 SHOULD 06 Parallel Sessions / Worktrees 16:9 assets/illustrations/S-04-parallel-sessions-worktrees.jpg ja
S-05 SHOULD 13 Autorisierungs-Pipeline 16:9 assets/illustrations/S-05-autorisierungs-pipeline.jpg ja
S-06 SHOULD 10 Headless / CI + Team-Policy 16:9 assets/illustrations/S-06-headless-ci-team-policy.jpg ja
S-07 SHOULD 12 Compact ist verlustbehaftet 16:9 assets/illustrations/S-07-compact-verlustbehaftet.jpg ja
N-01 NICE 16 Vorher/Nachher-Prompt 16:9 assets/illustrations/N-01-vorher-nachher-prompt.jpg nein
N-02 NICE 12 Kosten- und Kontexthebel 16:9 assets/illustrations/N-02-kosten-kontexthebel.jpg ja
N-03 NICE 00 Harness, nicht Zauberei 3:4 assets/illustrations/N-03-harness-nicht-zauberei.jpg ja

Empfohlene Generier-Reihenfolge: Cover-01A → KEY → MUST → SHOULD → NICE.


Globaler Style

Siehe prompts/gemini/_global-style.txt. Kurz:

  • Night navy / cyan / soft violet; flat vector + soft 3D
  • Minimale englische Labels; Captions im Buch deutsch
  • Keine Brand-Logos; print + Grayscale-tauglich
  • Buchtitel im Prompt-Kontext: Grok Build Practice Guide (nie Claude-Harness)

Einbettung im Manuskript

![Caption DE.](assets/illustrations/K-01-modell-vs-harness.jpg){width=90%}
Kapitel Figuren
00 S-01, N-03
01 K-01, K-02, K-04
04 M-01
05 M-05
06 M-06, S-04
07 M-03, M-04, S-02, S-03
08 K-05, M-07
09 M-08
10 S-06
12 S-07, N-02
13 M-02, S-05
14 K-06

Pflege

  1. Neue Figur: Prompt unter prompts/gemini/ + Zeile hier + scripts/convert_illustrations.py + optional Body-Embed.
  2. Caption-Änderungen: hier und im Markdown-![…] synchron.
  3. Nach Asset-Drop: just pdf und visuelle QA (keine Gibberish-Labels, keine Logos).