Spec Kit: de intención comprobable a aceptación trazable
Primer ejercicio con Spec Kit: requisitos comprobables en vez de prosa vaga
Practica una lista de lectura pequeña con escenarios de aceptación, incógnitas explícitas y revisión de coherencia antes de implementar.
Qué aprenderás
- Describir primero el resultado observable
- Resolver incógnitas antes de convertirlas en arquitectura
- Revisar coherencia antes de implementar
Antes de empezar
- Conceptos básicos de requisitos, Git y pruebas
- Distinguir desarrollo local y despliegue de aplicación
Trazar una funcionalidad desde intención hasta evidencia y separar contratos de comportamiento verificado.
Conclusiones clave
- La aceptación necesita un resultado observable.
- Una decisión pendiente de alcance no debe ocultarse como valor técnico predeterminado.
- Revisa los hallazgos antes de aprobar correcciones.
Describir primero el resultado observable
Usa un proyecto desechable y una lista sintética con títulos públicos de ejemplo. El primer recorrido consiste en guardar un elemento y volver a verlo tras reiniciar. Define también duplicados y entradas inválidas. No elijas una base de datos dentro del requisito únicamente porque conoces un framework.
La plantilla separa historias, requisitos funcionales y criterios de éxito. Un escenario necesita estado inicial, acción y resultado observable. “Guardar de forma fiable” es impreciso; “guardar un elemento válido y encontrarlo una sola vez después de reiniciar” ofrece una comprobación concreta.
Resolver incógnitas antes de convertirlas en arquitectura
Anota si la lista será local al dispositivo o compartida entre cuentas. Esa decisión cambia privacidad, sincronización y despliegue. Aclara antes del plan técnico cuando las alternativas cambien materialmente el producto; un supuesto generado no equivale a una decisión del usuario.
En la integración elegida, utiliza los equivalentes instalados de constitución, especificación, aclaración cuando proceda, plan y tareas. La forma de invocarlos cambia entre integraciones: no pegues una orden de agente desconocida en el terminal del sistema. Aquí explicamos el proceso sin afirmar que ejecutamos una sesión real.
Revisar coherencia antes de implementar
Analyze compara spec.md, plan.md y tasks.md después de generar tareas. Busca requisitos sin cobertura, tareas sin propósito, decisiones de almacenamiento contradictorias y criterios imposibles de probar. El informe debe señalar una ubicación concreta y explicar el desacuerdo, no limitarse a una puntuación.
Revisa el informe antes de autorizar cambios. Su contrato central es de solo lectura, pero la instrucción también describe hooks e invoca un auxiliar de prerrequisitos; esos mecanismos necesitan una revisión independiente de efectos. Producir recomendaciones no equivale a aprobar todas las modificaciones propuestas.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Escribe el escenario de guardar y reiniciar.
- 2
Define duplicados y registra incógnitas.
- 3
Relaciona requisito, decisión y tarea.
- 4
Comprueba coherencia antes de implementar.
Ejemplo para copiar
{
"sintetico": true,
"inicio": "un elemento público válido",
"accion": "guardar y reiniciar",
"resultado": "aparece exactamente una vez",
"incognita": "local o compartido entre cuentas",
"implementacionAutorizada": false
}Preguntas frecuentes
¿La especificación debe elegir inmediatamente la base de datos?
Solo si es una restricción real; de otro modo, la decisión corresponde al plan.
¿Analyze aplica automáticamente sus recomendaciones?
Su contrato central exige informe de solo lectura y aprobación separada; revisa hooks y auxiliares por separado.
Fuentes
- Spec Kit / templates/spec-template.mdFuente verificada 2026-09-14
- Spec Kit / templates/commands/analyze.mdFuente verificada 2026-09-14
- Spec Kit / README.mdFuente verificada 2026-09-14