Looptimal — Ergebnisorchestrator
Verwandle ein Ziel in ein geliefertes, verifiziertes Ergebnis: versiegle die Abnahmekriterien, wähle die richtige Schleife aus oder lehne sie ab, simuliere den Plan kriegerisch, führe mit Domänenexperten aus und mache den Abschluss von einem separaten Verifizierer abhängig, der die versiegelte Suite gegen den Live-Zustand erneut ausführt – niemals von einem selbst gemeldeten GRÜN.
Der Assistent zum Schleifenentwurf (ehemals eigenständiger LoopPrint) ist als Stufe 2: Design-Loop eingebettet. Er läuft auch als design-Schnellpfad, wenn Sie nur einen Schleifenentwurf ohne Ergebnisorchestrierung benötigen.
Wann verwenden
- "looptimal", "/looptimal", "Ergebnis-Schleife ausführen", "dieses Ziel bis zur Fertigstellung orchestrieren", "dieses Ziel planen und ausliefern".
- Ein nicht-triviales Ziel, bei dem "fertig" gegen den Live-Zustand bewiesen werden muss, nicht nur durch den Agenten, der die Arbeit erledigt hat.
- Fachübergreifende Arbeit, die ein Fähigkeitsmanifest, einen Konsensplan und Ersteller ≠ Prüfer auf Ergebnisebene erfordert.
- Wiederkehrende, überwachte, ratschenartige oder orchestrierende Muster – nachdem der Design-Loop bestätigt hat, dass es sich tatsächlich um eine Schleife handelt.
- Sie möchten mit Simulate den Plan kriegerisch testen, bevor eine autonome Ausführung beginnt.
- Ein einzelnes, nicht-triviales Ziel, das Sie einmal liefern und gegen den Live-Zustand verifizieren möchten. Wenn es eine begrenzte Iteration benötigt, leiten Sie es als Mission/Goal-Run weiter; wenn ein sorgfältiger Durchlauf ausreicht, verwenden Sie den Single-Pass-Modus (siehe die Modus-Verzweigung unten).
Wann den Design-Schnellpfad verwenden
- "eine Schleife entwerfen", "eine Schleife bauen", "neue Schleife", "Schleifenassistent" oder eine vage wiederkehrende Aufgabe, die automatisiert werden soll.
- Sie möchten nur einen Schleifenentwurf (Spezifikation + Artefakte) – keine Ergebnisorchestrierung.
- Springt direkt zu Stufe 2 (Entscheidungsgatter → Assistent → Artefaktgenerierung) und stoppt.
Wann NICHT verwenden
- Eine triviale einmalige Antwort, schnelle Bearbeitung oder konversationelle Frage → machen Sie es einfach einmal gut, kein Werkzeug nötig. (Ein substantielles einmaliges Ziel, das Sie dennoch verifiziert haben möchten – nicht trivial, nur nicht wiederkehrend – leiten Sie als Mission/Goal-Run oder Single-Pass weiter, nicht als Grund, Looptimal komplett zu überspringen.)
- Analyse ohne Lieferverpflichtung → direkt antworten oder esat verwenden.
- Unumkehrbare, urteilsintensive Aktionen ohne eine Person, die bereit ist, das GO-Gatter zu verantworten → empfehlen Sie einen menschlich gesteuerten Prozess.
- Meta-Schleifen ("Looptimal ausführen, um Looptimal zu verifizieren", "automatisch zusammenführen, wenn Looptimal GRÜN sagt") → Design-Loop muss ABLEHNEN.
- Nur Symptom-basierte Erfolgsmetriken ohne verhaltensorientierten Ergebnismaßstab → neu rahmen oder ABLEHNEN.
Betriebsregeln (zuerst lesen)
- Dies ist ein Skill, kein Persona oder Modus. Beginnen Sie mit einer Aktivierungszeile, dann führen Sie die Arbeit aus.
- Checkpoint-gesteuert: Rahmen → Analysieren → Design-Loop/Routen → Planen → Simulieren, halten Sie jeweils kurz für einen Status. Ausführen beginnt niemals ohne explizites menschliches GO nach Simulieren – oder, im Single-Pass-Modus, nach der leichten Vorab-Prüfung (Pre-Mortem), die die Checkpoints Analysieren/Design-Loop/Planen/Simulieren ersetzt (siehe die Modus-Verzweigung unten).
- Niemals Unumkehrbares automatisch ausführen: Produktiv-Deployments, Sendungen, Zahlungen, Anmeldeinformationen-Rotation, Datenlöschung – nur mit vorgeschalteten menschlichen Gates.
- Harness-entkoppelt: Auflösung von Bindungen aus
./.looptimal/profile.yaml→~/.looptimal/profile.yaml→scripts/looptimal-detect.py→ generische Standardwerte. Vertrag:references/agent-foundry.md.
Beispiele für Aktivierungszeilen:
- Vollständige Pipeline: "Looptimal – rahme dieses Ziel in eine versiegelte Ergebnis-Schleife."
- Design-Schnellpfad: "Looptimal – erstelle einen Bauplan für diese Schleife."
- Single-Pass: "Looptimal – ein verifizierter Durchlauf dafür, keine Schleife."
- Ohne Ziel aufgerufen: stellen Sie genau eine Frage – "Welches Ergebnis soll wahr sein, wenn wir fertig sind?" – dann die Modus-Verzweigung unten.
- Ziel bereits gegeben: in einer Zeile bestätigen, dann die Modus-Verzweigung unten.
Die Modus-Verzweigung (vor Rahmen – einmal, günstig fragen)
Looptimals Beurteilung der Schleifentauglichkeit ist das Entscheidungsgatter (Schritt 1 des Assistenten, unten) – aber derzeit feuert das erst tief in Stufe 2, nachdem Rahmen und Analysieren bereits gelaufen sind. Entscheiden Sie die Form vor dem Beginn dieser Arbeit:
- Formulierung bereits eindeutig – Frage überspringen:
- Auslösewörter für Design-Schnellpfad ("eine Schleife entwerfen", "eine Schleife bauen", "Bauplan", "Schleifenassistent") → direkt zu Stufe 2.
- Explizite Einmal-Ausführungssprache, die auch nützliche Wiederholungen ausschließt ("ein Durchlauf", "ein sorgfältiger Durchlauf", "kein Wiederholungs-Schleife nötig") → direkt Single-Pass.
- Explizite Auslieferungssprache mit möglichem Verifizierer/Wiederholungsarbeit ("einmalig", "mach einfach X einmal", "baue/repariere/liefere das einmal") → vollständige Pipeline, damit das Entscheidungsgatter Mission/Goal-Run vs. Single-Pass wählen kann.
- Explizite Wiederholungs-/Frequenzsprache ("nächtlich", "bei jedem PR", "halte das frisch", "fortlaufend") → vollständige Pipeline direkt.
- Andernfalls – eine strukturierte Drei-Optionen-Frage stellen, bevor Stufe 0 berührt wird:
- Einmal erledigen, verifiziert – ein einzelnes verifiziertes Ergebnis ohne nützliche Wiederholungsschleife → Single-Pass.
- Eine Mission ausführen oder eine Schleife bauen – entweder begrenzt (eine Mission/Goal-Run, die iteriert, bis ein Gatter erreicht ist, dann stoppt – Fehlerkorrekturen, Spezifikationskonformität, einmalige Builds) oder wiederkehrend (wird nach einem Zeitplan/Trigger unbegrenzt ausgeführt) → vollständige Pipeline (Stufe 0 → 1 → 2; das Entscheidungsgatter wählt die Route/Archetyp – Task / Wiederkehrend / Überwacht / Persistent-Ratschen / Orchestrierung, Mission/Goal-Run oder harte Ablehnung).
- Nur einen Schleifenbauplan generieren → Design-Schnellpfad (nur Stufe 2).
Dies bringt die gleiche Schleifentauglichkeitsprüfung, die das Entscheidungsgatter bereits trifft, als eigenes Urteil des Benutzers zum Ausdruck – vorab und günstig – anstatt nur erreichbar, nachdem Analysieren, Design-Loop und Planen bereits für die falsche Form aufgewendet wurden (Rahmen läuft unabhängig vom gewählten Modus, ist also nie verschwendet). Wenn Beweise aus Stufe 0/1 später dem gewählten Modus widersprechen – ein "Single-Pass"-Ziel erweist sich als klar wiederkehrend oder erfordert Iteration bis zu einem Gatter, oder ein "wiederkehrendes System" überlebt das Entscheidungsgatter nicht – sagen Sie dies klar und lassen Sie den Benutzer umleiten. Überschreiben Sie niemals stillschweigend ihre Wahl; befolgen Sie niemals stillschweigend einen Modus, den die Beweise nicht stützen.
Bindung auflösen (Vorspann zu Stufe 0)
python3 scripts/looptimal-detect.py # Sondiere Marker; schlage Profil vor
# oder lese ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml
Liefert state_dir, dispatch.maker, dispatch.checker, verifier.default, optional banner. Generische Standardwerte: loops/<slug>/, Shell-Verifizierer.
Die 8-stufige Pipeline
| Stufe | Name | Aufgabe | Referenz |
|---|---|---|---|
| 0 | Rahmen | Das Ziel in eine hash-gesicherte, VERSIEGELTE Abnahmesuite verwandeln. Jedes Kriterium behauptet ein Ergebnis (kein Symptom) und bindet einen domänenspezifischen Ergebnismaßstab. Eingaben sind für den Ersteller nicht schreibbar. Ausgabe: acceptance-suite.yaml + acceptance-suite.sha256. | references/pipeline.md |
| 1 | Analysieren | Ein Fähigkeitsmanifest und ein lokales Fähigkeitsbereitschaftsinventar erstellen: Domänen, Integrationskarte, Risiken, Abhängigkeiten, verfügbare Skills/Plugins/Connectoren/MCPs/Agenten/Daten. Delegieren Sie tiefgehende Definitionsarbeit an esat, wenn die Einsätze einen Tri-Modell-Stresstest rechtfertigen. | references/pipeline.md |
| 2 | Design-Loop / Routen | Den Assistenten zum Schleifenentwurf ausführen oder das Ziel routen. Archetyp wählen – Task (begrenzte Auslieferung), Wiederkehrend (geplante Aktualität), Überwacht (autonom innerhalb von Leitplanken), Persistent-Ratschen (jeder Durchlauf verbessert strikt eine Ergebnismetrik), Orchestrierung (Multi-Akteur/Multi-Repo), Mission/Goal-Run, Single-Pass – oder ABLEHNEN nur für harte Fälle ohne Verifizierer/Meta-Schleife/nur Symptome. | references/pipeline.md |
| 3 | Planen | Einen Konsens-Aufgabengraphen erstellen: Knoten, Abhängigkeiten, Aufgaben-spezifische Abnahme-Haken, die an die versiegelte Suite gebunden sind, Einschlagsradius-Markierungen, Rollback-Notizen. | references/pipeline.md |
| 4 | Simulieren | Die Schleife N Schritte vorwärts rollen; Vorab-Prüfung (Pre-Mortem) der Fehlermodi (Belohnungs-Hacking, stiller Fehler, teilweise Fertigstellung, Umgebungsdrift); den Plan härten. Ergebnisse und etwaige Abweichungen zur versiegelten Suite präsentieren (Neu-Hash + Benutzerbestätigung). | references/pipeline.md |
| — | Menschliches GO | Explizite Genehmigung zur Ausführung. Wichtigste Risiken, Unumkehrbares, offene Abhängigkeiten anzeigen. Kein GO → keine Ausführung. | references/pipeline.md |
| 5 | Ausführen | Dynamische domänenspezifische Sub-Agenten gemäß dem Bindungsprofil starten. Ersteller ≠ Prüfer an Iterationsgattern. Fortsetzbare, idempotente Schritte; Rollback-Pfade bei teilweisem Fehlschlag. Vorherige Gates bei Unumkehrbarem. | references/pipeline.md |
| 6 | Ergebnis-verifizieren | Ein separater Prüfer führt die VERSIEGELTE Suite gegen den Live-Zustand erneut aus. Das selbst gemeldete GRÜN der Schleife ignorieren. Auf ein Beweispaket warten. | references/pipeline.md |
| 7 | Persistieren | Dauerhaften Zustand schreiben: Ziel-Hash, Suite-Hash, was funktioniert/fehlgeschlagen ist, Maßstab-Ergebnisse, Behebungsklasse, Fortsetzungszeiger, Lehren für den nächsten Durchlauf. | references/pipeline.md |
Stufenübergänge (Standard)
- 0 → 1: versiegelte Suite existiert, jedes Kriterium hat einen Maßstab, Hash aufgezeichnet.
- 1 → 2: Fähigkeitsmanifest deckt alle wesentlichen Domänen, Integrationskanten und lokale Fähigkeitsbereitschaft ab.
- 2 → 3: Archetyp oder Missionsroute gewählt (oder harte ABLEHNUNG mit ehrlicher Alternative ausgesprochen).
- 3 → 4: Aufgabengraph ist azyklisch, jeder Knoten ist an ein Suite-Kriterium gebunden, Sicherheitsgrenzen gesetzt.
- 4 → GO: Simulationsbericht geliefert; Plan gehärtet; Unumkehrbares markiert.
- GO → 5: explizite menschliche Zustimmung im Zustand festgehalten.
- 5 → 6: Ersteller erklärt Iteration für abgeschlossen – nur informativ; Prüfer besitzt die Wahrheit.
- 6 → 7: Beweispaket GRÜN; sonst FEHLGESCHLAGEN mit Behebungsklasse und Fortsetzungszeiger.
Fortsetzen
Wenn unter state_dir ein vorheriger Durchlauf existiert und der Ziel-Hash übereinstimmt, setzen Sie ab der letzten unvollständigen Stufe fort. Wenn sich das Ziel wesentlich geändert hat, erneut rahmen (neuer Suite-Hash). Setzen Sie niemals nach einer harten ABLEHNUNG ohne einen neuen Design-Loop/Routen fort.
Stufe 2 — Design-Loop / Routen-Assistent
Der Assistent erzwingt die vier Atome, führt das Routen-Entscheidungsgatter aus und verzweigt dann. Routen für wiederverwendbare Schleifen generieren das vollständige LoopPrint-Artefaktpaket. Routen für Mission/Goal-Run geben route.md + ein Missionspaket (mission.yaml nach Stufe 3) aus und fahren mit Stufe 3 Plan fort, ohne ein wiederholbares Schleifengerüst. Routen für Single-Pass geben route.md plus die leichte Vorab-Prüfung (Pre-Mortem) aus und folgen dem Single-Pass-Degrade-Pfad. Er lebt in Stufe 2 der vollständigen Pipeline und läuft auch eigenständig als design-Schnellpfad.
Assistent-Eintritt
- Vollständige Pipeline (von Stufe 2 aufgerufen): Ziel ist das Ergebnis aus Stufe 0. Überspringen zu Schritt 0.5.
- Design-Schnellpfad (direkter Aufruf): mit einer Aktivierungszeile beginnen; wenn kein Ziel angegeben, zuerst eine Frage stellen.
Schritt 0.5 — Bindung auflösen
scripts/loopprint-detect.py ausführen (oder ./.loopprint/profile.yaml → ~/.loopprint/profile.yaml lesen) um state_dir, verifier.default, dispatch, marker_path, runner, banner zu erhalten. Generische Standardwerte: loops/<slug>/, verify.sh. Vertrag: references/profiles.md. Niemals Harness-Konventionen hart codieren.
Schritt 1 — Entscheidungsgatter (+ Route)
Den Tier-0-Test in references/decision-gate.md ausführen: 4 Bedingungen + 30-Sekunden-Checkliste. Die Route mit einer Begründungszeile pro Bedingung melden. Wiederkehr bleibt der Amortisationstest für wiederverwendbare Schleifen, nicht das gesamte Orchestrierungsgatter: nicht wiederkehrende, aber verifizierergestützte Arbeit kann zu Mission/Goal-Run oder Single-Pass geroutet werden. Harte ABLEHNUNG bleibt obligatorisch, wenn es keinen externen Verifizierer/menschlichen Checkpoint gibt, wenn das Ziel selbstreferenziell/eine Meta-Schleife ist, oder wenn Erfolg nur symptom-basiert ohne verhaltensorientierten Anker ist.
Sofort auf der Grundlage der gewählten Route verzweigen:
- Route Wiederverwendbare Schleife: mit den Schritten 2–6 fortfahren, den Schleifen-Archetyp/das Profil festlegen,
loops/<slug>/generieren undloopprint-lintausführen. - Route Mission/Goal-Run: nicht mit dem Schleifenprofil oder der Artefaktgenerierung fortfahren.
route.mdmit Treiber, Zustandsartefakt, Verifizierer, Stopp/Budget, Autonomiegrad, Bereitschaftslücken und Begründung, warum kein wiederverwendbarer Schleifenbauplan erstellt wird, ausgeben; dann mit Stufe 3 Plan fortfahren, diemission.yaml,task-graph.yaml,execute-scope.yamlundlooptimal-lint.txtausgibt. - Route Einzelner verifizierter Durchlauf (Single-Pass): nicht mit dem Schleifenprofil oder der Artefaktgenerierung fortfahren.
route.mdmit Verifizierer, Zustandsartefakt, Stopp, Bereitschaftslücken und einer leichten Vorab-Prüfung (Pre-Mortem) mit 3 Szenarien ausgeben; dann dem Single-Pass-Degrade-Pfad folgen, anstatt den Stufen 3/4. - Route Menschlich gesteuerter Workflow:
route.mdmit den menschlichen Checkpoints und externem Prüfer ausgeben, dann nur durch den überwachten Pfad fortfahren, der diesen Gates entspricht. - Harte ABLEHNUNG:
reject.mdmit dem nicht verifizierbaren/unsicheren Grund und einer ehrlichen Alternative ausgeben; stoppen, es sei denn, der Benutzer rahmt das Ziel neu.
Schritt 2 — Zielverfeinerung für wiederverwendbare Schleifen
3–5 gezielte Fragen stellen (nicht mehr):
- Geschärftes Ziel – ein Satz, testbar.
- Wiederkehr / Frequenz – bestätigt, dass sich die wiederverwendbare Schleife amortisiert.
- Verifizierungsmethode – welches externe Signal sagt, dass eine Iteration erfolgreich war?
- Unumkehrbare Risiken – was kann nicht rückgängig gemacht werden? (→ menschlicher Checkpoint)
- Autonomiegrad – vollständig autonom, checkpoint-gesteuert oder Trockentestlauf?
Schritt 3 — Erzwingung der Primitive für wiederverwendbare Schleifen
Für jedes Atom einen konkreten Wert erzwingen. Nicht mit vagen Angaben fortfahren:
- Ziel – das Ein-Satz-Ziel aus Schritt 2.
- Zustand – Pfad zum dauerhaften Artefakt aus dem
state_dirder Bindung; was es aufzeichnet: Versuchsprotokoll, was fehlgeschlagen ist, aktuelle Hypothese, Kontext. - Verifizierer – der genaue externe Befehl oder benannte Prüfer. Wenn der einzige vorgeschlagene Check die Selbsteinschätzung desselben Agenten ist, ablehnen und ein echtes Gatter finden. Ersteller ≠ Prüfer.
- Stopp – Erfolgskriterien und eine Sicherheitsgrenze (maximale Iterationen, Token/Zeit-Budget, expliziter Halt). Keine Schleife wird ohne Sicherheitsgrenze ausgeliefert.
Schritt 4 — Profilauswahl für wiederverwendbare Schleifen
Das vollständige Profil des Archetyps festlegen – Arbeitsmuster (aus references/patterns.md) und Verifizierer/Stopp-Form:
- MORTY – spezifischer Fehler; Verifizierer = Reproduktionstest; Ende der verfügbaren Übersetzung (Details wurden im Original gekürzt).