Third Thoughts

Lightless Labs の研究プロジェクト。学際的なコーパス分析を通じて AI エージェントの行動を大規模に研究します(要するに、壁に物を投げて、何がくっつくかを見ているだけです)。

ディスクワールドのティファニー・エイチングの概念にちなんで命名:first thoughts(エージェントが考えること)、second thoughts(エージェントが自分の思考を分析すること)、third thoughts(このプロジェクトがその思考を分析すること)。

このリポジトリの内容

Third Thoughts には、コーパスと方法論を共有する 2 つの部分があります:

1. middens/ — AI エージェントのセッションログから行動パターンを抽出する Rust CLI。Claude Code、Codex、OpenClaw、Pi コーディングエージェントのセッション(Gemini スタブ)のトランスクリプトを解析し、メッセージとセッションを分類して、23 種類の分析手法(Rust ネイティブ 6 種 + Python 17 種、組み込み Python ブリッジ経由でバンドル)を実行します。CLI には 3 つのコアコマンドがあります:analyze(手法を実行 → Parquet ストレージ)、interpret(LLM による手法横断的なナラティブ生成)、export(Jupyter ノートブック)。middens/README.md を参照してください。
2. 研究成果物 — docs/ にある手法カタログ、自然言語仕様、再現研究、文書化された調査結果。ここに科学的な主張が置かれています。

コーパス自体(corpus/、experiments/)は gitignore されています — セッションにはプライベートデータが含まれており、再配布できません。ツールと方法論はオープンですが、生データはオープンではありません。

主要な調査結果

複合スコープルール: 思考またはテキスト行動に関する主要な調査結果は、session_type、thinking_visibility、language、時間ウィンドウという 4 つの軸をすべて耐え抜く必要があります。4 つすべてを耐え抜けない調査結果は調査結果ではありません。詳細は CLAUDE.md と docs/HANDOFF.md を参照してください。

リポジトリ構成

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

Gitignore 対象:corpus/、corpus-full/、corpus-split/、corpus-frozen/、experiments/、data/labeled-messages.json。

はじめに

macOS または Linux で Homebrew を使用して CLI をインストール:

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

Homebrew を使用しない Linux では、リリース tarball を直接取得:

# 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 は現在、Apple Silicon macOS、x86_64 Linux、arm64 Linux 向けのバイナリを提供しています。すでに Homebrew を使用している場合は、Homebrew が最も簡単な方法です。リリース tarball とソースからのビルドは middens/README.md に記載されています。

自分のセッションログで CLI を実行したい場合は、middens/ へ。方法論と調査結果について読みたい場合は、docs/methods-catalog.md と docs/reports/ 配下のレポートから始めてください。

エージェントセッションのアーカイブ

middens archive は、ベンダーや保持ポリシー、あるいはあなた自身の深夜のクリーンアップ衝動によってローカルのエージェント JSONL ログが消えてしまう前に、それらをプライベートなコンテンツアドレス型アーカイブへコピーします。生のトランスクリプトを保存するため、アーカイブルートはプライベートデータとして扱ってください:

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

自己完結型の自動化プラグインは integrations/ 配下にあり、PATH 上の middens バイナリを必要としません:

• integrations/pi/middens-archive/ — /middens-archive-now と /middens-archive-status を備えた Pi 拡張機能。
• integrations/claude-code/middens-archive/ — Claude Code フックと /middens-archive-now。
• integrations/codex/middens-archive/ — Codex フックとアーカイブスキル。

3 つすべてに明示的な MIDDENS_ARCHIVE_ROOT が必要です。デフォルトのアーカイブパスは用意されません。予期しない生トランスクリプトフォルダは不作法だからです。

ライセンス

AGPL-3.0-or-later。LICENSE を参照してください。