UAE: AE-41 A, VPN-130/142/166/243/245 ein Name je Sache

2026-11-02 17:12:39 +01:00
1 parent 416420f1d2
commit 6acc6853c2
@@ -44,7 +44,7 @@
    Obsolete Dateien, widersprüchliche Regeln, Context-Reste.

 13. [Karpathy-Skills und Fokus](manuskript/kapitel-13-karpathy-skills-und-fokus.md)  
-    Think, Simplicity, Surgical, Goal-Driven — und wie man sie erzwingt.
+    Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution — und wie man sie erzwingt.

 14. [Effektive Aufgabenformulierung](manuskript/kapitel-14-effektive-aufgabenformulierung.md)  
    Ziel + Nebenbedingungen + Ausschlüsse + DoD.
@@ -102,7 +102,7 @@ Kernbegriffe der ersten Kapitel — Vertiefung am genannten Ort:
 | **DoD / Orakel** | Fertigstellung, die der Agent selbst prüfen kann — Command, Exit-Code, Contract (Kap. 10) |
 | **Vertikaler Slice** | Dünner End-to-End-Schnitt mit früher DoD (Kap. 8) |
 | **Explore → Plan → Execute → Verify → Commit** | Default-Ablauf; Verify vor Commit (Kap. 7) |
-| **Karpathy-Skills** | Fokus-Zwang: Think, Simplicity, Surgical, Goal — keine Skill-Dateien (Kap. 13) |
+| **Karpathy-Skills** | Fokus-Zwang: Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution — keine Skill-Dateien (Kap. 13) |
 | **`AGENTS.md`** | Weiches Projekt-Memory; Dateiname je Tool kosmetisch (Kap. 15) |

 Weitere Begriffe (Hand-back, Knowledge Layer, Model Routing, Agent Skills, MCP, Alignment) im jeweiligen Kapitel.
@@ -102,7 +102,7 @@ Der Agent ist mächtiger **und** anfälliger für Context Rot, weil Tool-Outputs

 Nicht alles, was den Agent steuert, steht im aktuellen User-Prompt. Persistente Anweisungen sind Harness-Konfiguration in Prosa: sie kommen bei jedem relevanten Lauf wieder — oder vergiften jeden Lauf, wenn sie veraltet sind.

-**`AGENTS.md` / `CLAUDE.md` / `.cursor/rules/*.mdc`** tragen Projektrichtlinie: Stack, Verify, Verbote, Review. **Agent Skills** (portable `SKILL.md`-Pakete, Kap. 16) bündeln Prozeduren — „wie wir PR reviewen“, „wie wir migrieren“ — statt Chat-Folklore. Das sind **nicht** die Karpathy-Skills (Kap. 13: Think / Simple / Surgical / Goal) — dort Fokus-Haltung, hier kodierte Prozeduren. **Hooks und Formatters** erledigen Nachbearbeitung, damit weniger manuell nachgezogen wird.
+**`AGENTS.md` / `CLAUDE.md` / `.cursor/rules/*.mdc`** tragen Projektrichtlinie: Stack, Verify, Verbote, Review. **Agent Skills** (portable `SKILL.md`-Pakete, Kap. 16) bündeln Prozeduren — „wie wir PR reviewen“, „wie wir migrieren“ — statt Chat-Folklore. Das sind **nicht** die Karpathy-Skills (Kap. 13: Think Before Coding / Simplicity First / Surgical Changes / Goal-Driven Execution) — dort Fokus-Haltung, hier kodierte Prozeduren. **Hooks und Formatters** erledigen Nachbearbeitung, damit weniger manuell nachgezogen wird.

 Der häufigste Fehler: historische Essay-Sammlungen, die sich selbst widersprechen. Eine Regel von 2024, ein Skill vom letzten Quartal, ein Kommentar von heute früh — drei Wahrheiten. Wenige, aktuelle, widerspruchsfreie Regeln schlagen lange Archive (These 9). Ausgangspunkt: **Anhang A** · `templates/agents-md-beispiel.md`.

@@ -87,7 +87,7 @@ Bei Risiko zusätzlich Teach-back: Ziel, Ausschlüsse, Invariante, DoD in eigene
 **Prompt (User → Agent):**

 ```markdown
-Nur Slice 1 des freigegebenen Plans. Surgical.
+Nur Slice 1 des freigegebenen Plans. Surgical Changes.
 Nach dem Patch: vereinbartes Verify-Subset.
 Weiche nicht ab: bei Drift stoppen, nicht mitziehen.
 ```
