ki-copilot/abbildungen.md

Abbildungen — Katalog und Specs

Buch: Der Copilot-CLI-Harness
Stand: 2026-08-02
Status:

• Phase A (Body): 12 Konzept-Illustrationen unter assets/illustrations/, im Manuskript eingebettet. Gemini-Prompts (EN, Copilot-Terminologie) unter prompts/gemini/.
• Phase B (Body): 10 Konzept-Figuren unter assets/illustrations/, im Manuskript eingebettet. Gemini-Prompts unter prompts/gemini/.
• SCREEN (P0): 8 Terminal-Screendumps unter assets/screenshots/, im Manuskript eingebettet (Stand 2026-07-30). Pipeline: scripts/screenshots/.

Quelle Phase A: Schwesterprojekt ../ki-claude (Konzept-Figuren); Labels auf Copilot-Terminologie; Prompts neu in prompts/gemini/ (EN, grafisch spezifiziert).
Quelle Phase B: neu spezifiziert für Copilot-CLI-Gelenke (Surfaces, Instructions-Discovery, Modes, Fleet, Delegate, CI).
Quelle SCREEN: Hybrid — live copilot -p / Datei-Auszug wo möglich; Trust/Ask/Plan/Flags didaktisch rekonstruiert (kein Pixel-TUI-Capture).

Nicht Konzept-Imagen: Screendumps (Terminal-Frames), Cover (eigener Track).

Platzhalter-Pfade: assets/illustrations/<ID>.jpg · assets/screenshots/SD-….png.
Einbettung: ![Caption.](assets/illustrations/<datei>.jpg){width=80%} (Einleitung) bzw. {width=90%} (übrige Kapitel). Screendumps: {width=90%}.
Prompts: Block --- PROMPT START --- … --- PROMPT END --- in der jeweiligen .txt kopieren → Gemini / Imagen.

---

Inventar Phase A (Body)

ID	Titel	Kapitel	Prompt	Asset	Edit	Body
S-01	Lesepfad / Stufen	00	prompts/gemini/should/S-01-learning-path-four-stages.txt	S-01-lesepfad-stufen.jpg	Labels: Instructions	ja
K-01	Modell vs. Harness	00	prompts/gemini/key/K-01-model-vs-harness.txt	K-01-modell-vs-harness.jpg	CLAUDE.md → instructions	ja
K-03	Agent-Tool-Loop	00	prompts/gemini/key/K-03-agent-tool-loop.txt	K-03-agent-tool-loop.jpg	Context-Stack: instructions	ja
M-01	Trusted Directory / Workspace Trust	01	prompts/gemini/must/M-01-workspace-trust-first-door.txt	M-01-workspace-trust.jpg	— (generisch)	ja
M-02	Permissions: Allow / Ask / Deny	01	prompts/gemini/must/M-02-permissions-allow-deny-ask.txt	M-02-permissions-allow-deny-ask.jpg	— (generisch)	ja
K-06	Weich vs. hart	02	prompts/gemini/key/K-06-soft-vs-hard-control.txt	K-06-weich-vs-hart.jpg	Station 1: Instructions	ja
K-04	Explore → Plan → Code → Verify → Commit	03	prompts/gemini/key/K-04-explore-plan-code-verify-commit.txt	K-04-explore-plan-code-verify-commit.jpg	— (generisch)	ja
K-05	Settings-Hierarchie	04	prompts/gemini/key/K-05-configuration-hierarchy.txt	K-05-konfigurationshierarchie.jpg	Copilot-Reihenfolge im Prompt; Text = Kanon	ja
M-05	MCP: Client, Server, Tools	05	prompts/gemini/must/M-05-mcp-client-server-tools.txt	M-05-mcp-client-server-tools.jpg	Host: Copilot CLI	ja
M-06	Skills vs. Hooks	05	prompts/gemini/must/M-06-skills-vs-hooks.txt	M-06-skills-vs-hooks.jpg	Anti-pattern: instructions novel	ja
M-07	Kontextfenster: Startlast vs. Session	07	prompts/gemini/must/M-07-context-window-start-vs-session.txt	M-07-kontextfenster.jpg	Base: Instructions	ja
S-07	Compact ist verlustbehaftet	07	prompts/gemini/should/S-07-compact-is-lossy.txt	S-07-compact-verlustbehaftet.jpg	Disk: instructions.md	ja

---

Inventar Phase B (Body)

