fhajjej-ship-it/loop-it

Loop It

Verwandle ein offenes Codierungsziel in eine begrenzte, überprüfbare Schleife. Loop It ist auch eine Schleifenbibliothek: Wähle die richtige Starter-Schleife, passe sie an den Kontext des Benutzers an und verfolge den Fortschritt, damit die nächste Iteration offensichtlich ist.

Entscheidung

Entscheide zuerst, welchen Modus der Benutzer benötigt:

• Aus Bibliothek suchen: eine gebündelte Schleife für das Ziel des Benutzers auswählen.
• Nächsten Schritt aus Fortschritt: .loop-it/progress.json oder .loop-it/LOOP.md überprüfen und empfehlen, was als Nächstes iteriert werden soll.
• Nur entwerfen: eine wiederverwendbare Schleifenaufforderung oder eine projektspezifische Schleifendatei erstellen.
• Jetzt ausführen: eine einzelne begrenzte Iteration ausführen, überprüfen und entscheiden, ob eine weitere Iteration gerechtfertigt ist.
• Exportieren/Installieren: dieselbe Schleife für Codex, Claude Code, Cursor oder einen anderen SKILL.md-kompatiblen Agenten anpassen.

Wenn die Aufgabe vage ist, stelle keinen breiten Discovery-Fragebogen. Empfiehle zuerst die wahrscheinlich beste Bibliotheksschleife und nenne die Annahme. Stelle maximal drei gezielte Fragen, nur wenn Ziel, Erfolgsprüfung, Repository-Umfang oder Genehmigungsgrenze wirklich blockieren.

Vertrag

Jede Schleife benötigt diese Felder vor der Ausführung:

• Ziel: das konkrete Ergebnis, kein Thema.
• Umfang: Repository, Dateien, Funktionsbereich, Datenquelle oder Umgebung.
• Erfolgsprüfung: Befehl, Benchmark, manuelle Inspektion, Überprüfungskriterium oder messbare Schwelle.
• Iterationsobergrenze: maximale Durchläufe oder Zeitbudget.
• Stoppbedingungen: Erfolg, keine sinnvolle Verbesserung, wiederholter Fehlschlag, blockierter Zugriff, unsichere Aktion oder Genehmigungserfordernis.
• Nachweise: was nach jedem Durchlauf aufgezeichnet werden soll.
• Genehmigungsstufen: Produktionsschreibvorgänge, externe Nachrichten, Zahlungen, destruktive Git-Operationen, Anmeldeinformationen, Bereitstellungen oder irreversible Datenänderungen.

Widersprich, wenn die angeforderte Schleife nur „weiter verbessern“ ohne Prüfung ist. Biete stattdessen eine kleinere Schleife mit einer klaren Prüfung an.

Eine Schleife auswählen

Bevorzuge die gebündelte Bibliothek gegenüber dem Erfinden einer Schleife von Grund auf.

Verwende das Auswahlskript, wenn verfügbar:

node <skill-dir>/scripts/select-loop.mjs list
node <skill-dir>/scripts/select-loop.mjs search "fehlgeschlagener ci"
node <skill-dir>/scripts/select-loop.mjs recommend --goal "fehlgeschlagenen checkout-test fixen"
node <skill-dir>/scripts/select-loop.mjs next --cwd <projekt>

Ersetze <skill-dir> durch den Ordner dieser Fähigkeit. In Claude Code ist möglicherweise ${CLAUDE_SKILL_DIR} verfügbar. In anderen Agenten finde das Verzeichnis, das diese SKILL.md enthält.

Beim Auswählen:

1. Prüfe zuerst .loop-it/progress.json, wenn der Benutzer fragt, was als Nächstes iteriert werden soll.
2. Wenn kein Fortschritt vorhanden ist, gleiche das Ziel des Benutzers mit references/library/loops.json ab.
3. Empfehle eine Schleife plus maximal zwei Alternativen.
4. Erkläre die Übereinstimmung in einem Satz.
5. Stelle die wichtigsten Fragen der Schleife nur bei Bedarf.
6. Wenn keine Bibliotheksschleife passt, entwirf eine benutzerdefinierte Schleife und sage, dass sie nach Erweis ihrer Nützlichkeit für die Bibliothek in Betracht gezogen werden sollte.

Lies references/library/loops.json nur, wenn das Auswahlskript nicht verfügbar ist oder eine manuelle Überprüfung erforderlich ist. Lies references/loop-template.md, wenn die Aufgabe die generische Form des dauerhaften Zustands benötigt.

Aktuelle Bibliothekskategorien umfassen:

