C贸mo implementar Spec-Driven Development con IA: un piloto para equipos de software
Tu equipo ya usa agentes de IA para escribir c贸digo. La siguiente pregunta es si puede entregar un cambio con menos retrabajo y con la misma confianza al aprobarlo. Para averiguarlo, elige una funcionalidad real del backlog y ll茅vala desde una especificaci贸n breve hasta una revisi贸n con pruebas. As铆 puedes observar d贸nde ayud贸 el agente y d贸nde el equipo tuvo que resolver ambig眉edades.
En un piloto de Spec-Driven Development (SDD), el equipo acuerda por escrito qu茅 debe hacer la funcionalidad, qu茅 casos debe cubrir y c贸mo comprobar谩 el resultado. El agente usa esa especificaci贸n para proponer un plan y trabajar en el repositorio. Producto e ingenier铆a toman las decisiones que afectan el comportamiento y la arquitectura. Al final, la misma especificaci贸n sirve para revisar la implementaci贸n.
Si buscas una introducci贸n al enfoque y a sus herramientas, parte por nuestra gu铆a de Spec-Driven Development y agentes inteligentes. Aqu铆 vamos a probarlo con una funcionalidad concreta.
1. Elige una funcionalidad que tu equipo pueda evaluar
Busca un cambio peque帽o, con una regla de negocio concreta y un flujo que el equipo ya conozca. Conviene que alguien de producto pueda validar el comportamiento y que ingenier铆a pueda ejecutarlo en un entorno de prueba. Si el equipo depende de varias 谩reas para resolver el alcance, ser谩 dif铆cil saber cu谩nto influy贸 SDD en el resultado.
Para este ejemplo, el equipo mantiene una aplicaci贸n que invita a nuevos miembros a una cuenta. Cuando una invitaci贸n vence, el administrador debe pedir ayuda a soporte. El piloto a帽ade la opci贸n de reenviarla desde la aplicaci贸n. El objetivo es que el administrador resuelva el problema por su cuenta y que una invitaci贸n vencida no se convierta en dos registros activos para la misma persona.
Antes de empezar, identifica una funcionalidad reciente y de complejidad similar. Anota cu谩nto tiempo tom贸 revisarla y qu茅 cambios pidi贸 el equipo despu茅s de abrir la revisi贸n. Usa solo la informaci贸n que puedas reconstruir con confianza. Esa referencia te ayudar谩 a interpretar el piloto.

