juanmackie/juanskills

Die Fable-Schleife

Diese Fähigkeit orchestriert die Fable-Methode: Lies zuerst deren SKILL.md; ihre Regeln gelten für jede Stufe. Sie ist zusammen mit dieser Fähigkeit installiert (im Verzeichnis skills/fable-method/ dieses Plugins oder unter ~/.claude/skills/fable-method/ bei manuellen Installationen). Die Methode sagt, WAS geprüft werden soll; diese Schleife sagt, WER die Arbeit macht: was im Hauptthread läuft, was an Subagenten ausgelagert wird und was vor der Auslieferung angegriffen wird.

Zuerst die Prüfung.

Trivial gemäß der Trivialitätsprüfung der Methode: Einfach erledigen, mit der einen offensichtlichen Prüfung verifizieren und in zwei Sätzen berichten. Keine Stufen, keine Subagenten. Alles andere durchläuft die vier untenstehenden Stufen der Reihe nach.

Stufe 1 – PLAN (die erste Klammer)

1. Wende die Schritte 0-3 der Methode an: Klassifiziere die Anfrage, definiere „Fertig“ mit einer benannten Verifikation, nenne tragende Annahmen.
2. Evidenz-Ausschwärmen. Starte die Evidenzsammler als parallele Subagenten in EINER Nachricht, niemals sequenziell:
   • Codebasis-Fragen: Ein Explore-Agent pro eindeutigem Bereich („Wie funktioniert X?“, „Wovon hängt Y ab?“)
   • Bibliotheks- oder Faktenfragen: Ein Research-Agent, der aktuelle Dokumente abruft oder im Web sucht
   • Jeder Subagent gibt destillierte Ergebnisse mit Quellenangaben zurück, niemals rohe Datei-Dumps
   • Ein Batch plus ein Folgebatch ist das Budget; ein dritter benötigt eine begründete Erklärung
3. Erstelle das Plan-Artefakt in dieser Form:
   • Klassifikation
   • Definition von „Fertig“ plus deren Verifikation
   • Gefundene Evidenz (mit Quellenangabe)
   • EIN empfohlener Ansatz (Alternativen in jeweils einem Satz verworfen)
   • Der Umfang (die genauen Dateien oder Oberflächen, die die Arbeit berührt)
   • Risiken und Annahmen
   • Und die Ausführungs-Checkliste
4. Entscheidungsprüfung.
   • Aufgabenförmig und umkehrbar: Fahre mit Stufe 2 fort, ohne zu fragen
   • Plan-erste Form (mehrdeutiger Umfang, irreversible oder nach außen gerichtete Aktionen, oder der Benutzer hat nach einem Plan gefragt): Lege das Plan-Artefakt vor und HALT für Genehmigung

Stufe 2 – AUSFÜHREN

1. Arbeite die Checkliste im Hauptthread ab (verwende das todo-Tool, falls die Umgebung eines hat; hake erledigte Punkte ab). Entscheiden und Bearbeiten bleiben im Hauptthread; nur Suchen und Verifizieren werden ausgelagert.
2. Jede Bearbeitung folgt Schritt 4 der Methode: Intentionsprüfung vor Verhaltensänderung, Rückrufprüfung vor der ersten Verwendung von etwas Ungelesenem, kleinste korrekte Änderung, präzise Bearbeitungen, niemals ohne Hinsehen zerstören.
3. Unabhängige mechanische Aufgaben (gleiche Änderung in vielen Dateien, isolierte Dateigenerierung) dürfen an parallele Subagenten ausgelagert werden, in einer Nachricht, mit Worktree-Isolation, falls sie dieselben Dateien berühren könnten.
4. Eine Überraschung während der Ausführung wird gemäß Schritt 2, Regel 7 der Methode umgeleitet: Sag es, aktualisiere dann den Plan oder gehe zurück zu Stufe 1. Erzwinge den Plan niemals durch eine Überraschung.
5. Unwissenheit mitten in einem Punkt ist eine Pause, kein Raten: Sobald eine Bearbeitung eine Tatsache aus dem Gedächtnis verwenden würde (eine Signatur, einen Schlüssel, eine Zahl), stoppe diesen Punkt, starte einen Research-Subagenten gemäß der Rückrufprüfung der Methode und setze fort, wenn er zurückkommt.
6. Nach außen gerichtete Checklisten-Punkte gehorchen der Autorisierungsprüfung der Methode: Keine zitierte Benutzerautorisierung, keine Aktion; der Punkt wird zu einem vorgeschlagenen nächsten Schritt im Bericht.
7. Turn-Budget-Kontrollpunkte. Begrenze lange Iterationen auf ≤50 Agenten-Turns; schreibe an jeder Grenze ein Kontrollpunkt-Artefakt (was abgeschlossen wurde, Evidenzpfade, exakte nächste Aktion) und setze von dort aus fort. Die endgültige Verifikation darf niemals der Schritt sein, den das Turn-Limit tötet – verifiziere innerhalb des Budgets oder markiere es explizit als ausstehend.

