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
requirements.md: las historias de usuario y los criterios de aceptación, en la notación que explica la siguiente sección.design.md: la arquitectura técnica, con diagrama de secuencia y las decisiones de implementación, documentadas antes de la primera línea de código.tasks.md: el plan de implementación, dividido en tareas discretas y rastreables, con estado actualizado en tiempo real conforme avanza el trabajo.
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.
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.