2. Escribe una especificaci贸n que se pueda probar
Una p谩gina puede bastar para este cambio. La especificaci贸n debe decir qu茅 le ocurre al usuario y en qu茅 condiciones. Si una regla admite dos interpretaciones, escr铆bela como un caso observable. Esta plantilla se puede adaptar directamente en el repositorio.
# Reenv铆o de invitaciones vencidas
## Objetivo
Un administrador puede reenviar una invitaci贸n vencida de su cuenta.
## Criterios de aceptaci贸n
- Al reenviar una invitaci贸n vencida, se actualiza el registro existente
y se emite un enlace con una nueva fecha de vencimiento.
- Si la invitaci贸n sigue vigente, el reenv铆o se rechaza y el enlace
actual sigue funcionando.
- Si quien solicita el reenv铆o no administra esa cuenta, el sistema
lo rechaza y conserva la invitaci贸n intacta.
- Si llegan dos solicitudes simult谩neas, solo una renueva la invitaci贸n
y encola el env铆o del correo.
## Restricciones
- Reutilizar el sistema de invitaciones y la cola de correo existentes.
- Mantener el flujo actual de creaci贸n de invitaciones.
Producto puede confirmar qu茅 deber铆a ver el administrador si otra persona acaba de renovar la invitaci贸n. Ingenier铆a puede confirmar si el repositorio ya tiene una forma de coordinar solicitudes simult谩neas. Resolver esas preguntas antes de implementar evita que una decisi贸n de negocio termine impl铆cita en el c贸digo. Guarda la versi贸n acordada junto al cambio para que cualquier revisor pueda consultarla.
3. Pide un plan al agente y rev铆salo antes de implementar
Entrega al agente la especificaci贸n y p铆dele que localice el flujo actual, proponga el cambio m铆nimo y asocie cada criterio de aceptaci贸n con una prueba. La primera revisi贸n deber铆a poder responder tres preguntas. 驴D贸nde se verifica que el administrador pertenece a la cuenta? 驴En qu茅 punto se actualiza la invitaci贸n? 驴C贸mo se garantiza que dos solicitudes simult谩neas produzcan un solo env铆o?
El plan puede revelar una decisi贸n que la especificaci贸n dej贸 abierta. Si actualizar el registro y encolar el correo ocurren en operaciones independientes, un fallo entre ambas puede dejar la invitaci贸n renovada con el correo pendiente. En ese caso, el equipo debe acordar c贸mo se recupera la operaci贸n usando los mecanismos del sistema. Registra la decisi贸n y pide al agente que ajuste el plan antes de tocar el c贸digo.
Al implementar, revisa el cambio junto con sus pruebas. Una prueba de 茅xito deber铆a verificar el nuevo vencimiento y que el identificador de la invitaci贸n sigue siendo el mismo. Para las solicitudes simult谩neas, una prueba de integraci贸n debe enviar ambas solicitudes sobre el mismo registro y comprobar que el sistema encola un solo correo. En este caso, verificar solo la respuesta de la API dejar铆a sin comprobar el efecto que recibe el usuario.

4. Mide cu谩nto trabajo tom贸 llegar a un cambio aprobable
Despu茅s de la revisi贸n, re煤ne a quienes definieron, implementaron y revisaron la funcionalidad. Usa tres medidas sencillas y conserva la evidencia en el historial del cambio.
| Medida | Qu茅 registrar |
|---|---|
| Tiempo de revisi贸n | Minutos de revisi贸n activa desde la primera entrega hasta la aprobaci贸n. Registra por separado el tiempo dedicado a escribir y revisar la especificaci贸n. |
| Retrabajo | Cambios pedidos despu茅s de la primera revisi贸n y su motivo. Distingue una regla mal entendida de un defecto de implementaci贸n. |
| Criterios omitidos | Criterios sin una prueba o una comprobaci贸n en la primera entrega. Registra cu谩ndo se detectaron. |
Si la revisi贸n fue m谩s corta, mira cu谩nto esfuerzo adicional tom贸 preparar la especificaci贸n. Si hubo menos retrabajo, identifica qu茅 decisi贸n qued贸 resuelta antes de escribir c贸digo. Y si lleg贸 una regla sin verificar, examina si el criterio era ambiguo o si falt贸 vincularlo con una prueba. Un solo piloto da evidencia para decidir qu茅 ajustar en la siguiente funcionalidad. Repetirlo con cambios comparables permite comprobar si el resultado se mantiene.
Lleva una funcionalidad real al piloto
Una buena candidata tiene un responsable que puede resolver dudas, un alcance que cabe en una revisi贸n y un resultado que se puede comprobar con pruebas. Lleva a la primera conversaci贸n la historia del backlog, las restricciones del repositorio y un ejemplo de un cambio anterior que haya requerido retrabajo. Con eso podemos acordar qu茅 probar, qui茅n debe revisarlo y c贸mo evaluar el resultado.
Trae una funcionalidad de tu backlog y evaluemos si calza para un piloto SDD.
Entradas anteriores

Archify: c贸mo revisar diagramas de arquitectura con IA
Descubre c贸mo revisar diagramas de arquitectura generados con IA, validar sus relaciones con Archify y detectar supuestos antes de utilizarlos.

Strangler Fig: c贸mo migrar de monolito a microservicios
Descubre c贸mo aplicar el patr贸n Strangler Fig para migrar de un monolito a microservicios de forma gradual, reducir riesgos y mantener el negocio operativo.
