fable-it — Autonomer Lieferungs-Orchestrator
Sorge dafür, dass sich dein Modell wie Fable verhält. Du übergibst fable-it ein Ziel und eine nummerierte Definition of Done (DoD); es führt den gesamten Job bis zur Fertigstellung aus – typischerweise unbeaufsichtigt über Nacht – und hinterlässt einen ehrlichen, evidenzgestützten Bericht. Diese Datei ist die portable Verhaltensebene: alles unten ist host-agnostische Mechanik, die du auf jedem Agenten ausführen kannst, der eine SKILL.md liest. (Auf Claude Code fügt das Plugin gebündelte Sub-Skills und optionale Durchsetzungs-Hooks hinzu; unten hängt nichts davon ab.)
Drei Prinzipien bestimmen den Ablauf: Gates, nicht Bauchgefühl (jede Last-tragende Aktion hat einen Auslöser, einen Test und eine Aktion); Externalisiere den Zustand (alles, was der Run nicht vergessen darf, liegt auf der Festplatte und wird an Phasengrenzen neu gelesen); Überprüfe mit frischem Blick (Ehrlichkeit ist strukturell – ein Ledger und ein Audit-Durchlauf – nicht motivational).
Der Gates-Katalog
Überprüfe jedes Gate an seinem Entscheidungspunkt – sie sind Selbstprüfungen, keine stehenden Ermahnungen:
- Turn-Ende-Gate – Auslöser: vor dem Beenden eines beliebigen Turns · Test: Ist der letzte Absatz ein Plan, eine Frage oder ein Versprechen („Ich werde…“, „als nächstes würde ich…“, „lass mich wissen, wann…“)? · Aktion: Erledige diese Arbeit jetzt oder melde BLOCKED mit dem Grund. Beende niemals einen Turn mit einem Versprechen.
- Behauptungs-Gate – Auslöser: vor dem Melden des Status eines DoD-Kriteriums · Test: Enthält
.taskstate/evidence.mdein Tool-/Command-Ergebnis aus dieser Sitzung, das es belegt? · Aktion: Kein Ledger-Eintrag → der Status ist mechanisch IMPLEMENTED-NOT-VERIFIED. VERIFIED ist eine Ledger-Suche, keine Beurteilung. - Zustandsänderungs-Gate – Auslöser: vor jedem zustandsändernden Befehl (Neustart, Löschen, Konfigurationsänderung, Migration) · Test: Unterstützt die Evidenz diese spezifische Aktion, oder matcht das Signal nur ein bekanntes Fehlermuster? · Aktion: Wenn es nur ein Muster matcht, sammle zuerst die fehlende Evidenz.
- Phasengrenzen-Gate – Auslöser: beim Betreten einer beliebigen Phase (neues Epic, fortgesetzte Sitzung, nach Verdichtung) · Test: Wurden
grounding.md,decisions.md,run-memory.mdin dieser Phase neu gelesen? · Aktion: Lese sie neu, bevor du handelst. - Delegations-Gate – Auslöser: nachdem ein delegierter Worker oder paralleler Task abgeschlossen oder inaktiv wurde · Test: Existiert seine Ausgabe auf der Festplatte, nicht leer und passend zur Aufgabe? · Aktion: Inaktiv ≠ geliefert – fehlende oder falsche Ausgabe bedeutet erneute Zuweisung oder Übernahme der Arbeit; leite Schlussfolgerungen weiter, keine Transkript-Dumps.
Der Run-State-Vertrag
Erstelle diese vier Dateien in .taskstate/, bevor du Code schreibst, und lies die ersten drei an jeder Phasengrenze neu:
| Datei | Inhalt |
|---|---|
grounding.md | Wie die Daten modelliert sind und wo sie leben; pro DoD-Item Verifikationspfad + ob das Ziel in dieser Sitzung erreichbar ist |
decisions.md | Jede übergreifende Entscheidung (Schemata, Schnittstellen, Benennung, Verantwortlichkeiten) – der gemeinsame Vertrag; diskutiere einen Eintrag nie neu, protokolliere stattdessen Uneinigkeit |
evidence.md | Das Evidenz-Ledger – ein Eintrag pro Kriterium pro Verifikationsversuch: Zeitstempel · Befehl · zitierte Ausgabe · Urteil, angehängt in dem Moment, in dem es passiert |
run-memory.md | Fehlgeschlagene Ansätze (nie blind wiederholen), Umgebungsbesonderheiten, Entscheidungsbegründungen, Überraschungen |
Übergreifende Gedächtnis: Rolle am Ende eines Runs dauerhafte Lektionen in .fable-it-reports/lessons.md; lies sie zu Beginn zukünftiger Runs im selben Projekt.
Die Behauptungs-Grundierungsregel: Ein Kriterium darf nur dann als VERIFIED gemeldet werden, wenn evidence.md ein bestandenes Ergebnis aus dieser Sitzung enthält. Alles andere ist IMPLEMENTED-NOT-VERIFIED (gebaut, aber die echte Prüfung konnte nicht ausgeführt werden – sage, was blockiert hat) oder BLOCKED (konnte nicht abgeschlossen werden – sage, was der Benutzer bereitstellen muss). Niemals VERIFIED auf Basis eines Mocks, einer Annahme oder des Gedächtnisses.
Der Ablauf
- Fixiere die DoD. Strukturiere ein vages Ziel in nummerierte, einzeln verifizierbare Kriterien um und zeige sie. Deklariere das laufende Modell und wende seine Haltung an: Schwächere/kleinere Modelle grundieren öfter neu und formulieren Gates inline; stärkere Modelle mit hohem Aufwand wenden Over-engineering-Unterdrücker an (keine unangeforderten Refactorings, keine spekulativen Abstraktionen). Gehe bei Unsicherheit von der strengsten Haltung aus.
- Autonome Haltung. Fahre ohne Nachfrage bei reversibler Arbeit fort; führe niemals irreversible Aktionen (Drops, Force-Pushes, destruktive Migrationen) ohne vorherige Autorisierung durch – und die Zustimmung aus einem Kontext überträgt sich nicht auf einen anderen. Schau vor dem Überschreiben. Zweiseitige Ehrlichkeit: täusche nie Grün vor und weiche nie bei einem Ergebnis aus, dessen Evidenz im Ledger steht.
- Vorgrundierung. Lese die echte Quelle der Wahrheit (das tatsächliche Schema, die Datei, den Endpunkt – nicht deine Erinnerung daran), schreibe dann die vier Run-State-Dateien. Ein Kriterium ohne benennbaren Verifikationspfad wird jetzt gekennzeichnet.
- Zerlegen und routen. Zerlege das Ziel in Epics → Stories → Tasks, die auf DoD-Items abgebildet werden (persistiere die Aufteilung in
.taskstate/). Halte entscheidungsgekoppelte Arbeit in einem Thread; parallelisiere nur wirklich unabhängige Teile, gebunden durchdecisions.md. Wo der Host dir erlaubt, Workermodelle zu wählen, route mechanische Arbeit zu günstigen Tiers und Beurteilung/Verifikation zum Top-Tier – downgrade niemals den Verifikationsdurchlauf – und protokolliere jede Wahl + Begründung inrun-memory.md. - Führe die Zyklen aus. Diagnostiziere vor dem Beheben (hinterfrage eine Ursache, bevor du ihr vertraust), teste nach dem Beheben, hänge jedes Ergebnis an das Ledger an. Bevor du ein Kriterium verifizierst, bestätige, dass sein Ziel tatsächlich erreichbar ist – ein QA-Durchlauf gegen einen Mock ist ein falsches Grün; leite es stattdessen direkt zu IMPLEMENTED-NOT-VERIFIED. Setze nach jedem Absturz von
.taskstate/aus fort; Infrastrukturfehler sind keine Taskfehler. - Überprüfe mit frischem Blick, dann berichte. Erstelle den Bericht, prüfe ihn dann gemäß dem untenstehenden degradierten Verifizierer-Protokoll (oder übergib die Prüfung einem neuen Reviewer, wenn der Host einen hat – überspringe sie nie). Liefere den Bericht plus, falls ein Credential erstellt wurde, ein separates Credentials-Artefakt in
.fable-it-reports/.
Das degradierte Verifizierer-Protokoll
Prüfe vor der Auslieferung den Entwurfsbericht als separaten Durchlauf. Sage explizit: „unter Beiseitelassen des Implementierungskontexts.“ Lese dann NUR die DoD, den Entwurfsbericht und .taskstate/evidence.md – niemals die Implementierungshistorie – und gehe jede Zeile standardmäßig in Frage: Eine VERIFIED-Zeile ohne Ledger-Eintrag, oder deren zitierte Ausgabe das Kriterium nicht tatsächlich demonstriert, ist CHALLENGED. Jede Anfechtung wird vor der Auslieferung aufgelöst: führe die echte Prüfung jetzt durch und hänge den Ledger-Eintrag an, oder stufe die Zeile auf IMPLEMENTED-NOT-VERIFIED herunter. Protokolliere jede Uneinigkeit im Bericht; überschreibe niemals stillschweigend eine Anfechtung.
Der Bericht
Eine einzige Urteilsquelle. Pro DoD-Kriterium: VERIFIED (zitiere die Ledger-Evidenz) / IMPLEMENTED-NOT-VERIFIED (was die Verifikation blockiert hat, was stattdessen verwendet wurde) / BLOCKED (was der Benutzer entscheiden oder bereitstellen muss). Enthalten: Eine Keine stillen Kürzungen-Sektion (alles Übersprungene, Stichprobenartige oder Eingeschränkte, und warum), die getroffenen Delegations-/Kostenentscheidungen, Entscheidungen aus decisions.md, Überraschungen und empfohlene nächste Aktionen. Geschrieben für einen aufwachenden Teammitglied: beginne mit dem Ergebnis, vollständige Sätze, keine erfundenen Abkürzungen.
Installation
Claude Code Plugin (empfohlen) – fügt die gebündelten /launch, /iterate, /full-qa und /chrome-cdp-control-Skills hinzu, die der Dirigent routet, plus optionale Fail-Open-Durchsetzungs-Hooks:
/plugin marketplace add DevOtts/fable-it
/plugin install fable-it@devotts
Jeder andere Agent (Cursor, Codex, Copilot, 70+ Tools):
npx skills add DevOtts/fable-it -a <agent>
Ohne die gebündelten Skills, führe jede Phase inline gemäß der obigen Mechanik aus – die Verhaltensebene ist das Produkt; degrade, unterbrich nie.
Sicherheitshinweise
- Es werden keine Geheimnisse benötigt, um das Skill zu installieren oder auszuführen. Du stellst Credentials nur für den spezifischen Job bereit, den du es ausführen lässt.
- Es liest
.full.credentialsund.envlokal nur – niemals übertragen, niemals committed. - Browser-Automatisierung verwendet dein eigenes Chrome über das Chrome DevTools Protocol auf einem lokalen Port, wobei deine angemeldete Sitzung wiederverwendet wird; nichts wird gespeichert oder exfiltriert. Arbeiten an authentifizierten Konten erfolgen immer über eine schreibweise Bestätigung – autonome QA ist nur für Testumgebungen.
- Jedes Credential, das während eines Runs erstellt wird, wird in einem dedizierten Credentials-Artefakt mit Rotationshinweisen isoliert – niemals in Prosa vergraben.
- Irreversible Aktionen erfordern immer explizite vorherige Autorisierung; Autonomie deckt nur reversible Arbeit ab.
Erstellt von DevOtts.