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.

  1. 1
    ProblemaOSMP
  2. 2
    ObjetivoPAGSDSK
  3. 3
    Fuera de alcanceOSSKMPPAGSD
  4. 4
    Comportamiento esperadoOSSKPAGSD
  5. 5
    Casos límiteSKGSD
  6. 6
    Criterios de aceptaciónPAGSDMP
  7. 7
    No tocarPAGSD
  8. 8
    DecisionesOSMPSKGSD
  9. 9
    Por aclararSKOSGSD
  10. 10
    Có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

Escenarios
Opciones

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 -->
Guía premium

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.

Ver la guía
¿Qué sistema SDD encaja con tu forma de trabajar?Cuatro preguntas y te digo si te va OpenSpec, Spec Kit, PAUL, GSD o Superpowers.Compararlos

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

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.