SUPERLOOPY
GitHub112

Evidence-first-Loop-Harness für Codex und Claude Code

Fertig heißt bewiesen.

Superloopy macht aus einem Prompt einen begrenzten Loop. Zuerst stehen die Kriterien, jedes wird mit einem echten Befehl bewiesen, und erledigt ist die Arbeit erst, wenn die Belege existieren.

Installieren
codex plugin marketplace add https://github.com/beefiker/superloopy
codex plugin add superloopy@beefiker

Im Terminal ausführen, Codex neu starten, Hooks bestätigen.

Danach loopy vor jede Aufgabe schreiben.

Echten Loop ansehenAuf GitHub markieren

01 · So funktioniert’s

Ein Prompt, ein begrenzter Loop. Jeder Schritt hinterlässt eine Datei, die du später öffnen kannst.

  1. 01

    Kriterien

    loop begin macht aus dem Auftrag ein Ziel mit konkreten Abnahmekriterien, bevor Code geändert wird.

  2. 02

    Beweis

    loop prove -- <cmd> führt die Prüfung aus und speichert die komplette Ausgabe als Beleg, bestanden oder nicht.

  3. 03

    Gate

    loop check · loop finish prüft, ob jedes Kriterium einen gültigen Beleg hat. Finish führt die Beweise vor dem Abschluss erneut aus.

  4. 04

    Beleg

    Bericht, Gate-Datei und jede Aufzeichnung liegen unter .superloopy/evidence, direkt neben dem Code.

$ superloopy loop begin --brief "Fix cart total" --mode light
superloopy began: G001 Fix cart total

$ superloopy loop prove -- npm test
superloopy prove: G001/C001 -> fail (.superloopy/evidence/G001-C001-capture.txt)
# Fix: das überzählige „+ 1“ entfernt
$ superloopy loop prove -- npm test
superloopy prove: G001/C001 -> pass (.superloopy/evidence/G001-C001-capture.txt)
$ superloopy loop prove -- node --test total.test.js
superloopy prove: G001/C002 -> pass (.superloopy/evidence/G001-C002-capture.txt)

$ superloopy loop check
superloopy check: ok
Evidence summary: 2 artifact-backed criteria, 0 unresolved, 0 invalid

$ superloopy loop finish
superloopy finish: complete
Echte Ausgabe von Superloopy 0.22.3 bei einem einzeiligen Warenkorb-Bug.

02 · Die Crew

Sechs Rollen, je eine Aufgabe. Mit loopy team wird parallel delegiert. Ein Worker ohne Beleg zählt nicht.

Die Crew im Backend-Guide (Koreanisch)

03 · Skills

Spuren für deine Arbeit. Die Beweisregel gilt in jeder Spur.

  1. 01superloopy-loopDer Evidence-Loop: Kriterien, Beweis, Gate.loopy <task>
  2. 02superloopy-backendVerträge zuerst, bestehende Konventionen, abgesicherte Migrationen.loopy <backend task>
  3. 03superloopy-frontendBildschirm-UIs mit visueller QA als Beleg.$superloopy:superloopy-frontend
  4. 04superloopy-cloneEine Seite per URL nachbauen, mit Spezifikationen und Screenshot-Vergleich.loopy clone <url>
  5. 05superloopy-slidesHTML-Präsentationen und PPTX, visuell geprüft.loopy slides <topic>
  6. 06superloopy-researchRecherche, die zitiert, was wirklich gelesen wurde.loopy <research question>
  7. 07superloopy-doctorInstallation, Hooks und Host-Anbindung prüfen.superloopy doctor
  8. 08humanize-koreanKoreanische Texte, die menschlich klingen, Fakten unverändert.$superloopy:humanize-korean
  9. 09say-it-straightDirekte, knappe Texte ohne Bedeutungsverlust.$superloopy:say-it-straight
  10. 10i-have-adhdHandlungsorientierte Ausgabe, nur auf Wunsch.$superloopy:i-have-adhd

Jeden Skill aufrufen mit $superloopy:<skill> (Codex) · /superloopy:<skill> (Claude Code)

04 · FAQ

Fragen, beantwortet mit Belegen.

Was unterscheidet das von einem sorgfältigen Prompt?

Ein Prompt bittet um Sorgfalt. Superloopy prüft sie: Kriterien stehen vor der Arbeit fest, jedes braucht einen Beleg aus einem Befehl, und Finish führt die Beweise vor dem Abschluss erneut aus.

Wo liegen die Belege?

Im Projekt unter .superloopy/evidence: Befehlsaufzeichnungen, die Gate-Datei und ein Markdown-Bericht. Den Ordner in .gitignore aufnehmen oder den Bericht an einen Pull Request hängen.

Was passiert, wenn der Loop nicht fertig wird?

Er sagt es. Der Bericht nennt die Blockade und behält die bisher gefundenen Belege. Mit aktivem Stop-Hook wird ein festgefahrener Loop als blockiert markiert, nicht als erledigt.

Funktioniert es mit Claude Code?

Ja. Codex und Claude Code bekommen den Loop, die Crew und die Skills. Jeder Host wird einmal eingerichtet.

Agenten sind schnell. Superloopy sorgt dafür, dass fertig bewiesen heißt.

Superloopy installierenDoku lesen