# Cómo escribir una buena especificación

> Una buena especificación (`SPEC.md`) es un acuerdo breve y en palabras sencillas dentro de tu proyecto que define qué vas a construir, a quién ayuda, qué entra y qué queda fuera, cómo comprobarás que funciona y qué piezas técnicas necesita tu agente antes de programar.

## Analogía

Piensa en el boceto y la lista de habitaciones de un estudio de arquitectura antes de poner un solo ladrillo. Mover una pared en el papel lleva treinta segundos; mover un tabique cuando ya está el tejado exige derribar. Tu especificación es ese boceto.

## Cómo funciona

En el sdd, cada proyecto y cada función importante empieza con una spec guardada en un archivo llamado `SPEC.md` en la raíz de la carpeta de tu proyecto. En lugar de pedirte que redactes un documento largo desde cero, tu coding-agent usa su skill `interview-me` para hacerte una pregunta cada vez, proponiendo una respuesta razonable para cada una.

Esas preguntas tratan sobre personas, problemas y objetivos, nunca sobre código. Con tu agente acuerdas cinco apartados sencillos: **qué** vas a construir, **para quién** es, qué es **imprescindible** en la primera versión, qué **queda fuera** por ahora y **cómo sabrás que funciona** cuando lo pruebes.

Debajo de ese resumen en palabras claras, el agente añade las notas técnicas que necesita: qué piezas de la base técnica requiere realmente tu app. Cada aplicación lleva solo lo que necesita: si no guarda nada entre visitas, no hay database; si no hay cuentas, no hay inicio de sesión; si no usa IA, no hay proveedores de IA.

Tu especificación es un documento vivo, no un contrato tallado en piedra. Siempre que cambies de idea o descubras algo mejor al probar, pídele a tu agente que actualice primero `SPEC.md` y el plan, y solo después el código. Así tu proyecto se mantiene coherente de principio a fin.

## En tu proyecto

Cuando empieces un proyecto o pidas una función nueva, tu agente no se lanzará a crear archivos a ciegas. Te hará la primera pregunta, esperará tu respuesta y, tras unos pocos turnos, escribirá `SPEC.md` en tu idioma y te lo enseñará para que des tu visto bueno antes de trazar el plan.

## Copia para tu agente

```text
Quiero definir qué vamos a construir en SPEC.md. Entrevístame con una pregunta cada vez y una respuesta sugerida para cada una, sobre para quién es, qué es imprescindible, qué queda fuera y cómo sabremos que funciona.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/como-escribir-una-buena-especificacion) · Licencia: CC BY 4.0