Prio	ID	Titel	Kapitel	Prompt	Ziel-Asset	Body
P0	K-02	Surfaces: one engine, many surfaces	00	prompts/gemini/key/K-02-surfaces-one-engine-many-surfaces.txt	K-02-surfaces-eine-engine.jpg	ja
P0	M-03	Instructions as always-on compass	02	prompts/gemini/must/M-03-instructions-always-on-compass.txt	M-03-instructions-compass.jpg	ja
P0	M-04	Two files, two jobs	02	prompts/gemini/must/M-04-two-files-two-jobs.txt	M-04-zwei-dateien-zwei-rollen.jpg	ja
P0	S-02	Instruction discovery map	02	prompts/gemini/should/S-02-instruction-discovery-map.txt	S-02-instruction-discovery.jpg	ja
P1	K-09	Plan · Autopilot · Fleet	03	prompts/gemini/key/K-09-plan-autopilot-fleet.txt	K-09-plan-autopilot-fleet.jpg	ja
P1	K-10	Local session vs /delegate	03/06	prompts/gemini/key/K-10-local-session-vs-delegate.txt	K-10-local-vs-delegate.jpg	ja
P1	K-13	Fleet: parallel subagents	05	prompts/gemini/key/K-13-fleet-parallel-subagents.txt	K-13-fleet-parallel.jpg	ja
P1	S-05	Subagents as context vent	05	prompts/gemini/should/S-05-subagents-as-context-vent.txt	S-05-subagents-kontext-ventil.jpg	ja
P1	S-06	Team policy stack + CI review	06	prompts/gemini/should/S-06-team-policy-stack-ci-review.txt	S-06-team-policy-stack-ci.jpg	ja
P1	K-14	CI programmatic copilot -p	06	prompts/gemini/key/K-14-ci-programmatic-copilot-p.txt	K-14-ci-programmatic.jpg	ja

Generier-Reihenfolge: KEY (K-02, K-09, K-10, K-13, K-14) → MUST (M-03, M-04) → SHOULD (S-02, S-05, S-06). Details: prompts/gemini/README.md.

---

Mapping (früherer Copilot-Katalog → Asset / Prompt)

Früher (Katalog)	Asset / Prompt	Status
S-01 Lesepfad	S-01-lesepfad-stufen.jpg	im Body
K-01 Modell vs. Harness	K-01-modell-vs-harness.jpg	im Body
K-02 Agent-Schleife	K-03-agent-tool-loop.jpg	im Body (Claude-ID K-03)
K-03 Surfaces	K-02-surfaces-eine-engine.jpg	im Body
K-04 Trusted directory	M-01-workspace-trust.jpg	im Body
K-05 Permission-Prompt	M-02-permissions-allow-deny-ask.jpg	im Body
K-06 Weich vs. hart	K-06-weich-vs-hart.jpg	im Body
K-07 Instruction-Discovery	S-02 (+ M-03/M-04)	im Body
K-08 EPCC	K-04-explore-plan-code-verify-commit.jpg	im Body
K-09 Plan Mode	K-09-plan-autopilot-fleet.jpg	im Body
K-10 Local vs. /delegate	K-10-local-vs-delegate.jpg	im Body
K-11 Settings-Hierarchie	K-05-konfigurationshierarchie.jpg	im Body
K-12 Customization-Härtegrade	K-06 / M-06 / M-04	im Body
K-13 Fleet	K-13-fleet-parallel.jpg	im Body
K-14 CI programmatic	K-14 (+ S-06)	im Body
K-15 Context / Compact	M-07 + S-07	im Body

---

Captions (kanonisch, DE)

Phase A (Body)

ID	Caption
S-01	Vier Stufen, ein Buch — springen erlaubt, Querverweise greifen.
K-01	Das Modell schlägt vor; der Harness prüft, führt aus und speist Ergebnisse zurück.
K-03	Jede „Handlung“ ist ein freigegebener Tool-Call – nicht Magie.
M-01	Trust ist die grobe Tür — Permissions greifen erst danach.
M-02	Bei Shell-Befehlen, die du nicht liest: Deny und nachfragen.
K-06	Je härter die Anforderung, desto weiter rechts: Markdown bittet, Hooks erzwingen.
K-04	Phasengrenzen sind billige Sicherungspunkte — Fehler akkumulieren in langen Ketten.
K-05	Settings-Schichten und Merge: Deny hat Vorrang vor Allow.
M-05	MCP ist zusätzliche Tool-Oberfläche — nicht außerhalb der Permissions.
M-06	Prozeduren → Skills. Unverhandelbares → Hooks (oder deny).
M-07	Was im Fenster liegt, steuert Qualität und Kosten — nicht Eloquenz.
S-07	Compact spart Fenster — Dateien retten Entscheidungen.

Phase B (Body)

ID	Caption
K-02	Dieselbe Engine — Terminal, Programmatic, Cloud, IDE. Config und Permissions reisen mit.
M-03	Was du jedes Mal sagen müsstest, gehört in Instructions — kurz und konkret.
M-04	Sollte nicht → Instructions. Darf nicht → deny oder Hook.
S-02	Mehrere Orte, ein Mechanismus — kombinieren, nicht „gewinnen“.
K-09	Drei Steuerungsmodi — Plan bremst, Autopilot läuft, Fleet parallelisiert.
K-10	Lokal steuern vs. Cloud Agent + PR — Ownership bleibt menschlich.
K-13	Unabhängige Teilaufgaben parallel — Credits multiplizieren.
S-05	Der Roh-Leseberg bleibt draußen — nur die Zusammenfassung kehrt zurück.
S-06	Policies auf dem Laptop, Review in CI, Merge durch Menschen.
K-14	Enger Prompt, Allow/Deny, kein Auto-Merge.

---

Spec-Notizen

