Manifiesto
Construir sistemas agénticos con método, gobierno y claridad.
El manifiesto ADLC define principios comunes para diseñar sistemas agénticos gobernados, agnósticos a las herramientas y guiados por un ciclo de vida explícito.
Manifiesto ADLC
Un pacto de diseño para sistemas agénticos sólidos
Propósito
Definir principios comunes para construir agentes y sistemas agénticos de forma consistente y escalable.
Guardarraíl
El ciclo de vida funciona solo cuando los requisitos superan un control de calidad claro y compartido.
Enfoque
Reutilización, orquestación, independencia de herramientas y cambio gobernado.
Extensión del SDLC
El ADLC está pensado como una extensión del SDLC. Conserva la disciplina del ciclo de vida del software, pero la amplía para cubrir las necesidades específicas de los sistemas agénticos, incluyendo gobernanza, orquestación, control human-in-the-loop y mejora operativa continua.
Posicionamiento
Afirmamos que la delivery agéntica debe estar gobernada de extremo a extremo. La seguridad, la monitorización en runtime y el control operativo son necesarios, pero por sí solos no bastan. El ADLC comienza con la calidad de los requisitos y se extiende a través de orquestación, checkpoints humanos, trazabilidad y mejora operativa continua.
Principios
Tres reglas simples para guiar cada decisión
Partir de requisitos validados
Cada iniciativa parte de requisitos verificados, comprensibles y lo bastante maduros como para reducir ambigüedad y retrabajo.
Garantizar reutilización y orquestación
Los componentes, agentes y capacidades deben diseñarse para ser reutilizados, conectados y orquestados a lo largo del tiempo.
Mantener independencia de las herramientas
Las herramientas ayudan, pero no deben dictar la arquitectura: el proceso y la gobernanza van antes que la herramienta.
Etapa 0
Control de calidad de requisitos
Antes de implementar, el cliente debe contar con un agente dedicado de control de calidad de requisitos. Es fundamental para entrar en el ADLC porque ayuda a escribir requisitos lo más claros posible, para que sean completos, coherentes, trazables y estén listos para la ejecución.
La presencia humana es necesaria aquí para confirmar alcance, intención, significado de negocio y aprobación antes de iniciar el lifecycle.
Ciclo de vida ADLC
De los requisitos a la operación, en un ciclo continuo
Control de calidad de requisitos
La entrada en el ADLC comienza solo cuando un agente dedicado de quality gate ha ayudado al cliente a construir requisitos validados, trazables y suficientemente claros como para guiar implementación, pruebas, gobernanza y entrega sin ambigüedad.
Human in the loop: aprobación obligatoria de la calidad y la intención de los requisitos.
Implementar
Transformar los requisitos aprobados en capacidades concretas, servicios, prompts, flujos, integraciones y componentes reutilizables. Es la fase en la que la intención se convierte en una solución real, estructurada para poder ser revisada, probada, gobernada y evolucionada en el tiempo sin perder coherencia arquitectónica.
Revisar
Revisar la solución en términos de calidad, consistencia, seguridad, mantenibilidad y alineación con los principios del manifiesto antes de avanzar hacia la validación.
Human in the loop: revisión experta, juicio de riesgo y decisión de avanzar.
Probar
Validar comportamiento esperado, casos límite, modos de fallo, fiabilidad y readiness operativa mediante evidencia de pruebas estructurada y criterios de aceptación medibles.
Desplegar
Liberar de forma controlada, observable y repetible, con opciones de rollback, release notes, ownership y evidencias de despliegue claramente definidas.
Human in the loop: autorización de release y responsabilidad sobre el go-live.
Operar
Operar la solución con monitorización, alertas, runbooks, flujos de soporte y checkpoints de gobernanza que mantengan el sistema fiable en condiciones reales.
Human in the loop: gestión de incidentes, escalación y supervisión de gobernanza en producción.
Mejorar
Mejorar continuamente a partir del feedback de producción, incidentes, analítica, aprendizaje del usuario y experiencia de delivery que revelan qué refinar después.
Orquestar
Coordinar agentes, flujos, políticas y capacidades reutilizables en un ecosistema componible que escala más allá de implementaciones aisladas.
ADLC Operating Model
Qué debe producir cada fase para poder gobernarse en la práctica
Condiciones de entrada
Requisitos validados, intención de negocio explícita, ownership asignado y quality gate superado antes de iniciar cualquier build.
Modelo de evidencia
Cada fase debe dejar outputs trazables: decisiones, evidencia de pruebas, aprobaciones, release notes, señales operativas y acciones de mejora.
ADLC en práctica
Cómo el lifecycle se comporta como un bucle infinito gobernado
En la práctica, el ADLC no funciona como una pipeline de una sola dirección. Los equipos entran por el quality gate de requisitos, atraviesan el delivery y vuelven al ciclo a través de operación, mejora y orquestación.
- Los requisitos entran solo tras un quality gate dedicado y una aprobación humana.
- Implementación, revisión y pruebas convierten la intención en una solución gobernada.
- Deploy y operate producen evidencia operativa, no solo salida de release.
- Improve y orchestrate alimentan el siguiente ciclo con aprendizaje, reutilización y coordinación.
Human in the loop checkpoint
Controles de gobernanza
Controles obligatorios para entrar y gobernar el ADLC
Supervisión humana
La supervisión humana es una capa de control obligatoria en el ADLC, especialmente al aprobar requisitos, validar calidad, autorizar releases y gobernar el comportamiento en producción.
Los agentes aceleran y estructuran el trabajo, pero las decisiones críticas y responsables siguen siendo humanas.
Control de calidad de requisitos
El ADLC no puede comenzar sin un quality gate que garantice requisitos claros, completos, trazables y con significado de negocio.
Este gate es fundamental porque determina si la implementación debe empezar o no.
Agentes compartidos
Capacidades reutilizables que sostienen todo el ADLC
Documentation Agent
Produce y actualiza documentación directamente en la base documental oficial, como Confluence y plataformas equivalentes.
Se encarga de ADR, runbooks, onboarding, notas de arquitectura, FAQ y documentación de proceso ligada a eventos reales de delivery.
PR Governance Agent
Da soporte a las pull requests de punta a punta, resumiendo cambios, comprobando políticas, señalando riesgos y proponiendo reviewers.
Ayuda a mantener las revisiones consistentes, trazables y alineadas con los guardarraíles compartidos de ingeniería.
Release Notes Agent
Genera release notes a partir del trabajo integrado, agrupando funcionalidades, fixes, breaking changes, migraciones y notas operativas.
Produce tanto resúmenes técnicos como versiones legibles para audiencias de negocio.
Knowledge Sync Agent
Detecta gaps entre código, tickets, releases y documentación, y luego propone o ejecuta las actualizaciones faltantes.
Mantiene alineadas en el tiempo la realidad del delivery y la base de conocimiento.
Compliance and Traceability Agent
Conecta requisitos, implementaciones, pruebas, documentación y releases en una cadena auditable de evidencias.
Da soporte a quality gates, revisiones y checkpoints de gobernanza a lo largo del lifecycle.
Operational Readiness Agent
Verifica que cada release tenga runbooks, ownership, guías de rollback, alertas y evidencias de readiness operativa.
Ayuda a que los equipos pasen del deploy a una operación estable con menos puntos ciegos.