Guía práctica

Construye con AI-DLC

El lifecycle de desarrollo AI-nativo que pone la inteligencia artificial al centro del proceso y a los humanos al mando de las decisiones.

3
Fases del ciclo
10
Principios guía
~Hrs
Ciclos (no semanas)
Fundamentos

¿Qué es AI-DLC?

Un lifecycle de desarrollo reimaginado para la era de la inteligencia artificial. No es un add-on. Es un nuevo sistema operativo para construir software.

🧩

El problema que resuelve

Los equipos usan AI de forma fragmentada: un prompt por aquí, un copilot por allá. AI-DLC estructura ese uso en un flujo completo, desde la intención hasta el deploy.

Por qué existe

Los lifecycles tradicionales (Waterfall, Agile) asumen roles fijos, handoffs secuenciales y checkpoints manuales. La AI rompe esas suposiciones. Necesitamos un modelo nuevo.

🔄

Cómo cambia todo

AI propone → Humanos validan → AI refina → Humanos aprueban. Es un ciclo continuo donde AI hace el trabajo pesado y tú diriges la estrategia.

Modelo mental de AI-DLC

Intención humana AI propone plan Humanos validan AI implementa Humanos aprueban

Este patrón se repite en cada fase y en cada paso del desarrollo.

SDLC Tradicional

Humanos escriben requisitos, diseñan, codifican, testean y despliegan. La AI es una herramienta más que espera instrucciones.

AI-DLC

Humanos definen intención. AI genera requisitos, diseña, codifica y testea. Humanos validan, corrigen y aprueban en cada paso.

10 minutos

Quick Start

De cero a tu primera app AI-DLC. Sigue estos pasos y tendrás un proyecto funcional corriendo.

⚠️ Si Kiro te ofrece una “spec session”, responde NO

Mientras trabajas, en algún momento Kiro puede mostrarte exactamente esto:

·· Kiro

“I see you’re working on a task that’s optimized for spec sessions. Would you like to start a dedicated spec session for the best experience?”

Tu respuesta es siempre No. AI-DLC fue diseñado para operar exclusivamente con Vibe Coding: no se generan, mantienen ni usan especificaciones formales (Spec-Driven Design) como parte del flujo. Si Kiro pregunta si habilitar, adoptar o migrar a Spec mode en cualquier momento, continúa siempre bajo Vibe Coding.

Setup

AI-DLC desde tu IDE

Puedes usar AI-DLC desde prácticamente cualquier IDE moderno. Kiro es la experiencia nativa, pero el proceso funciona en cualquiera.

Arquitectura

Estructura de proyecto

Un proyecto AI-DLC tiene dos carpetas clave que cumplen roles muy diferentes. Entender esta separación es lo más importante para no confundirte.

PASO 1 — SETUP
⚙️ .kiro/
Las REGLAS del juego

Contiene las steering rules que enseñan a tu IDE cómo seguir el proceso AI-DLC. Las descargas una sola vez desde GitHub y las copias a tu proyecto.

¿Quién la crea?Tú (manual, una vez)
¿Cuándo se modifica?Casi nunca
¿Qué contiene?Instrucciones para la AI
¿La editas tú?Solo para personalizar
PASO 2 — EJECUCIÓN
📁 aidlc-docs/
Los RESULTADOS del trabajo

La AI crea esta carpeta y todos sus archivos automáticamente mientras trabajas. Cada vez que respondes una pregunta o apruebas un paso, aquí aparecen nuevos .md.

¿Quién la crea?La AI (automático)
¿Cuándo se modifica?Constantemente
¿Qué contiene?Todo el trabajo del proyecto
¿La editas tú?Solo lees y revisas

Cómo interactúan entre sí

👤
Tú escribes
"Using AI-DLC..."
🧠
El IDE lee
.kiro/
La AI sigue
las reglas
📝
Escribe en
aidlc-docs/

El IDE consulta .kiro/ en cada paso para saber qué hacer, y va escribiendo todos los resultados (preguntas, historias, diseños, planes) en aidlc-docs/. Tú nunca creas estos archivos a mano.

La estructura completa

Estructura típica de un proyecto AI-DLC
mi-proyecto/
│
├── .kiro/                          ⚙️  Reglas que instalas una vez (ver Quick Start)
│   ├── steering/aws-aidlc-rules/
│   │   └── core-workflow.md
│   └── aws-aidlc-rule-details/
│       ├── common/         # Reglas compartidas (process-overview)
│       ├── inception/      # Fase 1: requisitos, historias, diseño
│       ├── construction/   # Fase 2: diseño funcional, NFR, código, tests
│       ├── operations/     # Fase 3: deploy, monitoreo, incidentes
│       └── extensions/     # Reglas opcionales
│
├── aidlc-docs/                     📁 LA AI escribe todo aquí (automático)
│   ├── aidlc-state.md              # Estado vivo del proyecto
│   ├── audit.md                    # Log de cada decisión
│   ├── inception/
│   │   ├── plans/execution-plan.md
│   │   ├── requirements/
│   │   │   ├── requirements.md
│   │   │   └── requirement-verification-questions.md
│   │   ├── user-stories/
│   │   │   ├── personas.md
│   │   │   └── stories.md
│   │   └── application-design/
│   │       └── application-design.md
│   └── construction/
│       └── {unit-name}/
│           ├── functional-design/
│           ├── nfr-design/
│           └── code/
│
└── src/                            💻 TU CÓDIGO FUENTE va aquí
    └── ... (la AI crea archivos aquí también)

