OpenSpec: convertir una petición de código en documentos revisables
Desplegar OpenSpec en un equipo: CLI e instrucciones del proyecto
Revisa por separado la actualización del paquete y la regeneración de instrucciones.
Qué aprenderás
- Identificar lo que se instala
- Ensayar con un diff conservado
- Restaurar las dos partes
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
- CLI e instrucciones pueden desincronizarse.
- Los almacenes están documentados como beta.
- La restauración debe conservar planes humanos.
Identificar lo que se instala
El punto de partida documentado es una CLI de Node y archivos del proyecto. Una adopción de equipo empieza por versiones y asistentes compatibles, no por inventar un servicio Docker o un endpoint público.
Registra el método de instalación y la versión efectiva. Una CLI global nueva puede convivir con instrucciones antiguas. El README pide ejecutar openspec update dentro de cada proyecto después de actualizar el paquete.
Ensayar con un diff conservado
Elige un repositorio pequeño y guarda las instrucciones previas. Revisa comandos, perfiles y personalizaciones locales en Git. Aclara qué archivos se generan y qué contenido mantiene el equipo manualmente.
El README ofrece almacenes independientes para planes compartidos y cambios entre repositorios, pero los marca como beta. Añadirlos introduce responsabilidades de acceso y sincronización que un primer ensayo local quizá no necesita.
Restaurar las dos partes
Si una actualización cambia el flujo inesperadamente, restaura las instrucciones revisadas y la versión anterior registrada. Separa las modificaciones legítimas de propuestas de los archivos regenerados para no perder trabajo de planificación.
Esta serie no ejecutó un despliegue de equipo. Comprueba disponibilidad del paquete, compatibilidad e instrucciones generadas antes de estandarizar. El commit inspeccionado no demuestra que exista un binario publicado idéntico.
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
Registra Node, CLI y asistente.
- 2
Prueba paquete e instrucciones por separado.
- 3
Documenta la restauración de ambos.
Ejemplo para copiar
rollout:
node_minimum: 20.19.0
cli_version: record-installed-version
guidance: reviewed-git-diff
pilot: disposable-repository
rollback: previous-cli-and-guidancePreguntas frecuentes
¿Hace falta un servidor web?
No para el flujo local inicial documentado.
¿Actualizar npm renueva todos los proyectos?
El README indica ejecutar openspec update en cada proyecto.
Fuentes
- OpenSpec / README.mdFuente verificada 2026-09-23