Artificial Intelligence Software Development Life Cycle

Desarrollo guiado
por IA.

Este sitio es una guía operativa para que equipos de desarrollo adopten IA de forma disciplinada, sin perder calidad ni control técnico. No se trata de usar herramientas por separado: es una metodología completa que ordena cómo el equipo toma decisiones, genera artefactos y construye software con IA en cada etapa del ciclo.

🎯
Propósito. Enseñar y orientar al equipo — y a otros equipos que quieran adoptar este modelo — sobre cómo trabajar con IA de forma estructurada. Incluye metodología, plantillas, convenciones, casos de uso, antipatrones y laboratorios prácticos para llevar a la práctica cada concepto.
Bases metodológicas que sustentan este modelo
SDLC guiado por especificaciones

El proceso completo

Cada etapa produce artefactos que alimentan la siguiente. La IA actúa en cada fase, pero los humanos controlan las decisiones críticas.

Flujo Jira recomendado

👤Backlog
→
👤Ready for Spec
→
🤝Spec Draft
→
👤Spec Approved
→
🤝In Development
→
👤PR Created
→
🤝Code Review
→
⚙️Ready for Deploy
→
👤Done ✓
👤Humano
🤖IA
🤝IA + Humano
⚙️Automático / Pipeline

Métricas DORA

El marco de referencia para medir el desempeño de ingeniería de alto rendimiento.

DF
Deployment Frequency
Frecuencia de despliegues a producción. Elite: varias veces al día.
GitHub Actions · Azure
LT
Lead Time for Changes
Desde el primer commit hasta producción. Elite: menos de 1 hora.
Jira · GitHub
CFR
Change Failure Rate
% de cambios que provocan degradación. Elite: menos de 5%.
New Relic · GitHub Actions
MTTR
Mean Time to Restore
Tiempo para restaurar el servicio tras un incidente. Elite: menos de 1h.
New Relic · Cloudflare
Vista integral del stack

Arquitectura y stack para scaleup de IA moderna

Click en cualquier componente para ver descripción, propósito, cuándo se usa y si la intervención es humana o de IA.

Arquitectura lógica de la plataforma
Aplicación · Microservicios
🔄
n8n — Automatización & Workflows
Flujos de negocio, integraciones, agentes, tareas programadas
Observabilidad
Seguridad
Flujo de desarrollo AI-Native
Capas transversales — Gobierno, calidad y escalabilidad
Intervención humana
Intervención IA
Mixto / Asistido
Continuo / 24-7
Tu stack actual

Herramientas por capa

Cada herramienta tiene un rol preciso en el proceso. La clave no es tener más herramientas, sino saber cuándo y cómo usarlas dentro del flujo metodológico.

Casos de uso reales

El stack en acción

Así se mueven las herramientas a través del proceso en cada escenario del equipo.

Artefactos

Plantillas listas para usar

Copia, adapta y versiona en Confluence y GitHub. La consistencia entre artefactos es lo que permite que la IA entienda el contexto del proyecto.

Fundamentos

Principios del desarrollo guiado por IA

Estas reglas son las que separan a los equipos que usan IA como una calculadora de los que la integran como parte del proceso de ingeniería.

Cobertura del stack actual

Evolución

Niveles de madurez IA

El objetivo no es llegar al nivel 3 inmediatamente. Es avanzar de forma deliberada, asentando cada nivel antes de continuar.

Roadmap de mejoras — tu stack

Nivel 3 — Futuro cercano

Arquitectura multi-agente

La evolución natural: en lugar de un agente que hace todo, múltiples agentes especializados colaboran orquestados por la especificación.

📄 SPEC estructurada
Confluence + Claude
↓
🧠 Product Owner Agent
Valida requerimientos, criterios de aceptación
↓
🏗️ Architect Agent
ADRs, diagramas C4, contratos de API
↓
💻 Developer Agent
Windsurf Cascade + Claude Code
↓
🧪 Tester Agent
Genera unit, E2E, edge cases
↓
🔍 Reviewer Agent
Seguridad, convenciones, PR review
↓
📊 Ops Agent
New Relic + n8n + runbooks automáticos

Herramientas de orquestación

Orquestación de agentes
LangGraph
Flujos multi-agente con estado persistente. Permite agentes cíclicos y supervisión humana en loops.
langchain-ai.github.io/langgraph
Colaboración de agentes
AutoGen
Agentes conversacionales de Microsoft. Fácil integración con herramientas externas y human-in-the-loop.
github.com/microsoft/autogen
Equipos de agentes
CrewAI
Define roles, objetivos y memoria compartida entre agentes. Natural para simular roles del equipo de desarrollo.
docs.crewai.com
Integración en tu stack
n8n + Agentes
Ya tienes n8n. El siguiente paso es convertir workflows en agentes reactivos que se disparan por eventos de GitHub, Jira o New Relic.
docs.n8n.io
Estándares del equipo

Convenciones y acuerdos de trabajo

Las convenciones no son burocracia: son el lenguaje común que permite que la IA entienda el repositorio y que el equipo trabaje sin fricción.

DevSecOps

Seguridad en el ciclo de desarrollo

La seguridad no es una etapa al final. Es una práctica que se aplica desde el IDE hasta producción — shift-left security.

Errores frecuentes

Antipatrones del desarrollo con IA

Los errores que cometen casi todos los equipos cuando adoptan IA sin metodología. Identificarlos es el primer paso para evitarlos.

Ejercicios prácticos

Laboratorios de aprendizaje

Ejercicios concretos para que el equipo practique la metodología. Cada lab tiene objetivo, duración estimada y entregable esperado.

Vocabulario técnico

Glosario del AI-SDLC

Los términos que el equipo debe conocer para trabajar con esta metodología. Sin lenguaje común, las conversaciones son más lentas y los malentendidos más frecuentes.

Preguntas frecuentes

FAQ — Dudas comunes del equipo

Las preguntas que surgen siempre cuando un equipo adopta desarrollo guiado por IA. Respuestas directas, sin rodeos.