• Stil: klar, didaktisch, flat vector + soft depth; Navy/Cyan/Violet (Schwesterprojekt + _global-style.txt)
• Labels in den Bildern: kurze englische Keywords; Captions deutsch
• Keine Screenshots mit echten Secrets, Orgs oder privaten Repos
• UI-Labels nur, wenn sie der aktuellen Doku entsprechen; sonst abstrahieren
• K-05: Abbildung zeigt die Idee von Schichten und „deny beats allow“; die Copilot-Reihenfolge steht in Kap. 4 im Text (Defaults → MDM → User → Repo → Local → Env → Flags)
• S-02 vs. K-05: Instruction-Discovery kombiniert (keine generelle Precedence); Settings-Hierarchie ist ein anderes Modell

Kapitel-Einbindung

![Kurzbeschreibung.](assets/illustrations/K-01-modell-vs-harness.jpg){width=80%}

Vorgeschlagene Anker für Phase B (nach Asset):

ID	Kapitel-Anker (Textstelle)
K-02	00-einleitung.md — #surfaces
M-03 / M-04 / S-02	02-grundlagen-und-konfiguration.md — 2.1–2.2
K-09	03-alltag-und-workflows.md — 3.3–3.4
K-10	03-alltag-und-workflows.md — 3.10
K-13 / S-05	05-mcp-skills-hooks-agents-plugins.md — 5.5–5.6
S-06 / K-14	06-teams-enterprise-ci.md — 6.4 ff.

---

SCREEN — P0 Minimalpaket (Body)

Leitprinzip: Diagramm = warum; Screendump = wo liest du / was bestätigst du.
Zielpfad: assets/screenshots/ · Pipeline: scripts/screenshots/README.md.
Paarung: bestehende Konzept-Illustration behalten; Screendump danach an der Szene.

ID	Titel	Kapitel	Asset	Quelle	Body
SD-01	Workspace Trust	01	SD-01-workspace-trust.png	rekonstruiert	ja (1.4)
SD-02	Permission-Ask (Shell)	01	SD-02-permission-ask-shell.png	rekonstruiert	ja (1.6)
SD-03	Erste Session: Read-only erklären	01	SD-03-session-readonly-explain.png	live copilot -p	ja (1.5 A)
SD-04	Instructions / Settings-Quellen	02	SD-04-instructions-sources.png	live Datei-Auszug	ja (2.1)
SD-05	Plan Mode / freigeben	03	SD-05-plan-approve.png	rekonstruiert	ja (3.3)
SD-06	Edit + Diff	01	SD-06-edit-diff.png	live + git diff	ja (1.5 B)
SD-07	Enge Permissions (Flags)	02	SD-07-enge-permissions.png	rekonstruiert	ja (2.x Permissions)
SD-08	Programmatic copilot -p	06	SD-08-ci-copilot-p.png	live copilot -p	ja (6.4)

Captions (SCREEN, DE)

ID	Caption
SD-01	Trust ist die grobe Tür: ohne Zustimmung keine Tools in diesem Ordner. (GitHub Copilot CLI; Labels können driften.)
SD-02	Bei Shell-Befehlen, die du nicht liest: No — und nachfragen. (GitHub Copilot CLI; Labels können driften.)
SD-03	Erklären ohne Schreiben: lesende Tools und eine Antwort — noch kein Diff. (Stand Mitte/Ende 2026.)
SD-04	Was die Session mitbringt: Instructions, Settings, AGENTS — im Repo sichtbar. (todo-cli; Stand Mitte/Ende 2026.)
SD-05	Plan freigeben, dann Code — Phasengrenze spart Scope-Creep. (GitHub Copilot CLI; Labels können driften.)
SD-06	Erst den Diff lesen — „fertig“ heißt nicht „richtig“. (Stand Mitte/Ende 2026.)
SD-07	Enge Allowlist + Deny vor YOLO: Deny hat Vorrang. (Flags; Stand Mitte/Ende 2026.)
SD-08	Enger Prompt, Deny write, kein Auto-Merge — CI-tauglich. (programmatic -p; Stand Mitte/Ende 2026.)

Capture

just screenshot-auto          # SD-03/04/06/08 live
just screenshot-all           # + rekonstruierte Frames SD-01/02/05/07

---

Folge-Tasks

1. Phase B generieren + einbetten — erledigt (Assets + Body, 2026-07-30)
2. Screendumps Copilot CLI (P0 Minimalpaket) — erledigt (Assets + Body, 2026-07-30)
3. Phase-A Gemini-Prompts (EN) — erledigt (prompts/gemini/, 2026-08-02)
4. Phase-B Gemini-Prompts auf Premium-Niveau — erledigt (analog Phase A, 2026-08-02)
5. Optional: Assets mit neuen/verbesserten Prompts neu rendern (Gemini) und per update-pics ersetzen
6. Optional P1: /context, /compact, Hook greift, MCP-Status
7. Optional Phase C: S-03 path-scoped spotlight, N-02 Kostenhebel, N-03 Teiltrenner, Cover
8. Optional: Quell-PNGs unter bilder/ ablegen (wie Schwesterprojekt)