sudocode: gestión de contexto ligera para agentes de programación

Qué

sudocode es un sistema de gestión de contexto de código abierto y ligero para agentes de programación que vive dentro de un repositorio de software. Está diseñado para equipos y desarrolladores que quieren que los agentes de IA para programación conserven el contexto de las tareas, sigan especificaciones duraderas y coordinen el trabajo a lo largo de esfuerzos de desarrollo más extensos y complejos.

El producto posiciona el repositorio git como una base de datos de contexto distribuida. Su flujo de trabajo se centra en capturar la intención del usuario como especificaciones, convertir esa intención en incidencias para agentes, rastrear las ejecuciones de los agentes y registrar los artefactos resultantes para que el contexto evolucione junto con la base de código en lugar de perderse en historiales temporales de chat.

Características

• Almacenamiento de contexto nativo del repositorio: Almacena el contexto directamente en el repositorio, lo que mantiene las especificaciones, el historial de tareas y el estado de ejecución bajo el control del equipo sin depender de un servicio externo.
• Modelo de contexto de 4 niveles: Organiza el trabajo en Especificaciones, Incidencias, Agentes y Artefactos, ofreciendo a los agentes de programación una forma estructurada de pasar de los requisitos a la ejecución y a los cambios resultantes.
• Formatos duales para humanos y máquinas: Usa Markdown y YAML para edición humana, junto con JSONL y SQLite para procesamiento orientado a máquinas, lo que favorece tanto la capacidad de revisión como la automatización.
• Enlaces bidireccionales y retroenlaces: Conecta especificaciones e incidencias mediante relaciones de grafo con seguimiento automático de retroenlaces, lo que facilita rastrear por qué existe un trabajo y cómo se relaciona.
• Soporte de planificación basado en grafos: Admite ordenamiento topológico, jerarquía y gestión de dependencias para que el trabajo de los agentes pueda secuenciarse con mayor claridad en tareas de varios pasos.
• Bucles de retroalimentación de agentes con auditabilidad mediante git: Permite que los agentes actualicen las especificaciones con hallazgos durante la ejecución, preservando al mismo tiempo un historial auditable mediante el seguimiento de cambios basado en git.

Consejos útiles

• Úsalo cuando el trabajo abarque múltiples sesiones: Este tipo de sistema es más valioso cuando los agentes de programación necesitan continuidad en tareas de largo plazo, transferencias o cambios iterativos de diseño.
• Empieza con especificaciones sólidas: Como el modelo está guiado por especificaciones, la adopción será más fluida si los equipos definen requisitos claros y registros de decisiones antes de esperar una ejecución consistente por parte de los agentes.
• Trata la higiene del repositorio como parte de la implementación: Dado que el contexto vive en archivos versionados, los equipos deberían establecer convenciones para nombrar, vincular y revisar especificaciones e incidencias para evitar desorden.
• Evalúa su encaje con tu flujo de trabajo actual de agentes: Está mejor adaptado a equipos que quieren una coordinación duradera centrada en el repositorio; la página no indica funciones más amplias de gestión de proyectos o gobernanza empresarial.
• Planifica ciclos de revisión humana: La estructura permite que los agentes actualicen el contexto, pero el éxito práctico probablemente dependerá de que los humanos validen los cambios en las especificaciones y la descomposición de tareas.