Spec Kit: de intención comprobable a aceptación trazable
Límites operativos de Spec Kit: hooks, actualizaciones y el significado de Converged
Protege instrucciones y autoridad de publicación revisando los efectos alrededor del análisis y la convergencia de solo añadido.
Qué aprenderás
- Un contrato de prompt no es un sandbox
- Revisar personalizaciones con consecuencias
- Separar aceptación y permiso de publicación
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
- Las restricciones centrales no aíslan hooks externos.
- La falta de evidencia de un control no es éxito.
- Converged es una evaluación, no permiso de publicar.
Un contrato de prompt no es un sandbox
Analyze pide un informe de solo lectura y converge limita su escritura central a añadir una fase en tasks.md. Ambos describen hooks previos y posteriores. Un hook puede ejecutar comportamiento adicional: esas restricciones no crean un aislamiento técnico alrededor de toda la sesión.
Las plantillas informan configuración inválida de extensiones y continúan, posiblemente sin comprobar hooks obligatorios. Las condiciones no vacías se dejan al HookExecutor, no se evalúan en el prompt. “Análisis terminado” no demuestra que todos los controles organizativos se ejecutaran correctamente.
Revisar personalizaciones con consecuencias
Un preset o extensión cambia instrucciones o capacidades; un bundle puede instalar varios componentes. Revisa fuente, versión y órdenes efectivas. El README advierte que las contribuciones comunitarias tienen mantenimiento independiente. Reconocer el nombre del proyecto no equivale a auditar cada componente.
No copies inicialización --force o self upgrade sin considerar los archivos y la instalación afectados. Excluye credenciales y requisitos confidenciales del ejercicio sintético. Este artículo no cambió principios, instaló hooks ni concedió escritura externa.
Separar aceptación y permiso de publicación
Converge evalúa código actual, no historial Git, y añade tareas trazables para comportamiento ausente, parcial, contradictorio o no solicitado. No repara código, elimina funcionalidades ni publica versiones por sí mismo. Un resultado limpio depende de la calidad de los artefactos y del análisis.
Mantén pruebas y revisión independientes antes del despliegue y comprueba la revisión publicada después. Si una restricción exige bloquear cuando falta evidencia, implementa y prueba esa política explícitamente; Markdown por sí solo no la garantiza. No afirmamos una auditoría completa ni pruebas adversariales.
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
Inspecciona hooks y autoridad.
- 2
Registra configuración inválida y controles omitidos.
- 3
Revisa efectos de inicialización y actualización.
- 4
Exige aceptación y verificación de producción independientes.
Ejemplo para copiar
{
"controlPropuesto": true,
"evaluacion": "convergente",
"evidenciaHooksObligatorios": null,
"pruebasIndependientes": null,
"publicacionAutorizada": false,
"produccionVerificada": false
}Preguntas frecuentes
¿Un hook de análisis puede tener efectos?
Las plantillas permiten invocarlo; revisa su comportamiento concreto.
¿Converge elimina código no solicitado?
No. Su acción central documentada es añadir una tarea de revisión o reparación.
Fuentes
- Spec Kit / templates/commands/analyze.mdFuente verificada 2026-09-14
- Spec Kit / templates/commands/converge.mdFuente verificada 2026-09-14
- Spec Kit / README.mdFuente verificada 2026-09-14
- Spec Kit / scripts/powershell/check-prerequisites.ps1Fuente verificada 2026-09-14