Constructor de specs
Tu plantilla de spec, con los bloques que necesitas y en tu orden
1. Punto de partida
Cambiar de punto de partida reemplaza tus bloques.
2. Tus bloques
En el orden en que los leerá tu agente.
- 1ProblemaOSMP
- 2ObjetivoPAGSDSK
- 3Fuera de alcanceOSSKMPPAGSD
- 4Comportamiento esperadoOSSKPAGSD
- 5Casos límiteSKGSD
- 6Criterios de aceptaciónPAGSDMP
- 7No tocarPAGSD
- 8DecisionesOSMPSKGSD
- 9Por aclararSKOSGSD
- 10Cómo se compruebaPAGSDOS
3. Añade bloques
OS OpenSpec · SK Spec Kit · MP Matt Pocock · PA PAUL · GSD
Por qué
Qué
Cómo
Tareas
Verificación
Gobierno
4. Formato y revisión
Revisión rápida
- Hay una definición de terminado.
- Marcas lo que queda fuera.
5. Tu plantilla
Pégala en el repo o dásela a tu agente.
# [Nombre del cambio] ## Problema <!-- Qué duele, a quién y por qué ahora. De una a tres frases desde el usuario, sin solución. --> [Qué pasa hoy y a quién le duele.] ## Objetivo <!-- El resultado en una frase que se pueda comprobar: «X pasa de A a B». --> [X pasa de A a B.] ## Fuera de alcance <!-- Lo que no vas a hacer, cada cosa con su motivo. Es lo que evita que el agente se venga arriba. --> - [Lo que no se hace] — [por qué] ## Comportamiento esperado <!-- Ejemplos concretos que se convierten en test. Uno por comportamiento, incluido el camino de error. --> ### Escenario: [camino feliz] ```gherkin Given [estado inicial] When [acción] Then [resultado observable] ``` ### Escenario: [camino de error] ```gherkin Given [estado inicial] When [acción que falla] Then [error que ve el usuario] ``` ## Casos límite <!-- Permisos, errores, estados vacíos, límites, reglas de negocio y concurrencia. --> - ¿Qué pasa si [el usuario no tiene permiso]? - ¿Qué pasa si [la lista está vacía]? - ¿Qué pasa si [llegan dos peticiones a la vez]? ## Criterios de aceptación <!-- Hecho o no hecho, sin término medio. Cada tarea apunta a uno. --> ### AC-1: [Nombre] ```gherkin Given [estado inicial] When [acción] Then [resultado observable] ``` ## No tocar <!-- Ficheros y zonas que el agente no puede modificar, y el límite del alcance. --> ### Ficheros - `[ruta o patrón]` ### Límites del alcance - [Límite] ## Decisiones <!-- Qué eliges, por qué y qué descartaste. Sin rutas ni código. --> - **D-01**: [Decisión] — [razón]. Descartado: [alternativa] ## Por aclarar <!-- Lo que no está decidido. Mejor marcarlo que dejar que el agente lo invente. Tres como mucho. --> - [POR ACLARAR: …] ### Aclarado - P: … → R: … ## Cómo se comprueba <!-- Los comandos que tienen que pasar antes de dar el cambio por cerrado. --> - [ ] `[comando de test]` - [ ] `[lint o typecheck]` - [ ] [Comprobación a mano] <!-- Plantilla montada con el constructor de specs de Web Reactiva → https://www.webreactiva.com/herramientas/constructor-specs -->
Llévala a un flujo que no se pudra
Una spec suelta se queda vieja en dos commits. En la guía A fondo con OpenSpec la llevas por el ciclo completo sobre un proyecto real.
¿No sabes si tu cambio merece spec? Pásalo por el semáforo.
Cómo funciona
Parte de la plantilla de un sistema SDD o de la mínima, añade o quita bloques y ordénalos. Cada bloque lleva una pista de qué escribir y la notación de su sistema de origen: escenarios Given/When/Then, requisitos con MUST, tareas con fichero y verificación.
Una spec más larga no es una spec mejor. La revisión rápida te avisa cuando falta lo que el agente necesita para saber que ha terminado y cuando sobra ceremonia para un cambio pequeño.
Para seguir leyendo
Más herramientas
- SelectorSelector de modelo IAQué modelo usar para cada tarea de programaciónAbrir
- RevisorRevisor de AGENTS.mdQué le sobra y qué le falta a las reglas de tu agenteAbrir
- ComparativaComparativa de precios de IA para equiposLo que paga tu equipo al mes en cada plan de IAAbrir
- ComparativaComparador de agentes de IAClaude Code, Codex, Cursor y cuatro más, cara a caraAbrir
- ComparadorComparador de sistemas SDDOpenSpec, Spec Kit, GSD, PAUL y compañía: cuál encaja contigoAbrir
- CalculadoraSuscripción de IA vs APICuánto te costaría por tokens lo que hoy pagas a plazo fijoAbrir
- CalculadoraCuánto cuesta tu agenteEl paso 30 no cuesta como el paso 1, y esa es la facturaAbrir
- ContadorContador de tokens y costePega un texto y mira lo que cuesta en cada modeloAbrir
- RevisorRevisor de SKILL.mdComprueba tu skill antes de instalarlaAbrir
12 recursos para developers cada domingo en tu bandeja de entrada
Además de una skill práctica bien explicada, trucos para mejorar tu futuro profesional y una pizquita de humor útil para el resto de la semana. Gratis.