ki-eit/16-anhang-c-agent-mapping.md

Anhang C — Agent-Mapping und Transfer

Stand: Manuskript-Snapshot August 2026. Pfade und Produktnamen sind Muster — sie driften; die Jobs dahinter (weich vs. hart, eine Wahrheit, DoD-Command) bleiben. Kein Feature-Ranking, keine Parallel-Vollbeispiele. Kern-Surfaces dieses Buchs: GitHub Copilot, Claude Code, Codex, Grok Build. Templates unter templates/ sind Inhaltsvorlagen der Jobs (Kap. 4 und 10).

C.1 Wozu dieses Mapping

Die Prinzipien (These 7 invers, Vertical Slices, DoD, Progressive Disclosure, Soft vs. Hard) sind tool-unabhängig. Die Repo-Wahrheit lebt in AGENTS.md/Verify-Commands; produktspezifische Dateien sind Surfaces für dieselben Jobs.

Wer einen anderen (oder gemischten) Harness fährt, braucht keine zweite Buch-Auflage — sondern die Abbildung:

Job im Repo  →  Convention-Datei / Surface eures Agents

C.2 Mapping-Tabelle (Jobs → Surfaces)

Zeilen = mappbare Surface-Jobs, abgeleitet aus den sechs Harness-Komponenten in Kap. 2.2.1 (Instructions, Tools & Permissions, Context-Assembly, Agent-Loop, Memory/Handoff, Verify). Skills erscheinen hier als eigene Zeile, weil sie eigene Dateien/Surfaces haben. Agent-Loop ist Laufzeitverhalten (Observations, Tool-Runden) — typisch ohne Convention-Datei und deshalb nicht tabelliert. Context-Assembly und Memory/Handoff sind in der Zeile Context / Memory zusammengezogen (Surfaces oft dieselben Dateien). Spalten = typische Orte, nicht ein Vollkatalog aller Flags. Produkt-Doku schlägt diese Snapshot-Zeile bei Drift.

Zwei Teiltabellen (je Job + drei bzw. vier Surfaces), damit der Satzspiegel — besonders Print 6×9 — lesbar bleibt. Inhalt ist derselbe wie in einer einzigen Matrix; es gibt kein Feature-Ranking.

Teil 1 — Kern-Surfaces

Job	GitHub Copilot	Claude Code	Codex	Grok Build
Instructions	.github/copilot-instructions.md; path-instructions (applyTo); Package-AGENTS.md	CLAUDE.md (+ lokale/path Rules laut Doku)	AGENTS.md / projektspezifische Conventions (laut Doku)	AGENTS.md; .grok/rules/; ggf. User-Prefs
Tools / Permissions	Tool-Approval; Allow/Deny; Settings (kein YOLO-Default)	Permission Modes; Sandbox / Approval	Shell- und Policy-Grenzen (laut Doku)	Capability modes; Approval
Skills / Commands	Skills (SKILL.md); Custom Prompts	Skills; Slash-Commands	Custom prompts / Commands (laut Doku)	.grok/skills/; Slash-Commands
Context / Memory	Instructions + Session; Compact+Hint; Handoff	CLAUDE.md + Session-Memory	AGENTS.md + Session	Handoff; Compact; Session-Rituale
Verify / DoD	Commands in Instructions/AGENTS.md; Verify-Skills; CI-Mirror; optional Hooks	Hooks / Stop-Conditions + Repo-Commands	Commands in Conventions + CI	Verify-Skills; Session-DoD

Teil 2 — Weitere Surfaces

Job	Cursor	OpenCode	Aider
Instructions	.cursor/rules (Project Rules)	AGENTS.md / projektspezifische Convention-Dateien	CONVENTIONS.md; .aider.conf.yml; Editor-Notes
Tools / Permissions	Auto-run / restriktive Settings	Sandbox / Tool-Policies (produktspezifisch)	Shell- und Commit-Grenzen
Skills / Commands	Rules; Commands / Notepads	Skills / Plugins (sofern vorhanden)	Custom commands / aliases
Context / Memory	Rules + @-Context	AGENTS.md + Session	Repo-Map + Chat-History
Verify / DoD	Rules + Terminal + CI	Commands in Conventions + CI	Test-Cmd in Config + CI

C.3 Wie du Golden Paths und DoD auf deinen Agent überträgst

Checkliste (Reihenfolge absichtlich):

1. Repo-Wahrheit zuerst — Runtime-Pin, Tight-Loop · Slice-DoD · Heavy, non-interactive Exit-Codes (Kap. 4, 9). Unabhängig vom Agent.
2. DoD benennen — derselbe Command-Name in Task-Prompt, Convention-Datei und Review.
3. Weiches Memory schichten — Root kurz (Mission, Runtime, Verify-Übersicht, Immer/Nie); Package detailliert (Stil, Commands, Golden Paths). Progressive Disclosure (Kap. 10).
4. Golden Path verlinken — Referenz-Feature und „Nie“-Liste in die Convention-Datei eures Agents, nicht nur ins Wiki.
5. Hart begrenzen — Permissions enger als menschliche Bequemlichkeit; kein YOLO als Team-Default (Kap. 12).
6. Verify anbinden — Skill, Hook oder wiederholbarer Command, den der Agent ausführen und am Exit-Code erkennen kann.
7. Teach-back — wiederkehrende Fehler am selben Tag in die Convention/Skill-Datei schreiben (eigene kurze Session).
8. Templates als Inhaltsquelle — Inhalt der Jobs aus templates/ übernehmen; Dateinamen an euren Harness anpassen (nicht 1:1 kopieren und hoffen).

C.4 Typische Stolperfallen

Falle	Besser
Surface-Datei 1:1 zwischen Agents kopieren und erwarten, dass alles greift	Jobs mappen (Root/Package/path/Verify); Discovery-Regeln des Ziel-Harness lesen
Alles in eine 500-Zeilen-Root-Datei	Progressive Disclosure beibehalten
DoD nur im Chat formulieren	Command im Repo + in der Convention verlinken
Permissions „machen wir später“	hart vor dem ersten Shared-Repo-YOLO
Zwei Wahrheiten (Wiki vs. Agent-File vs. CI)	eine Wahrheit; Agent-File spiegelt CI
Zehn Skills vor dem ersten grünen Verify	erst Tight-Loop grün, dann Katalog wachsen lassen
Feature-Vergleich statt Prozess	Prozess (Slice, DoD, Review-Budget) schlägt Tool-Features

C.5 Was dieses Buch bewusst nicht liefert

• Parallel-Templates für jeden Harness
• CLI-Flag-Referenzen und Screenshot-Touren (→ aktuelle Produkt-Doku; optional Der Copilot-CLI-Harness nur für Copilot)
• Ranking „Agent A vs. Agent B“
• Spekulation über Features nach dem Snapshot-Datum

C.6 Mini-Lesepfad (Surfaces mappen)

1. Kap. 1.3 + Kap. 2 (mentales Modell, These 7 invers)
2. Kap. 4 + 9 (eine Wahrheit, DoD-Ebenen)
3. Kap. 10 (Hierarchie der Jobs) + dieser Anhang
4. Templates unter templates/ als Inhaltsvorlage mappen
5. Optional: Framework-Kapitel 5–7, Slices 8, Security 12

Zurück zum Body: Kap. 2.2.1 (Komponenten), Kap. 4.4 (Instructions), Kap. 10.7 (Transfer-Kurzverweis).