@@ -275,7 +275,7 @@ Fehlt Punkt 2 bei multi-file: nicht mergen, Alignment nachholen.
 |-------|----------------|-------------|
 | Explore | Datei-Dumps | Budget, gezielte Reads |
 | Plan | lange Debatten | Zeitbox, dann Compact |
-| Execute | Patch-Irrwege | Surgical, Zwischen-Verify |
+| Execute | Patch-Irrwege | Surgical Changes, Zwischen-Verify |
 | Verify | Log-Novellen | Fehlerausschnitt behalten |
 | Commit | gering | Message kurz, weiter sauber |

@@ -77,7 +77,7 @@ Manchmal ist „Map the payment flow and write HANDOFF“ der erste Slice — oh
 | 2 | Fehlerpfade (404, Auth-Kante) | Integrationstests Fehlercodes |
 | 3 | Button in Detail-UI | E2E oder Component-Test; nur dieser Button |

-Default ist der dünnste nutzbare Pfad (Walking Skeleton, 8.4). **RAF** — Renderer/Adapter plus Contract-Test *ohne* HTTP — nur wenn Library oder Layout die riskanteste Annahme ist: dann als gekennzeichneter Minipfad *vor* Slice 1, nicht als Default-Slice-1.
+Default ist der dünnste nutzbare Pfad (Walking Skeleton, 8.4). Ein **Renderer/Adapter-Schnitt mit Contract-Test *ohne* HTTP** lohnt nur, wenn Library oder Layout die riskanteste Annahme ist: dann als gekennzeichneter Minipfad *vor* Slice 1, nicht als Default-Slice-1.

 **Avoid that:** Ein Prompt „PDF export complete with UI and email and storage and virus scan“. Spätere Slices gehören in die **Ausschlüsse** von Slice 1 — nicht in denselben Context als „optional mitmachen, wenn du Zeit hast“. Was nicht ausgeschlossen ist, wird der Agent oft „freundlich“ mitziehen — und der Diff explodiert.

@@ -152,7 +152,7 @@ Monorepo (oder ein klares App-Repo)
  + scoped Verify (affected / filter)
 ```

-| Form | Agent-Tauglichkeit | Typische Falle |
+| Form | Eignung für Agenten | Typische Falle |
 |------|--------------------|----------------|
 | **Modularer Monolith** (Packages/Module; eine Deploy-Unit oder wenige) | hoch: ein Graph, atomare Diffs, Types+Tests sichtbar | Boundaries nur im Diagramm |
 | **Big Ball of Mud** (ein Repo, keine Module) | niedrig: Scope-Explosion | „Monorepo = fertig“ |
@@ -235,7 +235,7 @@ Der Alignment-Block sitzt im Task-Template (**Anhang A** · `templates/task-prom
 Manchmal paraphrasiert der Agent ewig und ändert nichts. Dann greifen Zeitbox und DoD:

 - „Plan in 5 Bullets, dann Execute ohne weitere Rückfragen außer Contract-Break.“  
- DoD schärfen, damit Goal-Driven greift ([Kap. 13](kapitel-13-karpathy-skills-und-fokus.md))  
+- DoD schärfen, damit Goal-Driven Execution greift ([Kap. 13](kapitel-13-karpathy-skills-und-fokus.md))  
 - Explore-Budget begrenzen  

 Alignment ohne Lieferdruck wird zur Endlosschleife. Alignment mit klarer Messlatte wird zum Hebel.
