Especificación
Un documento corto que dice qué hay que construir, para quién, con qué límites y cómo se sabrá que está bien, antes de construir nada.
✦Apagada: responde bien la pregunta del final para encenderla
También lo verás como: especificación · spec · especificaciones · brief · ESPECIFICACION.md
Analogía
Los planos antes de la obra. Nadie le dice a un albañil "haz una casa": le da los planos.
Qué lleva
| Apartado | Pregunta que responde |
|---|---|
| Objetivo | ¿para qué existe esto? ¿qué problema le resuelve al negocio? |
| Público | ¿quién lo usa, desde dónde, con qué dispositivo? |
| Contenido / funciones | ¿qué tiene que haber, y en qué orden? |
| Restricciones | ¿qué condiciones técnicas o de negocio hay que respetar? |
| Fuera de alcance | ¿qué no se hace, ahora? → alcance |
| Criterios de aceptación | ¿cómo comprobamos que está bien? → criterios de aceptación |
Por qué la escribes tú (y no la IA)
Porque es donde se decide el producto. La IA es excelente criticándola ("¿qué falta? ¿qué es ambiguo?"), pero si la escribe ella, decide ella. Y con un cliente (negocio), la especificación es también lo que se acordó: la base del presupuesto (Fase 14).
Por qué en un archivo y no en un mensaje
Un ESPECIFICACION.md dentro del proyecto se versiona con Git, se relee en cada conversación nueva y no desaparece con /clear → contexto.
Un paso más: cuánto tiene que medir
Para la carta de un restaurante, una página. No es un documento formal: es una lista de decisiones ya tomadas.
La prueba de que está completa: dásela a alguien que no estuvo en la conversación con el cliente (o a la IA, en una conversación nueva) y pídele que te diga qué va a construir. Si lo que describe es lo que tenías en la cabeza, sirve. Si pregunta cosas, cada pregunta es una línea que faltaba.
Lo que más se queda fuera, y más problemas da después:
- Qué pasa cuando falta un dato (¿un plato sin foto? ¿sin precio?).
- Desde qué dispositivo se va a usar de verdad.
- Qué no se hace, que es lo que evita los "ya que estamos".
¿Quién escribe la especificación?
Ver también
alcance · criterios de aceptación · tarea pequeña y verificable · el ciclo de delegación