WorkBraid: diffs visuales de arquitectura para cambios propuestos por agentes
WorkBraid presenta los cambios arquitectónicos propuestos por agentes como diagramas visuales y permite revisarlos antes de fusionarlos en Git.
WorkBraid es una herramienta local que convierte los cambios de arquitectura propuestos por agentes de código en diagramas diferenciales. El proyecto está disponible en GitHub. En lugar de revisar cientos de líneas de diff, el humano ve un gráfico con el estado antes y después, y puede aprobar o rechazar el cambio. Todo queda registrado en un repositorio Git con el JSON del parche y una imagen renderizada.
La herramienta expone una interfaz de línea de comandos (CLI) y un servidor MCP. El servidor permite a los agentes enviar cambios estructurados, consultar el estado actual de la arquitectura y listar propuestas pendientes. El CLI cubre las mismas operaciones para uso manual. Ambos acceden al mismo repositorio Git, por lo que los cambios quedan versionados y auditables.
La arquitectura se representa como un grafo de nodos (servicios, bases de datos, colas) y aristas (llamadas a API, flujos de datos). Cuando un agente quiere modificar algo, envía un objeto JSON con la operación correspondiente; WorkBraid aplica el parche, genera el diagrama diferencial y lo escribe en Git. Cada nodo y arista incluye metadatos como destino de despliegue o protocolo.
El manejo de conflictos se hace a nivel de nodo o arista, no de archivo. Si un humano y un agente tocan a la vez el mismo componente, WorkBraid genera una comparación de tres vías (base, humana, agente) en el editor visual. Es más simple que los conflictos de archivos porque un nodo tiene pocas propiedades, frente a las cientos de líneas de un archivo fuente.
En el flujo típico, el agente llama a get_current_state, analiza el grafo y envía una propuesta con propose_change. Luego consulta list_pending_proposals hasta que alguien la aprueba. El humano, por su parte, usa el editor visual para aceptar o solicitar cambios. El agente nunca interactúa con el diagrama; el humano nunca escribe JSON.
Entre sus carencias, WorkBraid aún no ofrece métricas sobre tasas de aceptación ni registros de auditoría detallados. Además, si alguien modifica la arquitectura fuera del flujo, el diagrama puede quedarse obsoleto. Para uso en equipo, cada desarrollador ejecuta su instancia y comparte un remoto Git común.