@@ -79,7 +79,7 @@ Finde potentiell obsolete Dateien/Rules (old, bak, duplicate utils).
 Ändere noch nichts. Liste mit Begründung und Risiko.
 ```

-Löschen und große Moves brauchen expliziten Auftrag, Surgical Changes und Tests danach — keine spekulativen Massen-Deletes. Sonst wird „Aufräumen“ zum größten Diff des Quartals und zum klassischen Surgical-Verstoß ([Kap. 13](kapitel-13-karpathy-skills-und-fokus.md)).
+Löschen und große Moves brauchen expliziten Auftrag, Surgical Changes und Tests danach — keine spekulativen Massen-Deletes. Sonst wird „Aufräumen“ zum größten Diff des Quartals und zum klassischen Verstoß gegen Surgical Changes ([Kap. 13](kapitel-13-karpathy-skills-und-fokus.md)).

 ## 12.5 „Broken Windows“ und Agent-Verhalten

@@ -4,7 +4,7 @@ Der Agent ist hilfreich, vollständig und beschäftigt. Genau das wird im Coding

 > **These 8:** Erzwingt fokussiertes Arbeiten mit den **Karpathy-Skills**.

-> **Achtung:** **Karpathy-Skills** (dieses Kapitel) sind vier *Haltungsprinzipien* — Think, Simple, Surgical, Goal. **Agent Skills** ([Kap. 16](kapitel-16-agent-skills-wiederverwendbare-expertise.md)) sind portable *Prozedur-Pakete* (`SKILL.md` + optional Ressourcen). Nicht verwechseln: Prinzipien erzwingen Fokus; Agent Skills standardisieren Workflows.
+> **Achtung:** **Karpathy-Skills** (dieses Kapitel) sind vier *Haltungsprinzipien* — Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution. **Agent Skills** ([Kap. 16](kapitel-16-agent-skills-wiederverwendbare-expertise.md)) sind portable *Prozedur-Pakete* (`SKILL.md` + optional Ressourcen). Nicht verwechseln: Prinzipien erzwingen Fokus; Agent Skills standardisieren Workflows.

 Die vier Skills:

@@ -13,7 +13,7 @@ Die vier Skills:
 3. **Surgical Changes**  
 4. **Goal-Driven Execution**

-![Think · Simple · Surgical · Goal-Driven — Fokus erzwingen, nicht hoffen.](../assets/illustrations/M-07-karpathy-skills.jpg){width=90%}
+![Think Before Coding · Simplicity First · Surgical Changes · Goal-Driven Execution — Fokus erzwingen, nicht hoffen.](../assets/illustrations/M-07-karpathy-skills.jpg){width=90%}

 ## 13.1 Warum Agents diese Skills besonders brauchen

@@ -104,7 +104,7 @@ Surgical Changes schützen Review, Blame und den Context: weniger Tool-Noise, we
 - Bei Blockade: stoppen, Handoff, nicht Chaos-Expandieren.
 ```

-Das ist die operative Form von These 4 (Kap. 10). Ohne Goal-Driven wird Autonomie zu Beschäftigungstherapie mit Side Effects.
+Das ist die operative Form von These 4 (Kap. 10). Ohne Goal-Driven Execution wird Autonomie zu Beschäftigungstherapie mit Side Effects.

 ## 13.6 Alle vier zusammen {.unnumbered .unlisted}

