LangChain lanza OpenWiki: documentación viva para que los agentes entiendan el repo sin inflar AGENTS.md

LangChain publicó el 1 de julio de 2026 OpenWiki, un agente open source y CLI para generar y mantener documentación de codebases. El lanzamiento apunta a un dolor bastante concreto: los agentes de coding funcionan mejor cuando entienden el repo, pero los equipos terminan metiendo demasiada documentación dentro de AGENTS.md, CLAUDE.md o instrucciones enormes que nadie mantiene.

OpenWiki propone otro patrón. Genera una wiki del repositorio, actualiza los archivos de instrucciones con una referencia corta y deja que el agente consulte esa documentación cuando la necesita. Es menos "mete todo el contexto en cada corrida" y más "dale al agente una ruta confiable hacia el contexto correcto".

Por qué esto importa para agentes de coding

La mayoría de fallos de un coding agent no vienen de que el modelo ignore sintaxis. Vienen de entender mal el sistema: dónde vive la lógica crítica, qué patrón usa el repo, qué archivos no debería tocar, qué tests validan el cambio y qué convenciones no están escritas en el diff.

Un archivo de instrucciones ayuda, pero tiene un límite. Si lo conviertes en una enciclopedia, cada corrida arrastra contexto muerto. Si lo dejas demasiado corto, el agente vuelve a explorar el repo desde cero o inventa reglas.

OpenWiki intenta equilibrar eso:

• crea documentación inicial con openwiki --init;
• puede actualizar docs existentes con openwiki --update;
• agrega referencias en AGENTS.md o CLAUDE.md;
• soporta proveedores como OpenRouter, Fireworks, Baseten, OpenAI y Anthropic;
• puede trazar corridas en LangSmith si configuras la clave.

El detalle interesante es la actualización

Generar una wiki una vez no resuelve mucho si se pudre en dos semanas. Por eso la pieza de GitHub Action importa: OpenWiki puede correr en schedule, revisar commits desde la última corrida, usar diffs de git y abrir actualizaciones de documentación.

Ese patrón cambia la conversación. La documentación ya no es solo para humanos nuevos en el equipo. Se vuelve infraestructura para agentes: contexto mantenido, recuperable y separado de las instrucciones de comportamiento.

Lo que revisaría antes de usarlo

No instalaría OpenWiki a ciegas en un monorepo sensible. Haría tres pruebas:

1. correrlo en una rama y revisar qué agrega a AGENTS.md o CLAUDE.md;
2. inspeccionar si la wiki revela rutas, secretos o detalles internos que no deberían salir en prompts;
3. medir si las actualizaciones por diff realmente preservan arquitectura y no solo resumen cambios superficiales.

También pondría límites claros: qué carpetas documenta, qué modelo usa, dónde guarda configuración y quién revisa los PRs de documentación. Un agente que documenta mal puede empeorar el contexto de todos los agentes posteriores.