Repaso y práctica
Puntos clave
- Una especificación es una nota de trabajo breve y en lenguaje sencillo — qué vas a construir y qué no — no un contrato que congelas; una página es suficiente.
- Aclara el problema y la persona antes de las funciones, y anota los no objetivos: son tu defensa más afilada contra una IA que añade extras "útiles".
- Las historias de usuario con una cláusula "para" y un pequeño PRD con una línea concreta de "cuándo está terminado" convierten la intención en comportamiento comprobable y construible.
- Fija pronto el modelo de datos — los nombres de los campos se filtran por todas partes — y divide la especificación en tareas del tamaño justo que puedas verificar una a la vez.
- Describe el problema, no la solución; los resultados siguen siendo baratos de cambiar en una especificación y costosos de cambiar en código. Mantén viva la especificación a medida que aprendes.
Ponlo en práctica
Toma cualquier idea que hayas estado postergando y conviértela en una especificación de una página en una sola de IA. Haz que la IA te entreviste primero con cinco preguntas afiladas, y luego escribe — con tus propias palabras — el problema, el usuario, tres historias de usuario (cada una con su "para"), una lista explícita de no objetivos, un modelo de datos de seis líneas y una línea de "cuándo está terminado" que puedas realizar físicamente. Guárdala como SPEC.md. La prueba de una buena especificación: podrías pegarla en un chat completamente nuevo mañana y la IA sabría exactamente qué construir.
Instrucción del capítulo
I have a rough idea: <one-line description>.
Act as my product thinking partner. First, ask me 5 sharp questions,
one at a time, to clarify the problem, the target user, and what "done"
looks like. Don't propose features yet.
After I answer, draft a one-page spec with these sections:
- Problem - User - Goal
- In Scope (v1) - Non-Goals (v1)
- User stories (each "As a __, I want __, so that __")
- Data model (a short list of fields)
- Done When (a concrete, physically-performable acceptance test)
Keep it tight — under one page. If something is ambiguous, ask before
assuming. I'll edit the draft until I agree with every line.