Los 4 archivos que más vas a consultar

📊 aidlc-state.md

Dashboard en vivo. Te dice en qué fase estás, qué pasos completaste y cuáles se saltaron. Ábrelo cuando quieras saber "¿dónde voy?".

📜 audit.md

Log cronológico de TODO. Cada pregunta de la AI, cada respuesta tuya, cada aprobación, con timestamp. Es la memoria del proyecto.

requirement-verification-questions.md

Las preguntas que la AI te hizo para clarificar tu intención, con tus respuestas. Útil para revisar decisiones tempranas.

📝 user-stories/stories.md

Las historias de usuario generadas con sus acceptance criteria. Esto es lo que la AI va a construir paso a paso.

El flujo completo

Ceremonias y ciclo iterativo

AI-DLC tiene tres fases, cada una con rituales específicos. El flujo es adaptativo: la AI recomienda qué pasos ejecutar según tu contexto.

Loop iterativo dentro de cada Unit (Construction)

Los pasos marcados como CONDITIONAL se ejecutan solo si AI-DLC lo recomienda. Los ALWAYS se ejecutan siempre.

Artefactos clave generados

Aprende con casos reales

Tu primer proyecto AI-DLC

Cuatro ejemplos ordenados de menor a mayor complejidad. Empieza por el primero, sigue los enlaces a los tutoriales oficiales y verás AI-DLC en acción.

💡
Cada ejemplo muestra el prompt inicial (lo único que tú escribes), el flujo que la AI ejecuta sola, y los archivos que aparecen en aidlc-docs/. Los enlaces al final llevan a tutoriales y código real.
Evita esto

Errores comunes

Las trampas que normalmente complican AI-DLC y cómo esquivarlas antes de que te cuesten tiempo.

Aclaración clave

AI-DLC vs Kiro Specs

Son dos cosas distintas que viven en niveles diferentes del stack. Esta confusión es la #1 cuando alguien empieza. Aclarémosla.

💡
Piénsalo así: Kiro Specs es una receta incluida con tu olla. AI-DLC es un libro de cocina completo. Puedes usar la receta de la olla, o seguir el libro, que funciona en cualquier olla.

No compiten, viven en niveles diferentes

NIVEL 3 — Metodología
AI-DLC Cómo construir software con AI de principio a fin. Portable entre IDEs.
▼ se ejecuta en ▼
NIVEL 2 — IDE
Kiro / Cursor / VS Code / IntelliJ / Windsurf El editor donde escribes código y la AI ejecuta.
▼ que ofrece ▼
NIVEL 1 — Features del IDE
Kiro Specs (solo Kiro) · Cursor Rules · Q Rules Funcionalidades específicas de cada IDE para estructurar el trabajo.

Comparativa lado a lado

📋
Feature nativa del IDE
Kiro Specs

Un modo dentro de Kiro que genera 3 archivos estructurados para una feature o bugfix concreto.

📄 requirements.md
📄 design.md
📄 tasks.md
  • Una feature individual
  • Bugfix con análisis estructurado
  • Tareas bien definidas
  • Trabajo dentro de Kiro
🌐
Metodología portable
AI-DLC

Un framework completo con 3 fases que se adapta al tipo de proyecto y funciona en cualquier IDE.

📁 inception/ (requirements, stories, design)
📁 construction/ (units, NFRs, código)
📁 operations/ (deploy, monitoreo)
📄 audit.md + aidlc-state.md
  • Proyectos completos end-to-end
  • Equipos con trazabilidad y compliance
  • Legacy con reverse engineering
  • Independencia del IDE

Diferencias en detalle

Dimensión Kiro Specs AI-DLC
TipoFeature de IDEMetodología portable
AlcanceUna feature o bugProyecto completo
WorkflowFijo (3 archivos)Adaptativo (se ajusta)
IDEs soportadosSolo KiroKiro, Cursor, VS Code, IntelliJ, Windsurf, Claude Code
Fases del lifecycle1 (planning + execution)3 (Inception, Construction, Operations)
Reverse engineeringNoSí, automático en brownfield
Fase de OperationsNo incluidaDeploy, monitoreo, telemetría
Audit trailChecklist de tasksaudit.md con timestamps ISO 8601
PersonalizaciónLimitadaEditas las steering rules a tu gusto
Pensado para equiposSí, dentro de KiroSí, agnóstico de plataforma
⚠️
Si usas AI-DLC dentro de Kiro: NO actives Spec mode

Cuando corres AI-DLC en Kiro, trabaja en modo Vibe. AI-DLC ya tiene su proceso estructurado (las steering rules). Si activas Spec mode encima, los dos workflows compiten y se mezclan los archivos.

La documentación oficial lo dice así: "At times, Kiro may nudge you to switch to spec mode. Select No to such prompts to stay in Vibe mode."

¿Cuál debo usar?

USA KIRO SPECS SI
  • Solo necesitas implementar UNA feature concreta
  • Trabajas exclusivamente dentro de Kiro
  • No te interesa portar el proceso a otros IDEs
  • Quieres algo más ligero, sin tres fases
USA AI-DLC SI
  • Construyes un proyecto completo, no una feature aislada
  • Quieres flexibilidad de IDE (hoy Kiro, mañana Cursor)
  • Necesitas reverse engineering para legacy code
  • Tu equipo requiere audit trail y compliance
  • Quieres personalizar el workflow (security gates, etc.)