Projekte · coding-agents-praxis · Hilfe
Letzte Prüfung: 2026-11-07 · companion-0.1.6
Symptom → 2–3 Sätze Lösung → Buchkapitel und Material. Kein Ersatz für Diff-Review und eure Tool-Doku – sondern der schnelle Einstieg.
Immer zuerst: Context eng halten, DoD agent-prüfbar formulieren, Diff lesen. UI-Labels und Slash-Commands können je Tool abweichen – Buch-Konzept bleibt gültig, Syntax der aktuellen Tool-Doku folgen.
Sofort: Trigger sind Muster im Transkript (Wiederhol-Reads, Log-Wände, Scope-Drift), nicht ein Gefühl. Dann eine Aktion: Compact mit Hint, oder Handoff und neue Session — nicht noch mehr Dateien dumpen.
Buch-Konzept bleibt gültig. Context is King; mehr Kontext ist nicht automatisch besser.
Buch: Kap. 3, Kap. 4 ·
Material: templates/compaction-hints.md, templates/handoff-template.md
Sofort: Eine Aktion, nicht alle. Gleicher Task, Context noch scharf → Compact mit Hint. Stand muss überleben → Progress oder Handoff. Themen-, Task- oder Rot-Grenze → Handoff und neue Session. Compact verdichtet vorwärts; Restore holt im selben Thread zurück — das ist kein Git-Reset.
Buch-Konzept bleibt gültig. Drei Jobs, drei Lebensdauern; der Agent wählt eine.
Buch: Kap. 4 ·
Material: Compaction-Hints, Handoff-Template, AGENTS.md-Beispiele (A.4)
Sofort: DoD so formulieren, dass der Agent sie selbst ermitteln kann (idealerweise per Command: Tests, Lint, Build). „Sieht gut aus“ ist keine DoD.
Buch-Konzept bleibt gültig. Ohne agent-verifizierbare DoD kein sinnvoller Autonomie-Loop.
Buch: Kap. 10, Kap. 14 ·
Material: templates/task-prompt-template.md,
templates/dod-bibliothek.md,
checklists/review-agent-diff.md
Sofort: Slice verkleinern (vertikal, end-to-end dünn). Ausschlüsse und „nicht anfassen“ explizit machen. Diff lesen – Surgical Changes erzwingen.
Buch-Konzept bleibt gültig. Komplexität klein; Karpathy: Simplicity + Surgical.
Buch: Kap. 8, Kap. 12, Kap. 13 · Checkliste: Anti-Pattern-Vermeidung
AGENTS.md greift nicht oder widerspricht sich
Sofort: Datei schlank halten, widersprüchliche Regeln aufräumen,
Scope (Root vs. Package) prüfen. AGENTS.md ist weiches Memory – keine harte Sandbox/Policy.
Buch-Konzept bleibt gültig. These 9: Aufräumen und Konsistenz sind kritisch.
Buch: Kap. 6, Kap. 9, Kap. 12 ·
Material: templates/agents-md-beispiel.md (Monorepo-Varianten)
Sofort: Progressive Disclosure: nur bei Bedarf und in der richtigen Flughöhe. Skills ≠ MCP ≠ Karpathy-Skills. Multi-Agent erst mit Ownership, DoD und Hand-back.
Buch-Konzept bleibt gültig. Isolation und Verträge vor Parallel-Write.
Buch: Kap. 5.6/5.7, Kap. 16, Kap. 17, Kap. 22 · Checkliste: Anti-Pattern (Ownership vor Parallel-Write)
Sofort: In eurem Tool /-Menü, Status und Help prüfen.
Die Phase (Plan, Compact, Review, …) zählt – nicht der exakte String im Buch.
Buch-Konzept bleibt gültig. Harness-Steuerung vs. „Modell umstimmen“.
Buch: Kap. 2, Kap. 15 · Stand: Drift-Liste
Sofort: In einen bekannten Arbeitsordner entpacken, 1–2 Templates kopieren und anpassen, Session-Start-Checkliste einmal durchgehen. PDF/Kapitelquellen sind nicht in den ZIPs.
Buch-Konzept bleibt gültig. Hybrid: Anhang A im Buch + lebende ZIPs hier.
Material: Vorlagen & Checklisten
Sofort: Stack-Orientierung (Anhang B) für euren Anwendungsfall prüfen. Bei freier Wahl: Kombinationen mit hoher Agent-Zuverlässigkeit und Wartbarkeit bevorzugen. Bei erzwungenem Stack (Enterprise, Legacy): engere Slices, mehr Docs im Repo, härtere DoD — nicht „mehr Prompt“.
Buch-Konzept bleibt gültig. These 7: Trainingsdaten-Präsenz ist Proxy, kein Freibrief; Context und Verify bleiben entscheidend.
Buch: Kap. 15, Anhang B ·
Material:
stack-orientierung.md
Sofort: Review-Checkliste durchgehen. Soft-DoD (menschliches Urteil, Taste) ist kein Orakel — Accept-and-Forget ist die teure Variante von „grün = aligned“.
Buch-Konzept bleibt gültig. Agent-prüfbare DoD und Human-Gate sind verschiedene Schichten.
Buch: Kap. 11, Kap. 18, Kap. 19 ·
Material: checklists/review-agent-diff.md,
templates/dod-bibliothek.md
Anti-Pattern-Katalog und Templates im Buch (Kap. 19), dann Feedback mit Kapitel/Seite und kurzer Symptom-Beschreibung.