Communitygithub.com

brnyxx/xout

Unverwünschtes KI-Verhalten endgültig ausmerzen – ein falsifikationsbasierter CLAUDE.md/AGENTS.md-Kompiler mit Beweisbelegen

Was ist xout?

xout ist ein Werkzeug, um unerwünschtes KI-Verhalten durch Falsifikation zu eliminieren. Es legt dem Benutzer klar definierte Verhaltenspaare (A/B-Tests) vor, statt ihn zu befragen. Der Benutzer entscheidet dann durch das einfache Setzen eines „X“ – der einzigen Handlung, die ihm abverlangt wird – welche Variante er ablehnt. Auf diese Weise wird der Konfigurationsraum (8 Achsen, 6.561 Kombinationen) von Claude Code effizient erschlossen. xout läuft vollständig lokal ohne externe Netzwerkaufrufe oder LLM-Anfragen während der Session. Alle Fortschritte werden in einem lokalen, append-only Ereignisprotokoll festgehalten. Es unterstützt Claude Code und erzeugt eine CLAUDE.md mit einer einzigen @import-Zeile, die präzise die gewünschten Verhaltensänderungen aktiviert. Die Ergebnisse sind reproduzierbar und werden durch ein Prüfsystem (probe) mit externen Ausführern validiert. Das Tool folgt strengen Regeln: Es nimmt dem Benutzer keine Entscheidungen ab, bearbeitet keine Konfigurationsdateien direkt und zeigt die Verhaltensbeschreibungen unverändert an. Sessions können pausiert und später fortgesetzt werden, auch über verschiedene Geräte hinweg.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add brnyxx/xout
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

xout – X-Session

xout legt Ihnen anstelle von Fragen widerlegbare Vergleichspaare vor. Ihre einzige Aktion ist das Setzen eines "X", wodurch der Claude Code-Konfigurationsraum (8-Achsen-Hypothesenraum, 6.561 Kombinationen) konvergiert wird. Die Session-Laufzeit benötigt 0 LLM-Aufrufe und 0 externe Netzwerkaufrufe – der gesamte Fortschritt wird in einem lokalen Append-Only-Ereignisprotokoll festgehalten.

Ausführungsregeln

Vor jeder Session muss zwingend python3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" status ausgeführt werden, um auf ein Banner mit Wiedervorlage-Wartezeit zu prüfen. Existiert ein solches Banner, wird es dem Benutzer in einer einzigen Zeile mitgeteilt.

Die Session läuft im interaktiven (Chat-)Modus:

  1. Führen Sie python3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" pair aus, um JSON zu erhalten. Wichtig sind pair.left_text, pair.right_text und pair.pair_id.
  2. Zeigen Sie dem Benutzer beide Verhaltensbeschreibungen exakt so an und fragen Sie, auf welches er ein X setzen möchte.
  3. Nur die explizite Wahl des Benutzers wird mit python3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" strike <left|right|both|pair> --pair-id <pair_id> protokolliert.
  4. Wiederholen Sie die Schritte 1–3, bis session_complete im Antwort-JSON true ist.
  5. Zeigen Sie nach Abschluss die 8 Zeilen der rules an und fragen Sie, ob sie angewendet werden sollen. Führen Sie enable --grant nur bei expliziter Zustimmung aus.

Wenn der Benutzer die Session direkt im Terminal durchführen möchte, weisen Sie ihn auf den Befehl xout (oder uvx xout) hin – da dasselbe Protokoll verwendet wird, kann die Session unterbrochen und später nahtlos fortgesetzt werden.

ParameterAusführungBefehlBeschreibung
(keiner) oder chatVordergrundschleifeInteraktive Schleife (pair → Benutzerauswahl → strike)Setzt unvollständige Session fort oder startet neue 15-Strike-Session
statusVordergrundausgabepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" statusZusammenfassung: Landung/Aktivierung/Fortsetzung/Urteil
sessionsVordergrundausgabepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" sessionsListe der letzten Sessions
doctorVordergrundausgabepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" doctorLokale Diagnose von Installation, Daten und Wiedergabe
enableVordergrundausgabepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" enable --grantFügt auf explizite Anfrage eine einzige @import-Zeile zur CLAUDE.md hinzu
undo oder rollbackVordergrundausgabepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/xout_plugin.py" undoEntfernt ausschließlich die von xout hinzugefügte @import-Zeile

Wenn die Statusausgabe ein Banner mit "N Wiedervorlagen anstehend" enthält

Teilen Sie dem Benutzer vor Session-Beginn den Bannerinhalt in einer Zeile mit und weisen Sie darauf hin, dass er im Terminal mit xout recheck in die Wiedervorlage einsteigen kann. Die Entscheidung zur Annahme liegt allein beim Benutzer – treffen Sie keine Entscheidung für ihn.

Nach Session-Ende

  • Die Ergebnisse landen ausschließlich im Verzeichnis ~/.claude/xout/ (XOUT.md + manifest.json + settings.xout.json).
  • Die Aktivierung in der CLAUDE.md des Benutzers erfolgt ausschließlich über enable --grant des Launchers, der nur eine einzige @import-Zeile hinzufügt. Führen Sie dies nur bei expliziter Zustimmung des Benutzers aus.
  • Für einen Rollback verwenden Sie ebenfalls nur den Befehl undo des Launchers (entfernt ausschließlich diese Zeile).
  • Vor der Aktivierung kann mit conflicts [Pfad] geprüft werden, ob Konflikte mit Projektregeldateien (CLAUDE.md/AGENTS.md/.cursorrules) bestehen. Die Konflikte werden als file:line angezeigt. Bei direkten Konflikten hat die Projektregel Vorrang – dies ist bereits in der XOUT.md-Präambel festgelegt.
  • Ob die Regeln tatsächlich die Auswahl beeinflussen, misst probe – ein Opt-in-Befehl, der einen externen Ausführer (standardmäßig claude -p) außerhalb der Session aufruft. Dies wird nur auf Benutzeranfrage ausgeführt. Die Belege verbleiben ausschließlich in ~/.claude/xout/probes/.

Verbotenes

  • Setzen Sie kein X für den Benutzer – das X ist der Falsifikationsakt des Benutzers.
  • Bearbeiten Sie weder die CLAUDE.md noch die settings.json direkt – dies verletzt den xout-Eigentumsvertrag.
  • Fassen Sie die Paartexte nicht zusammen oder zeigen Sie sie bearbeitet an – der Originaltext ist das Messinstrument.

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community