L12 · Especificación · 5 min
Cómo escribir una buena especificación
En una frase
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.
Piénsalo así
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 Definicióndesarrollo guiado por especificaciones (SDD)Acordar qué construir (la especificación) y un plan, y después construir un paso pequeño y comprobado cada vez.Abrir en el glosario →, cada proyecto y cada función importante empieza con una Definiciónespecificación`SPEC.md`: qué vas a construir, para quién, qué entra y qué no, y cómo sabrás que funciona.Abrir en el glosario → 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 Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario → usa su DefiniciónskillUna guía experta que sigue tu agente para un tipo de tarea, como escribir una especificación o depurar.Abrir en el glosario → 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 Definiciónbase de datosDonde tu app recuerda cosas entre visitas, como cuentas o recetas guardadas.Abrir en el glosario →; 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 DefiniciónplanLa especificación dividida en tareas pequeñas, cada una terminada y comprobable por sí sola, en `tasks/plan.md`.Abrir en el glosario →, y solo después el código. Así tu proyecto se mantiene coherente de principio a fin.
Cómo se ve 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
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.
Comprobación rápida · 1 pregunta