Agente Sync SSOT: Curación Autónoma de la Deriva Documental
📄 Descargar Edición PDFEl Desafío (Síntoma)
En entornos de desarrollo rápido, es común que la documentación sufra de "Deriva Documental" (Document Drift). Un desarrollador documenta un logro o la deprecación de un sistema en el registro de cambios (bitácora), pero olvida marcar la tarea correspondiente como completada en el plan de proyecto (Roadmap). Esta desconexión destruye la Única Fuente de Verdad (SSOT - Single Source of Truth) del ecosistema.
La Maniobra (Lógica)
Para erradicar este error humano, se desarrolló un Agente de Auto-Sanación (Self-Healing) en Python (merci-ssot.py). Este script extrae de forma automática los últimos registros de la bitácora activa y el estado actual del Roadmap en Markdown.
A continuación, inyecta ambos contextos en un modelo de lenguaje de frontera en la nube (Gemini 1.5 Flash), instruyéndole bajo un System Prompt estricto para que actúe como un auditor semántico. La IA evalúa si las tareas documentadas en la bitácora justifican marcar casillas de verificación (- [x]) en el Roadmap. Si detecta asimetrías, el agente reescribe físicamente el archivo del Roadmap en el disco duro, corrigiendo la deriva documental al instante.
El Aprendizaje / Deuda Técnica
Este agente consolida el paradigma de Document as Code (Documentación como Código). Las herramientas tradicionales (como grep o expresiones regulares) son incapaces de entender que "Se movió el script al Art de Coté" equivale semánticamente a "Deprecar el Agente Bibliotecario".
Delegar el análisis semántico a un modelo de Inteligencia Artificial en la nube es la única forma robusta de sincronizar estados lógicos en texto plano. Se confirma que los modelos locales pequeños carecen del contexto necesario para esta tarea, validando el uso de la API de contingencia (Hybrid Stack) para la curación de la Única Fuente de Verdad.