OpenSpec: convertir una petición de código en documentos revisables
OpenSpec: convertir una petición de código en documentos revisables
Distingue propuesta, requisitos, diseño y tareas antes de autorizar cambios al asistente.
Qué aprenderás
- Conservar el acuerdo fuera del chat
- Entender el papel del asistente
- Leer el estado de finalización
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
- Los documentos conservan acuerdos fuera del chat.
- Los comandos dependen de la interfaz.
- Planificar no equivale a publicar.
Conservar el acuerdo fuera del chat
OpenSpec organiza un cambio en documentos Markdown: la propuesta explica el motivo, las especificaciones describen comportamiento, el diseño recoge decisiones y las tareas siguen el trabajo. Git conserva ese acuerdo junto al código.
Para una exportación CSV, las filas incluidas y el escape de comas son requisitos observables. Elegir una biblioteca pertenece al diseño. Separarlos evita cambiar el contrato cuando solo cambia la implementación.
Entender el papel del asistente
La CLI inicializa instrucciones para la herramienta elegida; el asistente las utiliza para proponer e implementar cambios. Instalar OpenSpec no instala un modelo ni proporciona credenciales o pruebas de la aplicación.
Los comandos de terminal y del asistente son distintos. La forma de proponer varía entre herramientas: Codex usa $openspec-propose. Consulta la invocación impresa durante la inicialización en lugar de pegar un comando de chat en la terminal.
Leer el estado de finalización
En la revisión 1d35e9, terminar los documentos de planificación conduce a instrucciones para inspeccionar la implementación. No significa que las pruebas pasaran o que el cambio esté publicado. Conserva evidencias separadas.
Esta serie inspecciona fuentes fijadas y ejecuta seis comprobaciones sobre la clase pura del grafo. No ejecuta la CLI completa, un asistente de programación ni un despliegue de la aplicación.
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
Escoge un comportamiento observable.
- 2
Separa requisito y elección técnica.
- 3
Asigna una persona revisora.
Ejemplo para copiar
proposal.md: motivo de exportar CSV
specs/: comportamiento observable
design.md: codificación y biblioteca
tasks.md: implementación y verificaciónPreguntas frecuentes
¿OpenSpec escribe código por sí solo?
El flujo documentado utiliza tu asistente y su entorno de ejecución.
¿Se probó todo el flujo?
No. La prueba ejecutada cubre únicamente la clase pura del grafo.
Fuentes
- OpenSpec / README.mdFuente verificada 2026-09-23
- OpenSpec / schemas/spec-driven/schema.yamlFuente verificada 2026-09-23
- OpenSpec / src/core/change-status-policy.tsFuente verificada 2026-09-23