La especificación es el nuevo código fuente.
El conocimiento tácito de los ingenieros senior pasa a ser artefactos explícitos. La especificación actúa como el contrato que el código implementa.
/ Thinkia · Metodología /
Entrega IA exponencial.
Los copilotos aceleran a cada ingeniero. El apalancamiento exponencial está en el sistema de entrega. Seis fases gobernadas, un Golden Spec, tres niveles de riesgo. Entrega IA reproducible a escala empresarial.
El techo del copiloto
Los copilotos aceleran a los ingenieros. No arreglan el sistema de entrega.
-
Sin contexto compartido
Cada sprint empieza de cero. Sin un Context Package, los agentes de IA pierden la intención, las restricciones y las decisiones tomadas en cada fase anterior.
-
Generación sin gobernanza
El código se envía sin trazabilidad. Sin un AI-BOM que inventaríe lo generado, sin clasificación de riesgo, sin cadena de aprobación — solo un diff.
-
Deriva de especificaciones
Los requisitos se dispersan en tickets y chat. Sin un `.spec.md` vivo, las decisiones de arquitectura desaparecen y la intención se desacopla de la implementación.
-
Proliferación de modelos
Cada ingeniero elige una herramienta de IA diferente. Sin un gateway unificado no hay control de costes, ni soberanía de datos, ni aplicación consistente de políticas.
-
El retrabajo domina
Sin metodología, el 60% del tiempo va en rehacer y depurar código generado por IA. La velocidad en generación se convierte en lentitud en entrega.
-
Sin reproducibilidad
Los resultados dependen de quién estaba en el equipo, no de un sistema. Lo que funcionó en un proyecto no puede transferirse, auditarse ni escalarse.
Cambio de paradigma
Deja de escribir código. Empieza a especificar intención.
El VibeCoding — asistencia por IA, prototipado más rápido — es el primer paso. El Desarrollo Dirigido por Especificaciones es el siguiente. La misma IA, operando ahora sobre un sistema de entrega gobernado y compartido por todo el equipo.
Los cuatro pilares
-
-
La revisión es la actividad central.
El tiempo del ingeniero pasa de escribir código a validarlo, aumentando del 20% al 50% de su tiempo.
-
La arquitectura se diseña para ser legible por agentes.
Los patrones y convenciones se almacenan en artefactos versionados en lugar de quedar solo en conversaciones.
-
La gobernanza está integrada en el flujo.
Los quality gates, la prevención de pérdida de datos (DLP) y la trazabilidad se incorporan en los bordes del proceso, no como capas separadas.
Recorrido de madurez
El recorrido del software asistido por IA.
No todas las organizaciones parten del mismo punto. Hay cinco etapas en la madurez del desarrollo de software asistido por IA — y saber dónde estás define qué debes hacer a continuación.
-
Desarrollo tradicional
El software se construye manualmente, con control total pero a alto coste.
-
VibeCoding
El software se genera rápido… pero sin control ni consistencia.
-
Coding 3.0
El software se acelera con IA, pero sigue dependiendo del desarrollador.
-
Desarrollo Dirigido por Especificaciones
El software se define mediante intención estructurada dentro de un marco de reglas.
-
Destino Enterprise AI-SDLC
El software se orquesta como un sistema gobernado de reglas, specs y capacidades.
El salto crítico: de VibeCoding a Spec-Driven
El mayor error de las organizaciones es confundir VibeCoding con transformación. Generar código rápido sin gobernanza crea deuda técnica a velocidad IA. La clave no es la velocidad de generación — es la calidad de la especificación que la precede.
Enterprise AI-SDLC: el destino
En la etapa Enterprise, el software deja de ser un producto artesanal y pasa a ser la salida gobernada de un sistema de reglas, specs y capacidades. La IA no sustituye al ingeniero — redefine qué tipo de ingeniero necesitas.
Seis fases
F0 a F5 — seis fases, seis resultados firmados.
Las cinco fases — Definición, Especificación, Generación, Revisión, Entrega — se mapean a seis resultados firmados: F0 hasta F5. Cada fase comienza con el Context Package de la anterior: el Golden Spec, el AI-BOM y el último Health Report.
- 1
F0 — Input Bundle
Alineación estratégica, refinamiento del backlog, inventario de riesgos y mapa de contexto. El resultado firmado es el Context Package que todos los agentes posteriores leen antes de generar nada.
- 2
F1 — Definición del Problema
Definición precisa del problema, límites de alcance y primera asignación de nivel de riesgo. Produce el System Brief `.spec.md` — el documento de intención contra el que opera cada agente de IA.
- 3
F2 — Ingeniería de especificaciones
Trabajo de especificación estructurada: decisiones de arquitectura, contratos de componentes y diseño de interacción en formato legible por máquina. Produce el `.design.md` Architecture Decision Record y la especificación de interacción `.ui-spec.md` — completando el Golden Spec antes de que empiece la generación.
- 4
F3 — Construcción
Desarrollo paralelo asistido por IA contra el Golden Spec. Cada unidad de código se clasifica por riesgo (Verde / Ámbar / Rojo), se registra en el AI-BOM y se valida mediante la puerta de calidad de 17 puntos antes de la aprobación.
- 5
F4 — QA y Validación
Puertas de prueba estructuradas: funcional, rendimiento, seguridad, cumplimiento. La librería de habilidades ejecuta los 17 validadores automáticos y produce un Health Report de fase antes de recoger cualquier firma.
- 6
F5 — Entrega a Producción
Despliegue, línea base de monitorización y runbook operativo. La cadena de cinco firmas se cierra — PM, Arquitecto, Seguridad, Legal/Cumplimiento, Platform Owner — haciendo cada entrega trazable de extremo a extremo.
No es necesario adoptar las seis fases a la vez. La mayoría de los equipos empiezan con F0 (Input Bundle) y el Golden Spec, y expanden el framework de forma incremental a medida que crece la confianza.
El eje de gobernanza
El Golden Spec
Un artefacto obligatorio por sprint. Tres archivos maestros que definen qué se construye. Cinco firmas que confirman que es seguro construirlo.
Qué es
El Golden Spec es el eje de gobernanza de todo proyecto AI-SDLC. Se crea en F0 y se firma en cada puerta de fase. Sin él, ningún agente de IA genera — y ningún resultado se envía.
`.spec.md` — System Brief
La intención del proyecto en un único archivo — objetivos, personas, restricciones y requisitos no funcionales. Esto es lo que cada agente de IA lee antes de generar nada. El contrato entre la intención de negocio y la ejecución técnica.
`.design.md` — Architecture Decision Record
Cada decisión estructural con su justificación completa — qué se eligió, qué se descartó y por qué. Evita la deriva de arquitectura a medida que evoluciona el proyecto y ofrece a la cadena de cinco firmas un artefacto concreto que revisar.
`.ui-spec.md` — Especificación de UI
La especificación de interacción y el contrato de componentes. Define estados de pantalla, flujos de usuario y comportamiento de componentes para que la UI generada por IA esté anclada a decisiones de diseño deliberadas, no a la intuición del modelo.
AI-BOM + Health Reports
El AI Bill of Materials inventaría cada unidad de código generada por IA con su nivel de riesgo y estado de aprobación. Los Health Reports de fase son instantáneas de calidad producidas por los 17 validadores de la librería de habilidades en cada puerta.
La cadena de cinco firmas
PM · Arquitecto · Seguridad · Legal/Cumplimiento · Platform Owner. Cada puerta de fase requiere la cadena completa antes de que el Context Package avance. Sin aprobaciones parciales, sin excepciones.
Gobernanza del riesgo
Tres niveles. Una política.
Cada unidad de código producida por o con IA recibe un nivel de riesgo en el momento de generación y se registra en el AI-BOM. El nivel determina cuáles de los 17 validadores de calidad se ejecutan, los revisores requeridos y la evidencia de auditoría que debe existir antes de que la unidad pueda enviarse.
Generado por IA, revisado por humanos
Unidades de bajo riesgo: documentación, scaffolding de pruebas, boilerplate. Generadas libremente contra el Golden Spec, revisadas por un ingeniero. Se requiere una sola firma antes de avanzar.
Asistido por IA, validado por humanos
Unidades de riesgo medio: lógica de negocio, integraciones de API, transformaciones de datos. Validadas contra el ADR `.design.md` con dos aprobaciones y un Health Report que confirma que todos los validadores relevantes han pasado.
Autorado por humanos, asistido por IA
Unidades de alto riesgo: controles de seguridad, lógica de cumplimiento, cálculos financieros. El humano redacta el borrador con soporte de IA; se requiere la cadena completa de cinco firmas antes de que la unidad entre en el AI-BOM como aprobada.
Resultados
Cómo se ve la entrega IA gobernada en producción
6–10×
Entrega más rápida
El mismo equipo, entre 6 y 10 veces más producción. Los ingenieros dedican su tiempo a la intención y la aprobación, no al retrabajo.
90%
Menos pérdida de contexto
El Context Package — Golden Spec, AI-BOM, Health Report — transporta el estado completo del proyecto a través de cada fase y cada sprint.
100%
Listo para auditoría
Cada artefacto firmado. Cada unidad generada por IA inventariada en el AI-BOM. Cada resultado de fase trazable hasta un requisito de negocio.
17
Validadores de calidad
Comprobaciones prefabricadas que cubren puertas funcionales, de seguridad, rendimiento y cumplimiento — ejecutadas automáticamente por la librería de habilidades en cada frontera de fase.
108
Habilidades validadas
Librería de habilidades compatible con MCP invocable por Claude, GPT-4o o Gemini — sin integración personalizada en ninguna cadena de herramientas compatible.
4–6 semanas
MVP de la Etapa 1
El Sprint 0 tarda 2–4 semanas en instalar la metodología. El MVP de la Etapa 1 se entrega en 4–6 semanas con enforcement de CI y la cadena de fases completa activa.
Dónde aterriza
Construido para entornos regulados y complejos
Servicios financieros
Pistas de auditoría, controles de riesgo de modelos y puertas de cumplimiento integradas en cada fase — no añadidas a posteriori.
Salud y ciencias de la vida
Los requisitos de gobernanza de datos de pacientes y validación de software clínico se cumplen con el sistema de niveles de riesgo y la cadena de cinco firmas.
Software empresarial
Los grandes equipos de ingeniería que adoptan IA a escala necesitan estructura, no solo herramientas. La metodología les da un modelo operativo compartido.
Sector público y defensa
Despliegue soberano, manejo de contexto clasificado y auditabilidad completa — el nivel Rojo cubre el código de mayor riesgo.
Retail y e-commerce
Ciclos de entrega rápidos sin riesgo de regresión. La construcción asistida por IA bajo el marco Verde/Ámbar reduce el tiempo de salida al mercado con seguridad.
Preguntas
Preguntas frecuentes
¿Qué es el VibeCoding y por qué toca techo?
El VibeCoding es el uso de IA para productividad individual — escribir más rápido, prototipar más rápido — pero apoyándose en el contexto local de cada ingeniero. Toca techo porque no arregla las especificaciones compartidas, la clasificación de riesgo ni la gobernanza. El Desarrollo Dirigido por Especificaciones es el paso siguiente: el equipo al completo, no solo el individuo, opera con IA en cada capa del sistema de entrega.
¿En qué se diferencia del Agile o DevOps estándar?
Agile y DevOps se diseñaron antes de que el código generado por IA fuera una realidad. El AI-SDLC añade un sistema de clasificación de niveles de riesgo, un Golden Spec de tres archivos maestros legible por máquina y una cadena de gobernanza de cinco firmas diseñada específicamente para artefactos generados por IA.
¿Necesitamos Thinkia Pulse para usar la metodología?
No. La metodología es agnóstica respecto a la cadena de herramientas. Sin embargo, Pulse proporciona soporte nativo para el Golden Spec, la librería de habilidades y el gateway MCP — lo que hace la adopción significativamente más rápida.
¿Cómo funciona el sistema de niveles de riesgo en la práctica?
En la construcción F3, cada unidad de código se etiqueta como Verde, Ámbar o Rojo según su criticidad de negocio y sensibilidad de datos. El nivel determina la cadena de revisión: un ingeniero para Verde, dos aprobaciones para Ámbar, la cadena completa de cinco firmas para Rojo.
¿Es esto una herramienta o una metodología?
Una metodología. El Enterprise AI-SDLC es un marco de gobernanza — un conjunto de fases, artefactos y prácticas de revisión. Thinkia Pulse es la plataforma que lo implementa, pero los equipos pueden adoptar la metodología con sus propias herramientas.
¿Qué es el Sprint 0 y cómo empezamos?
El Sprint 0 es un compromiso de incorporación estructurado donde Thinkia mapea tu proceso de entrega actual, instala la metodología y produce el primer Input Bundle y Golden Spec para tu primer sprint AI-SDLC. Normalmente dura 2–4 semanas.
¿Qué significa "compatible con MCP" para la librería de habilidades?
Las 108 habilidades de la librería están empaquetadas como herramientas del Model Context Protocol. Cualquier agente de IA que soporte MCP — incluyendo Claude, GPT-4o y Gemini — puede invocarlas directamente sin integración personalizada.
¿Podemos adoptarlo fase a fase?
Sí. La mayoría de los equipos empiezan con F0 y el Golden Spec, luego adoptan progresivamente el sistema de niveles de riesgo, los validadores de calidad y la cadena de fases completa. La metodología está diseñada para adopción incremental — no se requiere un despliegue masivo.
Dos formas de empezar
Empieza con estructura.
Lee el AI-SDLC Playbook — la metodología completa en un solo documento, con plantillas de fase, el formato del Golden Spec y el checklist de los 17 validadores.
O reserva una conversación de Sprint 0. Mapearemos tu proceso de entrega actual y te mostraremos exactamente dónde aplica la metodología.