Qué Es el Desarrollo Orientado a Specs

Volver
Qué Es el Desarrollo Orientado a Specs
Qué Es el Desarrollo Orientado a Specs

Por CloudDog, Creado el 21/08/2026

Cuando un Prompt Suelto No Alcanza

Es probable que su equipo ya use un asistente de IA en el código todos los días: un pedido rápido en el chat, y la función sale lista, o casi. Para un ajuste puntual eso funciona bien. El problema aparece cuando la tarea crece: toca 3 módulos distintos, depende de una decisión de arquitectura que alguien tomó en medio de una conversación, y 2 meses después nadie recuerda por qué se eligió ese camino. La conversación que explicaba la decisión ya pasó a otro tema, o la sesión se cerró hace semanas.

Ese vacío, entre la decisión tomada y el motivo sobreviviendo a ella, es justamente lo que el desarrollo orientado a specs (spec-driven development) fue hecho para cerrar. La idea, descrita en la documentación de specs del Kiro, es simple de enunciar y trabajosa de practicar sin una herramienta que sostenga el proceso: antes de cualquier código, usted formaliza qué hay que resolver, cómo se va a resolver y qué pasos llevan hasta ahí. Estas 3 partes quedan escritas, revisables y, después, versionadas en el mismo repositorio del código que generaron.

Qué Es una Spec, en Realidad

Una spec no es un documento de requisitos archivado en una herramienta separada, que nadie vuelve a abrir después del kickoff. En el Amazon Kiro, toda spec genera 3 archivos que viven junto con el código, en el propio repositorio, y pueden leerse, comentarse y actualizarse como cualquier otro archivo del proyecto.

Las 3 Partes que Toda Spec Produce

La documentación oficial describe el flujo en 3 fases, siempre en este orden: requisito (o análisis del bug, para una spec de corrección), diseño y tareas. Cada fase solo avanza después de que la anterior fue revisada, que es justamente el punto: la decisión de arquitectura no queda perdida en una conversación de chat, está escrita en el design.md, al lado del motivo que llevó a ella.

La Notación EARS en el Requisito

El requirements.md usa la notación EARS (Easy Approach to Requirements Syntax) para transformar una idea suelta en un criterio de aceptación comprobable. El patrón, según la documentación de Feature Specs, sigue este formato:

WHEN [condición o evento]
THE SYSTEM SHALL [comportamiento esperado]

Un ejemplo real de la propia documentación del Kiro:

WHEN a user submits a form with invalid data
THE SYSTEM SHALL display validation errors next to the relevant fields

La ventaja de escribir de esta forma, en vez de una frase corrida, es que cada línea ya nace como un caso de prueba en potencia: dice la condición, el comportamiento esperado, y nada más. Quien revisa no necesita interpretar la intención detrás de un párrafo; el requisito ya está en la forma en que será verificado.

De la Aprobación en Cada Fase a las Oleadas de Tareas

Una vez que el tasks.md existe, usted puede ejecutar una tarea a la vez, siguiendo el estado en tiempo real, o ejecutarlas todas de una vez. En ese segundo caso, el Kiro construye un grafo de dependencias entre las tareas y las agrupa en oleadas: la primera oleada ejecuta todas las tareas sin dependencia, en paralelo; la siguiente libera las tareas cuyas dependencias la oleada anterior satisfizo; y así sucesivamente, hasta la última oleada. Las oleadas corren en secuencia, pero las tareas dentro de cada oleada corren al mismo tiempo, lo que reduce bastante el tiempo de ejecución sin que usted tenga que dibujar ese orden a mano.

Flujo de una spec: requisito en notación EARS, diseño con diagrama de secuencia, tareas divididas en oleadas por dependencia, código validado tarea por tarea, y la spec versionada en el repositorio junto con el código.Flujo de una spec: requisito en notación EARS, diseño con diagrama de secuencia, tareas divididas en oleadas por dependencia, código validado tarea por tarea, y la spec versionada en el repositorio junto con el código.

Requisito Primero, o Diseño Primero

