Third Thoughts

Ein Forschungsprojekt von Lightless Labs, das das Verhalten von KI-Agenten im großen Maßstab durch multidisziplinäre Korpusanalyse untersucht (im Grunde: Dinge an die Wand werfen und schauen, was hängen bleibt).

Benannt nach Tiffany Achings Konzept aus der Scheibenwelt: erste Gedanken (Agenten denken), zweite Gedanken (Agenten analysieren ihr Denken), dritte Gedanken (dieses Projekt analysiert das).

Was in diesem Repository steckt

Third Thoughts besteht aus zwei Teilen, die sich einen Korpus und eine Methodik teilen:

1. middens/ — eine Rust-CLI zur Extraktion von Verhaltensmustern aus Sitzungsprotokollen von KI-Agenten. Analysiert Transkripte von Claude-Code-, Codex-, OpenClaw- und Pi-Coding-Agenten-Sitzungen (Gemini-Stub), klassifiziert Nachrichten und Sitzungen und führt eine Batterie von 23 Analysetechniken aus (6 Rust-nativ + 17 Python, gebündelt über eine eingebettete Python-Brücke). Die CLI hat drei Kernbefehle: analyze (Techniken ausführen → Parquet-Speicherung), interpret (LLM-gestützte technikübergreifende Narrative) und export (Jupyter-Notebook). Siehe middens/README.md.
2. Forschungsartefakte — Methodenkatalog, natürlichsprachliche Spezifikationen, Replikationsstudien und dokumentierte Ergebnisse in docs/. Hier liegen die wissenschaftlichen Aussagen.

Der Korpus selbst (corpus/, experiments/) ist gitignored — die Sitzungen enthalten private Daten und dürfen nicht weitergegeben werden. Die Werkzeuge und die Methodik sind offen; die Rohdaten nicht.

Zentrale Ergebnisse

Zusammengesetzte Abgrenzungsregel: Jedes zentrale Ergebnis zum Denk- oder Textverhalten muss vier Achsen überstehen — session_type, thinking_visibility, language und ein zeitliches Fenster. Ein Ergebnis, das nicht alle vier übersteht, ist kein Ergebnis. Mehr Kontext in CLAUDE.md und docs/HANDOFF.md.

Repository-Struktur

middens/              Rust CLI — parser, classifiers, techniques, Python bridge
docs/
  HANDOFF.md          Session-continuity document, read this first
  methods-catalog.md  20 method families, 80+ references
  examples/           Worked examples for the CLI triad workflow
  nlspecs/            Natural-language specs (Why / What / How / Done)
  reports/            Research reports
  reviews/            Multi-model peer reviews
  brainstorms/        Requirements docs
  plans/              Implementation plans
  solutions/          Institutional knowledge — documented learnings
scripts/              Python analytical battery (26 scripts, mostly superseded by middens)
todos/                Individual todo files with YAML frontmatter

Per .gitignore ausgeschlossen: corpus/, corpus-full/, corpus-split/, corpus-frozen/, experiments/, data/labeled-messages.json.

Erste Schritte

Installiere die CLI mit Homebrew unter macOS oder Linux:

brew install lightless-labs/tap/middens
middens --help

Unter Linux ohne Homebrew lade das Release-Tarball direkt herunter:

# x86_64 Linux
curl -LO https://github.com/Lightless-Labs/third-thoughts/releases/download/v0.0.1-beta.4/middens-0.0.1-beta.4-x86_64-unknown-linux-gnu.tar.gz
tar xzf middens-0.0.1-beta.4-x86_64-unknown-linux-gnu.tar.gz
./middens-0.0.1-beta.4-x86_64-unknown-linux-gnu/middens --help

middens liefert derzeit Binärdateien für Apple-Silicon-macOS, x86_64-Linux und arm64-Linux. Homebrew ist der einfachste Weg, wenn du es bereits nutzt; Release-Tarballs und Builds aus dem Quellcode sind in middens/README.md dokumentiert.

Wenn du die CLI mit deinen eigenen Sitzungsprotokollen ausführen möchtest, schau in middens/. Wenn du dich über die Methodik und die Ergebnisse informieren möchtest, beginne mit docs/methods-catalog.md und den Berichten unter docs/reports/.

Agentensitzungen archivieren

middens archive kopiert lokale JSONL-Protokolle von Agenten in ein privates, inhaltsadressiertes Archiv, bevor Anbieter, Aufbewahrungsrichtlinien oder deine eigenen nächtlichen Aufräumimpulse sie verschwinden lassen. Es speichert rohe Transkripte — behandle das Archivverzeichnis daher als private Daten:

middens archive --to ~/agent-session-archive --dry-run
middens archive --to ~/agent-session-archive --yes

In sich geschlossene Automatisierungs-Plugins liegen unter integrations/ und benötigen die middens-Binärdatei nicht im PATH:

• integrations/pi/middens-archive/ — Pi-Erweiterung mit /middens-archive-now und /middens-archive-status.
• integrations/claude-code/middens-archive/ — Claude-Code-Hooks plus /middens-archive-now.
• integrations/codex/middens-archive/ — Codex-Hooks plus Archivierungs-Skills.

Alle drei benötigen ein explizites MIDDENS_ARCHIVE_ROOT; es wird kein Standard-Archivpfad für dich gewählt, denn überraschende Ordner mit rohen Transkripten sind unhöflich.

Lizenz

AGPL-3.0-or-later. Siehe LICENSE.