@@ -115,7 +115,7 @@ Surgical Changes        → richtiger Diff-Umfang
 Goal-Driven Execution   → richtiger Stopp
 ```

-Fehlt einer, kompensiert der Agent mit den Pathologien der anderen. Think ohne Surgical endet in gründlichem Chaos. Surgical ohne Goal endet in sauberen Halbfertigkeiten. Simple ohne Think endet in der eleganten Lösung am falschen Ort. Die vier Skills sind deshalb kein Menü — sie sind ein Satz.
+Fehlt einer, kompensiert der Agent mit den Pathologien der anderen. Think Before Coding ohne Surgical Changes endet in gründlichem Chaos. Surgical Changes ohne Goal-Driven Execution endet in sauberen Halbfertigkeiten. Simplicity First ohne Think Before Coding endet in der eleganten Lösung am falschen Ort. Die vier Skills sind deshalb kein Menü — sie sind ein Satz.

 ## 13.7 Enforcement-Schichten {.unnumbered .unlisted}

@@ -159,10 +159,10 @@ Fokus ist Context-Management mit Verhaltensregeln. Wer Context eng hält (Kap. 3

 | Anti-Pattern | Skill-Verstoß |
 |--------------|----------------|
-| „Ich räume gleich mit auf“ | Surgical / Goal |
-| Framework für einen Case | Simplicity |
-| Patch ohne Grep | Think |
-| Done ohne Test | Goal-Driven |
+| „Ich räume gleich mit auf“ | Surgical Changes / Goal-Driven Execution |
+| Framework für einen Case | Simplicity First |
+| Patch ohne Grep | Think Before Coding |
+| Done ohne Test | Goal-Driven Execution |
 | Karpathy-Block als toter Essay in AGENTS.md | (These 9 / Kap. 12) — durchsetzen oder streichen |

 Der letzte Punkt gehört zu Kap. 12: unverbindliche Fokus-Regeln sind Schrott mit Autoritätsanspruch. Kurz halten, greifen lassen — oder streichen.
@@ -170,7 +170,7 @@ Der letzte Punkt gehört zu Kap. 12: unverbindliche Fokus-Regeln sind Schrott mi
 ---

 ## Key Takeaways {.unnumbered .unlisted}
- Karpathy-Skills erzwingen Fokus: Think, Simple, Surgical, Goal.
+- Karpathy-Skills erzwingen Fokus: Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution.
 - Enforcement über Prompt *und* Review, nicht über Poster.
 - Regeln kurz und verbindlich halten — sonst werden sie selbst Schrott (Kap. 12).
 - Nicht mit Agent Skills (Kap. 16) verwechseln.
@@ -70,7 +70,7 @@ Nachschlagewerk generischer Hebel (Claude Code, Cursor, Codex, Aider, Grok Build
 | **Compact/Summarize + Hint** | Proaktiv, mit Erhaltungs-Hint (**Anhang A** · `templates/compaction-hints.md`) |
 | **Restore / Checkpoint** | Letzte Turns zurück: Gespräch und/oder Working Tree; nicht Compact, nicht Git-History (Kap. 4.2) |
 | **AGENTS.md / Project Rules** | Persistente Richtlinie inkl. Context-Regeln |
-| **Karpathy-Block in Rules** | Think / Simple / Surgical / Goal in `AGENTS.md` erzwingen |
+| **Karpathy-Block in Rules** | Think Before Coding / Simplicity First / Surgical Changes / Goal-Driven Execution in `AGENTS.md` erzwingen |
 | **Agent Skills (`SKILL.md`)** | Team-Workflows on-demand (Kap. 16) — Prozedur, nicht Richtlinie |
 | **Sub-Agents / Isolation** | Experimente nicht im Haupt-Context vermischen; Hand-back-Vertrag |
 | **Model Routing / Modell-Tiers** | Default ≠ Max; Latenz und Kosten mitsteuern (Kap. 5.7) |
@@ -1,6 +1,6 @@
 # 16. Agent Skills: Wiederverwendbare Expertise für zuverlässige Coding-Agents

-Karpathy-Skills (Kap. 13) sind **Haltung**: Think, Simple, Surgical, Goal. Montagmorgen reviewt A den PR mit einem Prompt aus den Notes, B sagt nur „review das“, C startet denselben Skill `code-review` wie letzte Woche. A und B driften. C liefert dieselbe Prüfliste, dieselben DoD-Haken, dieselben Verbote. Dieses Kapitel geht von der Haltung zum **portablen Paket**: Agent Skills machen aus „so arbeiten wir hier“ ein versionierbares, on-demand ladbares Modul.
+Karpathy-Skills (Kap. 13) sind **Haltung**: Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution. Montagmorgen reviewt A den PR mit einem Prompt aus den Notes, B sagt nur „review das“, C startet denselben Skill `code-review` wie letzte Woche. A und B driften. C liefert dieselbe Prüfliste, dieselben DoD-Haken, dieselben Verbote. Dieses Kapitel geht von der Haltung zum **portablen Paket**: Agent Skills machen aus „so arbeiten wir hier“ ein versionierbares, on-demand ladbares Modul.

 > **Leitsatz:** Ein Skill ist wiederverwendbare Expertise im Repo — nicht ein längerer Prompt und nicht ein weiteres Tool. Metadata bleibt billig im Context; die Prozedur kommt erst, wenn der Anlass passt — These 3 in der Skill-Form (Kanon [Kap. 3](kapitel-03-kontext-ist-koenig.md)).

@@ -285,7 +285,7 @@ description: >
 Framework-Handbuch nicht hier — README / `references/` on-demand.
 ```

-Red vor Green ist nachprüfbar. Goal-Driven sitzt in der Reihenfolge.
+Red vor Green ist nachprüfbar. Goal-Driven Execution sitzt in der Reihenfolge.

 ### Security-Pass