La documentación de Feature Specs describe 2 variantes de flujo, y la elección depende de dónde ya está el razonamiento de su equipo. En el flujo Requirements-First, usted parte del comportamiento que el sistema necesita tener, y el diseño se genera a partir de los requisitos; es el camino natural cuando la feature nace de un pedido de producto o de feedback de cliente, y la arquitectura todavía tiene libertad para adaptarse. En el flujo Design-First, usted parte de una arquitectura o de un diseño de bajo nivel que ya tiene en mente, y los requisitos se derivan de ahí; funciona mejor cuando el sistema necesita cumplir una restricción técnica estricta (latencia, throughput, conformidad) o cuando está portando un diseño que ya existía en otra herramienta. Ninguna de las dos es “la correcta”; la pregunta es si la flexibilidad de este proyecto está en el comportamiento o en la implementación.

En Qué Se Diferencia de un Prompt Suelto

Un prompt directo resuelve una tarea aislada: “cambia esta función para que haga X.” Sigue siendo el camino más rápido para ese tipo de ajuste, y el propio Kiro también tiene un modo de edición rápida para eso, a veces llamado “vibe coding” en las conversaciones sobre el mercado de asistentes de código. La spec entra en un momento distinto: cuando la tarea atraviesa varios archivos o módulos, o cuando la decisión de diseño necesita sobrevivir más allá de quien la tomó.

La diferencia no está en la “calidad” del código generado en un caso o en el otro. Está en lo que queda después: con un prompt suelto, queda el código y, si alguien lo guarda, un historial de chat difícil de buscar; con una spec, queda un artefacto estructurado, en el mismo lugar que el código, que cualquier persona del equipo puede abrir meses después y entender por qué se eligió ese camino, sin necesidad de preguntarle a quien lo escribió.

Dónde Encaja Esto en el Día a Día de Su Equipo

Para la mayoría de las tareas pequeñas y aisladas, el ajuste directo en el código sigue siendo el camino correcto: escribir una spec para una corrección de 2 líneas costaría más tiempo del que ahorra. La spec compensa cuando el tamaño de la tarea justifica el tiempo de escribirla, y ese umbral varía de equipo a equipo. La señal más confiable no es el número de archivos, es la pregunta: si esta decisión se cuestiona dentro de 3 meses, ¿dónde está la respuesta?

Cómo Queda el Flujo del Equipo Después de Adoptar Specs

Quien adopta specs cambia “abrir una conversación nueva y explicar el contexto de nuevo” por abrir el design.md de la feature y ver la decisión ya registrada, con el motivo al lado. El requisito, escrito en EARS, se convierte directo en un guion de prueba; el plan de tareas muestra lo que ya se hizo y lo que falta, sin necesidad de preguntar en el chat del equipo; y cuando una tarea necesita revisarse de nuevo, la spec entera, no solo el código, está ahí, versionada, para quien tenga que revisarla.

CloudDog, Advanced Partner de AWS, implementa el Amazon Kiro en su equipo de desarrollo, con configuración, integración a su cuenta AWS y capacitación, para que adoptar specs no dependa de que cada desarrollador descubra el proceso por su cuenta. Conozca el Amazon Kiro de CloudDog, vea el Kiro Power para probarlo con apoyo de crédito de AWS, o la página Amazon Kiro para Desarrolladores si usted es quien escribe el código y quiere entender el proceso antes de proponer la adopción en la empresa.

Tags

#SpecDrivenDevelopment #AmazonKiro #AWS #DevOps

Sobre el autor

CloudDog

CloudDog es una consultora especializada en computación en la nube, socia de AWS, que ayuda a las empresas a migrar, modernizar, gestionar y optimizar sus entornos cloud. Con más de 400 proyectos entregados, combinamos experiencia técnica, gobernanza e innovación para acelerar la transformación digital de nuestros clientes mediante soluciones de infraestructura, seguridad, observabilidad, inteligencia artificial y servicios gestionados.

WhatsApp

Política de Privacidad