• Ticket zum verifizierten Fix: reproduzieren, diagnostizieren, patchen, Regressionstests hinzufügen, überprüfen.
• Reparatur fehlgeschlagener CI: fehlgeschlagene Ausgabe überprüfen, reproduzieren, patchen, den fehlgeschlagenen Test erneut ausführen.
• Dokumentationsdurchlauf: Dokumentation mit Implementierung vergleichen, veraltete Dokumente aktualisieren, Beispiele oder Links überprüfen.
• Produktevaluierung: Szenarien und Kriterien definieren, testen, Fehler beheben, betroffene und vollständige Prüfungen erneut ausführen.
• Leistungsschleife: Basislinie messen, eine gezielte Änderung vornehmen, erneut messen, nur erwiesene Erfolge behalten.
• Überprüfungsreparaturschleife: Diff überprüfen, blockierende Befunde beheben, Prüfungen erneut ausführen, wiederholen, bis nur noch akzeptiertes Risiko übrig ist.
• Frische-Setup-Schleife: von einer sauberen Umgebung starten, dokumentiertem Setup folgen, versteckte Annahmen korrigieren, sauber neu versuchen.
• Release-Bereitschaft: Paket, Bereitstellung oder öffentliche Installationspfade vor der Veröffentlichung überprüfen.
• UX-Verfeinerung, Abhängigkeitsupgrade, Sicherheitshärtung, Refactoring-Eingrenzung und Testabdeckungslücken-Schleifen.

Die Schleife entwerfen

Verwende diese Struktur für Schleifenaufforderungen und Zustandsdateien:

1. Gib das Ziel und die Nicht-Ziele an.
2. Definiere die wiederholte Aktion in einem engen Zyklus: überprüfen, handeln, überprüfen, aufzeichnen, entscheiden.
3. Nenne den genauen Verifikationsbefehl oder die manuelle Prüfung.
4. Definiere die Iterationsobergrenze und die Stoppbedingungen.
5. Definiere, was der Abschlussbericht enthalten muss.

Halte Version 1 eng: ein Repository, eine primäre Rolle, eine primäre Erfolgsprüfung. Verschiebe Planung, Dashboards, Multi-Agenten-Orchestrierung und Produktionsautomatisierung, bis eine manuelle Schleife sich als nützlich erwiesen hat.

Wenn eine dauerhafte Zustandsdatei nützlich ist, erstelle .loop-it/LOOP.md aus references/loop-template.md oder führe aus:

node <skill-dir>/scripts/create-loop.mjs --name "Schleifenname" --objective "Konkretes Ergebnis" --check "Verifikationsbefehl oder -kriterium"
node <skill-dir>/scripts/create-loop.mjs --from fehlgeschlagener-ci-reparatur

Bibliotheksgestützte Schleifendateien erstellen auch .loop-it/progress.json, es sei denn, --no-progress wird übergeben.

Die Schleife ausführen

Für jede Iteration:

1. Lese das Ziel, die Erfolgsprüfung, die Obergrenze und die Genehmigungsstufen erneut.
2. Überprüfe nur den Kontext, der für die nächste begrenzte Aktion benötigt wird.
3. Mache die kleinste glaubwürdige Änderung.
4. Führe zuerst die engste relevante Verifikation durch, dann breitere Prüfungen nur bei Bedarf.
5. Zeichne Nachweise in .loop-it/LOOP.md auf, wenn eine Zustandsdatei existiert, und aktualisiere .loop-it/progress.json, falls vorhanden.
6. Entscheide: stoppen, fortfahren, Genehmigung anfragen oder als blockiert melden.

Stoppe sofort, wenn das Fortfahren versteckte Annahmen über Sicherheit, Anmeldeinformationen, Produktionsdaten, Abrechnung, Benutzernachrichten, destruktive Git-Operationen oder Bereitstellungsgenehmigung erfordern würde.

Beschreibe eine erschöpfte, blockierte oder teilweise überprüfte Schleife nicht als abgeschlossen. Sage genau, welche Bedingung sie gestoppt hat und welche Nachweise vorliegen.

Exportieren

Verwende denselben Schleifentext über verschiedene Tools hinweg, wobei sich nur der Aufruf unterscheidet:

• Codex: unter .agents/skills/loop-it/ oder als Codex-Plugin installieren, dann mit $loop-it aufrufen.
• Claude Code: unter .claude/skills/loop-it/ installieren, dann mit /loop-it aufrufen.
• Cursor: unter .cursor/skills/loop-it/ installieren, dann im Agent-Chat mit /loop-it oder durch Fragen nach einer Schleife aufrufen. Verwende Cursor-Regeln für immer aktive Projektkonventionen, nicht für diese prozedurale Schleife.

Beim Exportieren einen kanonischen Schleifenkörper beibehalten und toolspezifische Syntax vermeiden, es sei denn, das Tool erfordert sie.