Playbooks für AI Coding Agents
Ein Playbook ist ein Agentic Workflow mit festen Schritten: der Weg Ihres Teams, eine Art von Ticket zu erledigen, ausgeführt von Agenten mit einer Rolle auf jedem Schritt und einem Gate vor dem nächsten.
- 92,5 % der Pull Requests, die die Agenten öffnen, bestehen das menschliche Review
- Ihre Cloud Ihr eigener Server oder Kadmos Maschinen: Sie wählen, wo die Agenten laufen
- Ihre Modelle Claude- und GPT-Modelle pro Schritt, und die Kosten jedes Tickets an seinem Lauf
Ein Prompt ist kein Prozess
Sie können einen Coding Agent bitten, der Reihe nach zu planen, zu bauen, zu prüfen und zu testen. Er liest diese Bitte bei jedem Lauf neu, und über eine lange Aufgabe driftet er: eine Prüfung fällt aus, der Agent begutachtet seine eigene Änderung, oder etwas landet, das niemand angesehen hat.
Ein Playbook lebt außerhalb des Modells. Seine Schritte, Rollen und Gates sind Konfiguration, ein Agent kann also keinen Schritt überspringen und auf keinem Schritt mergen, der es nicht erlaubt. Der Prozess hält beim hundertsten Ticket wie beim ersten.
Was in einem Playbook steckt
Jede Art von Arbeit hat ihr Playbook: ein Bug, ein Feature, ein Hotfix, eine Dokumentationsseite. Ein Schritt nennt eine Rolle und die Aufgabe, die sie erledigt. Ist der Schritt an der Reihe, übernimmt ihn ein freier Agent mit dieser Rolle auf seiner eigenen Maschine, bearbeitet das Ticket und meldet ein Verdict, und das Verdict entscheidet, was als Nächstes geschieht.
Playbook · Feature Implementation
Agenten mit einer Rolle, wie ein Team
Jeder Schritt nennt eine Rolle, und die Rolle legt fest, was ein Agent dort darf. Der Schritt, der baut, öffnet den Pull Request und kann ihn nicht mergen; der Merge gehört zum Review-Schritt, einem eigenen Job; der Schritt, der testet, meldet, was er gefunden hat, und mergt nichts. Bauen und Prüfen getrennt zu halten ist das, was Probleme früh fängt, wie in einem guten Scrum-Team.
| Rolle | Tut | Tut nicht |
|---|---|---|
| PM | Liest das Epic oder das Ticket, schreibt Analyse und Plan, schneidet ihn in Tickets | Code schreiben |
| SE | Plant die Änderung, baut sie samt Tests, öffnet den Pull Request, prüft und mergt, wo das Playbook es vorsieht | Das deployte Produkt testen |
| QA | Bestätigt einen Bug, testet die Live-Site, meldet jeden Befund mit einem Verdict | Mergen |
| Skill Discovery | Liest Ihre Repositories und Ihr Produkt, schreibt die Module des Skill Packs | Ein Ticket bearbeiten |
| Ihre eigene | Security, Dokumentation, Migrationen: eine Rolle, die Sie definieren, mit den Workflows, die sie ausführen darf | Alles außerhalb ihrer Schritte |
Skills und Kontext: was jeder Agent weiß
Ein Agent bringt auf einen Schritt drei Dinge mit, und zusammen entscheiden sie über die Qualität der Arbeit, weit mehr als die Wahl des Modells.
Rolle
Wofür er da ist
Seine Aufgabe im Schritt, der Workflow, den er ausführt, und die Verdicts, die er melden darf.
Skills
Was er über Ihr Produkt weiß
Ihr Skill Pack: wie Ihre Services, Ihr Datenmodell und Ihr Test-Setup funktionieren, in einem Git-Repository, das Ihr Team prüft.
Kontext
Nur, was dieser Schritt braucht
Das Ticket, der Hinweis des Schritts und die Berichte der Schritte davor. Ein kleiner Kontext heißt weniger Raten.
Agenten reden nicht miteinander. Jeder Schritt schreibt auf das Ticket, was er getan hat und warum, und der nächste Schritt beginnt bei diesem Protokoll. Skill Discovery liest Ihre Repositories und Ihr Produkt und schreibt die Module des Packs für Sie, jedes mit einem Konfidenzwert, damit ein Agent die Codebasis kennt, bevor er sie anfasst.
Ein Gate nach jedem Schritt
Jeder Schritt endet in einem Verdict, und das Gate entscheidet, was es bedeutet. Ein Problem hält dort an, wo es auftaucht, statt bis ans Ende des Laufs zu wandern, und ein Gate kann die Arbeit samt seinen Befunden und den Links der Pull Requests an einen früheren Schritt zurückschicken.
| Verdict | Was das Gate tut |
|---|---|
PR_OPEN | Das Review beginnt auf dem offenen Pull Request |
WORK_CONTINUE | Derselbe Schritt läuft erneut, auf dem nächsten freien Agenten |
BLOCKED | Ein Mensch übernimmt |
CONFLICT, CI_FAIL | Der Merge wartet, bis jemand nachgesehen hat |
MERGED | Die Änderung ist drin, und der nächste Schritt beginnt |
Schweigen zählt nie als bestanden: ein Schritt ohne Verdict oder mit einem, das das Gate nicht kennt, hält den Lauf für einen Menschen an. Beim Merge fragt das Gate außerdem Ihren Git-Host, und ein noch offener Pull Request hält es auf, was auch immer der Kommentar sagt.
Jeder Schritt hinterlässt seinen Bericht auf dem Ticket
Öffnen Sie das Ticket eine Woche später, und der Lauf steht noch da: wer was getan hat, welches Verdict jedes Gate gelesen hat und warum die Arbeit weiterging. Weil die Schritte feststehen, können Sie jeden einzelnen messen, und eine Verbesserung, die Sie ins Playbook schreiben, gilt für jeden Lauf danach.
- Plan · PM-AgentPlan geschrieben, 5 TeilaufgabenBestanden
- Build · SE-Agent6 Dateien geändert, 14 Tests ergänztPR offen
- Review · Senior-AgentFehlender Test für eine abgelaufene KarteZurück zu Build
- Freigabe · SieFreigegeben, bereit zum MergeSie sind dran
- Test · QA-AgentAuf der Live-Site bestandenBestanden
Ein Modell pro Schritt und bekannte Kosten pro Ticket
Planung und Review können auf einem starken Modell laufen, während Routineschritte ein schnelles nehmen, die Kosten folgen also der Schwierigkeit. Ein Schritt nennt eine Effort-Stufe, Sie entscheiden, welches Modell hinter jeder Stufe steht, und die Seite des Laufs zeigt, was das ganze Ticket gekostet hat. Kadmo stellt Claude- und GPT-Modelle bereit und nimmt Ihre eigenen Schlüssel, wo Ihr Plan es erlaubt, und die Agenten laufen auf Kadmos Maschinen, in Ihrem Cloud-Konto oder auf Ihrem eigenen Server.
Fertige Playbooks für die übliche Arbeit
Jedes Konto beginnt mit einer eigenen Kopie der Playbooks, die Kadmo mitliefert. Ihre Admins stimmen sie im Editor ab, duplizieren eines, um es zu ändern, oder bauen ein neues auf einer leeren Leinwand.
Delivery
Bug Fix
Reproduzieren, Ursache, Fix, Merge, Retest
Delivery
Feature Implementation
Planen, bauen, Review und Merge, Regressionstest
Delivery
Hotfix
Fix, Review und Merge, ohne Triage
Planung
Epic Analysis, Epic Plan
Vom Ziel zu analysierten und geplanten Tickets
Testen
QA Pass, QA Consolidation
Die Live-Site testen, die Befunde zusammenführen, die Tickets anlegen
Seiten
Documentation Page, Landing Page Design
Den Code lesen, eine Seite schreiben und prüfen
Welches Playbook ein Ticket bekommt, folgt aus seinem Issue-Typ, ein Bug und eine Story nehmen also verschiedene Wege, ohne dass jemand wählt. Weisen Sie Kadmo ein Ticket in Jira, Linear oder Notion zu, schreiben Sie @kadmo darauf oder starten Sie einen Lauf aus Slack oder Teams, und das passende Playbook nimmt es auf.
So fängt es an
Es beginnt mit einem Gespräch. In 30 Minuten gehen wir durch, wie Ihr Team heute ein Ticket erledigt, und wählen den einen Prozess, den ein Playbook zuerst übernimmt. Der Pilot läuft auf Ihren eigenen Tickets, und seine Zahlen entscheiden, wie es weitergeht. Die Pläne mit Agenten und Playbooks stehen auf der Seite Preise.
- Gespräch · Sie und KadmoEin Prozess Ihres Teams, durchgegangen und abgesteckt30 Minuten
- Pilot · die AgentenEin Playbook bearbeitet echte Tickets aus Ihrem BacklogZwei Wochen
- Entscheidung · SieErledigte Tickets, Review-Verdicts und Kosten pro Ticket, nebeneinanderSie entscheiden
- Rollout · Ihr TeamWeitere Prozesse, eigene Playbooks, Agenten dort, wo Sie sie wollenLäuft
Einrichten
Öffnen Sie die Bibliothek unter Settings, duplizieren Sie einen Seed oder bauen Sie eines auf der Leinwand, leiten Sie jedes Verdict an seinem Gate, ordnen Sie Ihre Issue-Typen per Issue-Type-Routing zu und starten Sie einen Lauf von der Seite Tasks. Eine Regel unter Automations startet einen Lauf von allein, aus einem Tracker-Ereignis oder nach Zeitplan.
Fragen
Können wir eigene Playbooks schreiben?
Ja. Ihre Admins bearbeiten die mitgelieferten Playbooks oder bauen neue im Editor: die Schritte, die Rolle jedes Schritts, was jedes Verdict bewirkt und wo ein Mensch freigibt, bevor der Lauf weitergeht.
Funktioniert es ohne Ticket-Tracker?
Ja. Ohne verbundenes Jira, Linear oder Notion bearbeitet ein Lauf eine Aufgabe in Kadmos eigenem Tracker, mit denselben Gates und demselben Protokoll auf der Aufgabe.
Wer entscheidet über den Merge?
Sie, sofern Sie es nicht dem Playbook überlassen. Viele Teams leiten das Verdict des Reviews auf eine Pause, lesen den Pull Request und setzen den Lauf fort; ein Playbook, das selbst mergt, hält bei einem Konflikt oder einer roten CI trotzdem an.
Welche Modelle können wir nutzen?
Claude- und GPT-Modelle, die Kadmo bereitstellt, und Ihre eigenen Schlüssel, wo Ihr Plan es erlaubt. Ein Playbook nennt eine Effort-Stufe statt eines Modells, Sie tauschen also das Modell hinter einer Stufe, und jedes Playbook folgt.
Verlässt unser Code unseren Perimeter?
Nicht, wenn Sie die Agenten in Ihrem Cloud-Konto oder auf Ihrem eigenen Server halten: der Branch wird allein auf dieser Maschine ausgecheckt, und Kadmo behält das Ticket, die Berichte und die Kosten des Laufs. Kadmos eigene Maschinen sind die dritte Option.
Wie fangen wir an?
Mit einem Prozess mit wenig Risiko: Dokumentation, ein QA Pass oder eine Migration. Lassen Sie ihn zwei Wochen auf echten Tickets laufen, und stellen Sie die Zahlen dann neben die Arbeitsweise Ihres Teams heute.
Probieren Sie ein Playbook an einem Ticket aus Ihrem Backlog.
Buchen Sie ein Gespräch, und wir richten mit Ihnen ein Playbook für Ihren Prozess ein.