OpenSpec: convertir una petición de código en documentos revisables
Construir un inspector de disponibilidad para OpenSpec
Explica dependencias y evidencia pendiente sin ejecutar automáticamente el comando recomendado.
Qué aprenderás
- Empezar con una vista de solo lectura
- Reutilizar las comprobaciones del grafo
- Demostrar la distinción importante
Antes de empezar
- Conocimientos básicos de Git y Node
- Repositorio de ejemplo desechable
Explica dependencias y evidencia pendiente sin ejecutar automáticamente el comando recomendado.
Conclusiones clave
- Es un ejercicio de extensión propuesto.
- Disponibilidad y evidencia son estados distintos.
- No ejecutes comandos recomendados automáticamente.
Empezar con una vista de solo lectura
Crea una vista local de identificadores, requisitos y estado registrado. Explica por qué tasks sigue bloqueado cuando falta design aunque specs esté completo. Usa primero un esquema sintético fijo.
Es una extensión propuesta, no una función existente atribuida al dashboard inspeccionado. Separa la explicación de disponibilidad de las columnas de revisión humana y pruebas de aplicación.
Reutilizar las comprobaciones del grafo
Cubre proposal inicial, la bifurcación specs/design, design pendiente, tasks disponible y finalización. Añade entradas inválidas solo después de elegir y revisar un validador; no presupongas que fromSchema lo proporciona.
Muestra el siguiente comando como texto revisable y no como una cadena que se ejecuta en shell. Trata nombres y rutas como datos; la primera versión del ejercicio no debe ejecutar comandos.
Demostrar la distinción importante
Presenta un cambio con todos los documentos de planificación y una prueba de aplicación fallida. La interfaz debe indicar planificación completa e implementación fallida o no verificada, sin mostrar publicación exitosa.
Entrega casos reproducibles, revisión de fuente y una captura de la explicación del bloqueo. Integrar asistentes reales, almacenes compartidos o ejecución de comandos exige una nueva revisión de comportamiento y seguridad.
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
Representa un esquema sintético sin escrituras.
- 2
Separa dependencias y evidencia de pruebas.
- 3
Demuestra planificación completa con una prueba fallida.
Ejemplo para copiar
{"planning":"complete","implementation":"test-failed","release":"not-verified","nextCommand":"display-only"}Preguntas frecuentes
¿El prototipo necesita un modelo?
No. Los estados sintéticos del grafo bastan para empezar.
¿Cómo se acepta el ejercicio?
Con casos reproducibles y una vista que no confunda planificación con implementación verificada.
Fuentes
- OpenSpec / src/core/artifact-graph/graph.tsFuente verificada 2026-09-23
- OpenSpec / src/core/change-status-policy.tsFuente verificada 2026-09-23
- OpenSpec / schemas/spec-driven/schema.yamlFuente verificada 2026-09-23