Definiciones de agentes portables compiladas a cuatro runtimes

Problema

Cada runtime de agentes de código usa su propio formato de configuración. Mantener el mismo agente en cuatro sitios significa cuatro ficheros que divergen, y descubrir en tiempo de ejecución que un runtime no soporta lo que pedías.

Solución

Una definición declarativa como única fuente de verdad, que atraviesa un pipeline de cinco etapas: parsear, validar si es estructuralmente correcta, lintar si además es buena idea, analizar qué soporta realmente cada runtime de destino, y compilar a su configuración nativa.

La distinción entre validación, lint y análisis de capacidades es deliberada y está documentada como decisión de arquitectura: son tres preguntas distintas y mezclarlas produce errores confusos.

Arquitectura

Decisiones técnicas

• El núcleo no ejecuta agentes ni gestiona worktrees ni UI: alcance cerrado a propósito.
• Contrato CLI/JSON documentado para que otras herramientas construyan encima.
• Modelo de permisos y formato de skills recogidos en ADRs, incluyendo la decisión de usar SKILL.md real en vez de inventar un formato propio.
• Arquitectura hexagonal: dominio aislado, adaptadores por runtime.

Resultado

Núcleo funcionando con documentación de arquitectura, contratos y capacidades, más proyectos de ejemplo: uno de mantenimiento de repositorios y otro con agentes de desarrollo y revisión para SAP Business One.