Guardian es un orquestador del ciclo de vida de software (SDLC) pensado para desarrollo asistido por IA. Su objetivo es transformar una intención de negocio —por ejemplo, "necesito un sistema de registro de auditoría para transacciones financieras reguladas"— en un pipeline de aplicación que bloquea las fusiones de código cuando la implementación rompe la arquitectura definida.
El framework se basa en un único directorio .pi/ donde residen todos los artefactos: módulos, ADRs (registros de decisiones de arquitectura), hojas de ruta, incidencias, scripts de CI y habilidades de agentes. A partir de ese directorio se genera el resto del proyecto, de modo que ningún artefacto se escribe dos veces manualmente y nada se desalinea.
El flujo recorre seis etapas: exploración del dominio, scaffold de módulos de arquitectura, enriquecimiento con contenido DDD (diseño dirigido por el dominio), definición de ADRs y diagramas, adopción de una hoja de ruta por fases, y ejecución por épicas. En cada fase intervienen agentes de IA, pero la revisión y aprobación son humanas. Las decisiones se registran como ADRs (por ejemplo, "usar HMAC-SHA256 con canonización JCS" o "paginación por cursor").
Guardian también incorpora un modo TDD que genera tests que fallan de forma determinista a partir de los contratos de arquitectura, sin intervención de modelos de lenguaje, y un conjunto de scripts de CI que comprueban la estructura DDD de cada módulo, la separación entre capas y la trazabilidad entre código y arquitectura. Si una dependencia cruza una capa indebida, el merge queda bloqueado.
Como prueba de concepto, el proyecto Rigorix aplicó Guardian para construir 146 312 líneas de Rust en 30 módulos con un único desarrollador a lo largo de 11 días activos, manteniendo la arquitectura validada de forma continua frente a la implementación. Guardian se distribuye bajo licencia MIT.
¿Para qué sirve y quién lo usaría? Equipos que desarrollan software crítico o regulado con asistencia de IA y necesitan evitar que la arquitectura derive respecto al diseño original. También resulta útil para arquitectos y líderes técnicos que quieran un proceso trazable, desde la intención de negocio hasta el merge, con bloqueos automáticos cuando se rompe el contrato arquitectónico. Entre sus limitaciones, el framework asume una organización por bounded contexts al estilo DDD y un pipeline de CI configurable, por lo que requiere cierta madurez de proceso para implantarlo.