@@ -412,7 +412,7 @@ Skills sind das *Wie*; [Kap. 17](kapitel-17-mcp-server.md) oft die *Hände* (MCP
 - [ ] Ein klarer Anlass; Description nennt Was **und** Wann (Trigger-Wörter)  
 - [ ] Schritte sind vom Agent ausführbar (Tools/Commands real)  
 - [ ] DoD mit mindestens einem verifizierbaren Command oder Check  
- [ ] Verbote/Scope gesetzt (Surgical, Secrets, Git-Risiken)  
+- [ ] Verbote/Scope gesetzt (Surgical Changes, Secrets, Git-Risiken)  
 - [ ] `SKILL.md` schlank; Details in `references/` falls nötig  
 - [ ] Kein Widerspruch zu `AGENTS.md` / anderen Skills  
 - [ ] Keine Secrets; Platzhalter statt Credentials  
@@ -52,7 +52,7 @@ Wenn du nur *eine* Tabelle aus dem Kapitel neben den Monitor hängst, dann diese
 | Handoff vor Reset | Amnesie-Session |
 | Ziel + Nebenbedingungen + Ausschlüsse + DoD | Nur Jira-Titel oder Step-Diktat |
 | Vertikale Slices, Stop-Regeln | Big-Bang-Epic, Endlos-Loops |
-| Think / Simple / Surgical / Goal-Driven | Sofort patchen, Framework für einen Case |
+| Think Before Coding / Simplicity First / Surgical Changes / Goal-Driven Execution | Sofort patchen, Framework für einen Case |
 | Diff lesen, Verify = Commands | Accept-All, „Done“ ohne Check |
 | Eine Wahrheit in Rules | Essay-Archäologie, Widersprüche |

@@ -98,7 +98,7 @@ POST /api/export liefert CSV der letzten 30 Tage für den eingeloggten User.
 ## Nebenbedingungen
 - Bestehende Auth-Middleware wiederverwenden
 - Keine neue Dependency
- Surgical: nur export-Pfad + Tests
+- Surgical Changes: nur export-Pfad + Tests

 ## Ausschlüsse
 - Kein Excel, kein Admin-UI, kein Refactor von billing/
@@ -224,7 +224,7 @@ Agents schreiben flüssigen, „kompletten“ Code. Das ist nicht dasselbe wie *

 Symptomatic Fixes entstehen, wenn Explore übersprungen wird: `null`-Check hier, `try/catch` dort — der eigentliche Vertragsbruch bleibt.

-**Do this instead:** Think Before Coding + Goal-Driven: Repro-Test zuerst (wenn sinnvoll), dann minimaler Fix, dann Verify.
+**Do this instead:** Think Before Coding + Goal-Driven Execution: Repro-Test zuerst (wenn sinnvoll), dann minimaler Fix, dann Verify.

 ---

@@ -329,7 +329,7 @@ Katalog allein ändert nichts — der nächste Prompt schon. Die Bausteine liege
 |-------|-----|
 | Vague + Step-Over-Spec | **Anhang A** · `templates/task-prompt-template.md` |
 | Unbounded Loops | Stop-Regel in 10.8; DoD-Bibliothek **A.7** |
-| Surgical / Simplicity | Karpathy-Block in [Kap. 13](kapitel-13-karpathy-skills-und-fokus.md) |
+| Surgical Changes / Simplicity First | Karpathy-Block in [Kap. 13](kapitel-13-karpathy-skills-und-fokus.md) |
 | Accept-and-Forget / Review ohne Substanz | `checklists/review-agent-diff.md` + Ritual 19.4; Alltag **A.6** |
 | Soft-DoD / Human-Gate vermischt | Checkliste 19.4 + A.7 Human-Gate-Block |
 | Compact / Handoff | **Anhang A** · `templates/compaction-hints.md`, `templates/handoff-template.md` |
@@ -15,7 +15,7 @@ Neun Hebel, ein Betriebssystem (Karte in Kap. 1, Lehre in den Vertiefungen):
 5. **Ziel + Nebenbedingungen + Ausschlüsse** — nicht Micro-Management.  
 6. **Vertikale Slices** — Komplexität bewusst klein.  
 7. **Trainingsnahe Stacks** — wo Agent-Hebel zählt ([Anhang B](kapitel-24-anhang-b-stack-orientierung.md)).  
-8. **Karpathy-Skills** — Think, Simple, Surgical, Goal.  
+8. **Karpathy-Skills** — Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution.  
 9. **Aufräumen & Konsistenz** — Müll ist Fehlinformation.  

 Drei Gewohnheiten tragen den Alltag: Context aktiv managen · jeden Task als prüfbaren Slice schneiden · Fertig = Verify, nicht Rhetorik.  
@@ -402,7 +402,7 @@ Gemeinsame **Priorität** mit 5.8: Hygiene → Isolation → Routing → Paralle
 | 2 Team-Standard | M2–M3 mit Templates |
 | 3–4 Systematisch / Produktisiert | M3–M4; Plattform, Eval, Guardrails |

-Low-Maturity-Repo ([Kap. 21](kapitel-21-low-maturity-legacy-greenfield.md)): **eine Stufe zurück**. Kein Spawn ohne Ownership und Worker-DoD. Strong begründen. Integration vor Celebration. Cleanup ist Teil der DoD.
+Low-Maturity-Repo ([Kap. 21](kapitel-21-low-maturity-legacy-greenfield.md)): **eine M-Stufe zurück**, höchstens **M1** — ein Explore-Sub read-only, kein paralleler Writer ([Kap. 21.2](kapitel-21-low-maturity-legacy-greenfield.md)). Kein Spawn ohne Ownership und Worker-DoD. Strong begründen. Integration vor Celebration. Cleanup ist Teil der DoD.

 ---