Specs-Driven Development: Código que Cumple Promesas

📝 Teoría: El Problema de la Ambigüedad

La mayor causa de bugs y re-trabajo no es la falta de habilidad técnica, sino la falta de claridad.

• “El usuario debería poder filtrar productos”.
• ¿Filtrar por qué? ¿Precio, nombre, categoría? ¿Filtros combinados? ¿Se guarda el filtro al salir?

Specs-Driven Development (SDD) propone escribir especificaciones técnicas detalladas antes de escribir una sola línea de código.

📄 Anatomía de una Spec Técnica

Una buena Spec no es un documento de Word de 40 páginas. Es un Markdown vivo en tu repo.

Estructura Recomendada

1. Overview: Qué y por qué.
2. User Stories: Desde la perspectiva del usuario.
3. Technical Constraints: Librerías, rendimiento, seguridad.
4. API Contract: JSONs de entrada/salida.
5. Data Model: Entidades y relaciones.
6. Edge Cases: ¿Qué pasa si no hay internet? ¿Si la lista está vacía?

🤖 SDD en la Era de la IA

Aquí es donde SDD brilla. Los LLMs (Copilot, Gemini) son motores de “Spec-to-Code”.

Si le das a Gemini una Spec vaga, te dará código vago. Si le das una Spec técnica detallada, te dará una implementación casi perfecta.

Workflow SDD + IA

1. Borrador (Humano): Escribe los bullet points de la feature.
2. Refinamiento (IA): Pide a la IA: “Actúa como Product Owner Técnico. Lee estos requisitos y genera una Spec Técnica detallada, identificando casos borde que me haya saltado”.
3. Aprobación (Humano): Revisa la Spec generada.
4. Implementación (IA): “Implementa el ViewModel y Repository basándote estrictamente en esta Spec”.

🚀 Ejemplo Real: Feature de “Favoritos”

Input Humano:

“Quiero que los usuarios puedan marcar items como favoritos y verlos offline.”

Spec Generada por IA (Resumida):

# Feature: Favorites

## Requirements
- Toggle favorite status on Item Detail screen.
- View list of favorites in "My Profile".
- Offline support mandatory.

## Data Layer
- **Local**: Room Table `favorites` (item_id, timestamp).
- **Remote**: Sync with API `POST /favorites/{id}`.
- **Sync Strategy**: Optimistic UI. Update local immediately, sync background.

## Edge Cases
1. User marks favorite while offline -> Queue sync request.
2. API fails -> Retry 3 times w/ exponential backoff.
3. Item deleted on server -> Remove from local favorites on next sync.

Con esta Spec, la implementación es trivial y robusta.

🎯 Conclusión

Escribir Specs parece “lento” al principio, pero es la inversión con mayor retorno en ingeniería de software. Acelera el desarrollo, elimina dudas durante la implementación y sirve como documentación y base para tests.