Stufe 3 – VERIFIZIEREN (adversarial)

1. Führe die benannte Verifikation selbst durch, beide Hälften: Das beobachtete Kriterium für „Fertig“ (ausgeführt, gerendert, gezählt) und das umgebende System bleibt gesund (Build, Tests, Lint für den berührten Bereich).

2. Für folgenreiche Änderungen, starte Angreifer. 1-3 parallele Subagenten, jeder beauftragt, die Arbeit aus einer anderen Perspektive zu WIDERLEGEN, zum Beispiel:

   • „Lies dieses Diff und beweise, dass die Änderung falsch oder unvollständig ist“
   • „Führe das geänderte Verhalten zur Laufzeit aus und finde eine Eingabe, die es zerbricht“
   • „Überprüfe diese Behauptung anhand der Spezifikation/Dokumentation und finde einen Widerspruch“
   • „Vergleiche das gesamte Änderungsset mit dem deklarierten Umfang des Plans und beweise, dass sich etwas außerhalb geändert hat“

   Unterschiedliche Perspektiven schlagen identische Prüfer.

3. Ein Befund, der deiner eigenen Prüfung standhält, geht als neue Arbeit zurück zu Stufe 2. Harte Grenze gemäß der Methode: 3 fehlgeschlagene Korrektur-Verifikations-Zyklen zum selben Problem, oder irgendein Blocker außerhalb deiner Kontrolle, bedeutet Stopp und Rückgabe mit dem Output und deiner Hypothese.

Stufe 4 – PRÜFEN UND BERICHTEN (die zweite Klammer)

1. Selbstprüfung gemäß dem Prüfmodus der Fable-Methode: Für jeden Methodenschritt: befolgt, übersprungen oder gefälscht. Korrigiere, was ein Durchgang korrigieren kann (normalerweise eine nicht verifizierte Behauptung: verifiziere sie jetzt oder kennzeichne sie als Einschränkung neu).
2. Liefern gemäß Schritt 6 der Methode: Ergebnis im ersten Satz, Verifikationsbeweise gezeigt, ehrliche Einschränkungen, Folgeaktionen nur, wenn sie aus der Arbeit hervorgegangen sind. Keine Stufennamen oder Schrittnummern im Bericht; die Zeilen INTENT und AUTH sind die einzigen Methodenartefakte, die ein Bericht enthalten darf.

Wann diese Schleife NICHT verwendet werden soll

• Triviale Aufgaben (die Prüfung erledigt sie)
• Reine Fragen ohne mehrstufige Arbeit: Die einfache Fable-Methode deckt die Form ab
• Innerhalb einer bereits orchestrierten GSD-Phase: GSD besitzt dort die Stufen; wende stattdessen die Fable-Methoden-Regeln innerhalb dieser an, anstatt Schleifen zu verschachteln

Model-Ökonomie

Die Schleife ist modellunabhängig. Evidenz- und Angreifer-Subagenten sind günstig-modellfreundlich; halte den Hauptthread (Entscheiden, Bearbeiten) auf dem stärksten verfügbaren Modell und gib Angreifern mehr Aufwand als Sammlern, wenn eine Wahl besteht.

Verwendung

/fable-loop <task>   Führe die vollständig orchestrierte Schleife aus