Terceros Pensamientos

Un proyecto de investigación de Lightless Labs que estudia el comportamiento de los agentes de IA a escala mediante análisis multidisciplinario de corpus (básicamente, lanzando cosas contra la pared y viendo qué se queda pegado).

Nombrado a partir del concepto de Tiffany Aching de Mundodisco: primeros pensamientos (los agentes piensan), segundos pensamientos (los agentes analizan su pensamiento), terceros pensamientos (este proyecto analizando eso).

Qué contiene este repositorio

Terceros Pensamientos tiene dos mitades que comparten un corpus y una metodología:

1. middens/ — una CLI de Rust para extraer patrones de comportamiento de los registros de sesiones de agentes de IA. Analiza transcripciones de sesiones de agentes de codificación de Claude Code, Codex, OpenClaw y Pi (stub de Gemini), clasifica mensajes y sesiones, y ejecuta una batería de 23 técnicas analíticas (6 nativas de Rust + 17 de Python, empaquetadas mediante un puente de Python integrado). La CLI tiene tres comandos principales: analyze (ejecuta técnicas → almacenamiento Parquet), interpret (narrativa entre técnicas impulsada por LLM) y export (notebook de Jupyter). Consulta middens/README.md.
2. Artefactos de investigación — catálogo de métodos, especificaciones en lenguaje natural, estudios de replicación y hallazgos documentados en docs/. Aquí es donde viven las afirmaciones científicas.

El corpus en sí (corpus/, experiments/) está en gitignore — las sesiones contienen datos privados y no pueden redistribuirse. Las herramientas y la metodología son abiertas; los datos sin procesar no lo son.

Hallazgos principales

Regla de alcance compuesta: cualquier hallazgo principal sobre el pensamiento o el comportamiento del texto debe sobrevivir cuatro ejes — session_type, thinking_visibility, language, y una ventana temporal. Un hallazgo que no sobrevive los cuatro no es un hallazgo. Más contexto en CLAUDE.md y docs/HANDOFF.md.

Estructura del repositorio

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

Ignorado por git: corpus/, corpus-full/, corpus-split/, corpus-frozen/, experiments/, data/labeled-messages.json.

Primeros pasos

Instala la CLI con Homebrew en macOS o Linux:

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

En Linux sin Homebrew, descarga el tarball de la versión directamente:

# 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 actualmente distribuye binarios para macOS con Apple Silicon, Linux x86_64 y Linux arm64. Homebrew es la vía más fácil si ya lo usas; los tarballs de las versiones y las compilaciones desde el código fuente están documentados en middens/README.md.

Si quieres ejecutar la CLI sobre tus propios registros de sesiones, dirígete a middens/. Si quieres leer sobre la metodología y los hallazgos, empieza por docs/methods-catalog.md y los informes en docs/reports/.

Archivado de sesiones de agentes

middens archive copia los registros JSONL locales de los agentes a un archivo privado y direccionado por contenido antes de que los proveedores, las políticas de retención o tus propios impulsos de limpieza de madrugada los hagan desaparecer. Almacena transcripciones sin procesar, así que trata la raíz del archivo como datos privados:

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

Los plugins de automatización autocontenidos viven en integrations/ y no requieren el binario middens en el PATH:

• integrations/pi/middens-archive/ — extensión de Pi con /middens-archive-now y /middens-archive-status.
• integrations/claude-code/middens-archive/ — hooks de Claude Code más /middens-archive-now.
• integrations/codex/middens-archive/ — hooks de Codex más habilidades de archivado.

Los tres requieren un MIDDENS_ARCHIVE_ROOT explícito; no se elige ninguna ruta de archivo predeterminada por ti, porque las carpetas sorpresa de transcripciones sin procesar son de mala educación.

Licencia

AGPL-3.0-or-later. Consulta LICENSE.