세 번째 생각

Lightless Labs의 연구 프로젝트로, 다학제적 코퍼스 분석을 통해 AI 에이전트 행동을 대규모로 연구합니다 (기본적으로, 벽에 던져서 무엇이 붙는지 보는 것입니다).

디스크월드의 티파니 애칭 개념에서 이름을 따왔습니다: 첫 번째 생각(에이전트가 생각함), 두 번째 생각(에이전트가 자신의 생각을 분석함), 세 번째 생각(이 프로젝트가 그것을 분석함).

이 리포지토리의 내용

Third Thoughts는 코퍼스와 방법론을 공유하는 두 부분으로 구성됩니다:

1. middens/ — AI 에이전트 세션 로그에서 행동 패턴을 추출하는 Rust CLI입니다. Claude Code, Codex, OpenClaw, Pi 코딩 에이전트 세션(제미니 스텁)의 트랜스크립트를 파싱하고, 메시지와 세션을 분류하며, 23가지 분석 기법(6개 Rust 네이티브 + 17개 Python, 임베디드 Python 브리지를 통해 번들)을 실행합니다. CLI에는 세 가지 핵심 명령어가 있습니다: analyze(기법 실행 → Parquet 저장), interpret(LLM 기반 교차 기법 내러티브), export(Jupyter 노트북). middens/README.md를 참조하세요.
2. 연구 결과물 — docs/에 있는 방법 카탈로그, 자연어 명세, 복제 연구, 문서화된 결과입니다. 과학적 주장이 여기에 있습니다.

코퍼스 자체(corpus/, experiments/)는 gitignored입니다 — 세션에 개인 데이터가 포함되어 재배포할 수 없습니다. 도구와 방법론은 공개되어 있지만, 원시 데이터는 그렇지 않습니다.

주요 발견 사항

복합 범위 규칙: 사고 또는 텍스트 행동에 대한 주요 발견은 네 가지 축 — session_type, thinking_visibility, language, 시간적 창 — 을 모두 견뎌야 합니다. 네 가지를 모두 견디지 못한 발견은 발견이 아닙니다. 자세한 내용은 CLAUDE.md와 docs/HANDOFF.md에 있습니다.

리포지토리 구성

middens/              Rust CLI — 파서, 분류기, 기법, Python 브리지
docs/
  HANDOFF.md          세션 연속성 문서, 먼저 읽으세요
  methods-catalog.md  20개 방법 계열, 80개 이상의 참고 자료
  examples/           CLI 트라이어드 워크플로우에 대한 실습 예제
  nlspecs/            자연어 명세 (이유 / 대상 / 방법 / 완료)
  reports/            연구 보고서
  reviews/            다중 모델 동료 검토
  brainstorms/        요구사항 문서
  plans/              구현 계획
  solutions/          기관 지식 — 문서화된 학습 내용
scripts/              Python 분석 배터리 (26개 스크립트, 대부분 middens로 대체됨)
todos/                YAML 프론트매터가 있는 개별 할일 파일

Gitignored: 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에서는 릴리스 타르볼을 직접 받으세요:

# 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가 가장 쉬운 방법입니다. 릴리스 타르볼과 소스 빌드는 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 훅과 아카이브 스킬.

세 가지 모두 명시적인 MIDDENS_ARCHIVE_ROOT가 필요합니다; 기본 아카이브 경로가 선택되지 않습니다. 예상치 못한 원시 트랜스크립트 폴더는 무례하기 때문입니다.

라이선스

AGPL-3.0-or-later. LICENSE를 참조하세요.