Docloom genera documentación de API usando un parser AST para validar la salida del LLM
Una herramienta open source combina un analizador de código y un modelo de lenguaje para evitar que la IA documente endpoints inexistentes.
Docloom es una nueva herramienta que resuelve un problema común en el desarrollo de software: la desincronización entre el código y su documentación. El proyecto utiliza un enfoque híbrido donde un parser de árbol sintáctico abstracto (AST) extrae la estructura real de la API y un modelo de lenguaje (LLM) se encarga únicamente de redactar la prosa explcativa.
El autor, Babar Khan, explica que los LLM son excelentes escribiendo, pero propensos a alucinar si se les pide que descifren la lógica del código por sí solos. En su experiencia, una IA generó documentación confiable pero inventó un endpoint que no existía en el repositorio. Para evitar esto, Docloom separa las responsabilidades: el parser lee el código fuente primero y extrae rutas, firmas de funciones, parámetros y tipos. El LLM no tiene acceso directo al código para descubrir nada; solo recibe los datos estructurados que el parser ya halló y debe describirlos textualmente. Si el modelo intenta inventar algo, el sistema lo descarta porque no coincide con la fuente de código.
El flujo de trabajo incluye una verificación de hechos donde cada afirmación generada se contrasta con el origen antes de publicarse. Además, tras un merge, la herramienta muestra un diff de los cambios en la documentación y requiere la aprobación explícita del desarrollador antes de que nada se active. Esto impide que la documentación se actualice automáticamente sin revisión, un error frecuente en pipelines automatizados.
En cuanto a la seguridad, Docloom opera como una GitHub App con permisos de solo lectura sobre el contenido y los metadatos. El código se procesa en memoria y no se almacena en servidores externos, lo que permite a los equipos mantener el control sobre qué repositorios exponen al servicio. Puede instalarse selectivamente en los proyectos deseados.
La herramienta es gratuita y no requiere tarjeta de crédito para probarla. El desarrollo está siendo realizado por una única persona, quien busca retroalimentación para identificar puntos de fallo en diferentes stacks tecnológicos.