ProgramaciónOpenSpec
Es un marco de trabajo que obliga a acordar QUÉ se va a construir antes de escribir código. Cada cambio se guarda en una carpeta con propuesta, requisitos, diseño y tareas, para que tú y tu IA os alineéis antes de programar. Compatible con 30+ asistentes.
Revisada el 2026-09-21
- Popularidad
- 69.8k
- Licencia
- MIT
- Categoría
- Programación
Seguridad: revisada
Revisada, sin código malicioso.
¿Qué es?
Es una metodología de desarrollo guiado por especificaciones (SDD, por sus siglas en inglés). Antes de que la IA programe nada, se escribe qué se quiere y cómo se hará, en archivos markdown que tú revisas y apruebas.
Piénsalo como un contrato antes de empezar la obra: en vez de decir "hazme una casa" y que salga lo que sea, primero se acuerda el plano por escrito, se aprueba, y luego se construye.
El flujo (con el asistente):
| Comando | Qué hace |
|---|---|
/opsx:explore | "Pensar sin compromiso": la IA explora tu código y propone opciones antes de nada |
/opsx:propose <idea> | Crea la carpeta del cambio con 4 archivos |
/opsx:apply | Implementa las tareas del plan |
/opsx:archive | Archiva el cambio terminado y actualiza las especificaciones |
Cada cambio genera 4 archivos:
proposal.md— el porqué y qué cambia.specs/— los requisitos con escenarios concretos.design.md— el enfoque técnico.tasks.md— la lista de tareas a implementar.
Filosofía: fluido (no rígido), iterativo (no cascada), fácil, pensado para proyectos existentes y escalable de lo personal a lo empresarial.
Extras: un panel (dashboard) para ver los cambios, y la función "Stores" (beta) para planificar en un repo aparte y compartirlo con el equipo.
¿Cuándo me sirve?
Cuando haces cambios de software y quieres claridad antes de programar:
- "No sé cómo enfocar esto, ayúdame a pensarlo" →
/opsx:explore. - "Quiero añadir modo oscuro, organízalo" →
/opsx:propose. - "Implementa el plan que acordamos" →
/opsx:apply. - "Documenta qué se cambió" → queda guardado y archivado.
¿Esto me sirve a mí?
Sí, si haces cambios de software y quieres evitar malentendidos con la IA.
| Si un día piensas... | OpenSpec te da... |
|---|---|
| "La IA hace algo que no es lo que quería" | Acordar la especificación antes |
| "Me pierdo en proyectos grandes" | Cada cambio en su carpeta, con tareas |
| "Quiero revisar antes de que programe" | Apruebas el plan primero |
| "No queda registro de por qué se hizo algo" | Propuestas y diseños guardados |
| "Trabajo en equipo y cada uno planea a su aire" | "Stores": un plan compartido |
No te sirve si no programas o si solo haces retoques mínimos.
¿Es segura?
Veredicto: ✅ SÍ, es limpia (y muy transparente).
- Naturaleza: es una herramienta local de línea de comandos. Su propia política de seguridad dice: "no tiene servidor, ni escucha de red, ni demonio con privilegios". Solo lee y escribe markdown en la carpeta donde lo ejecutas.
- Telemetría (a tener en cuenta): recoge estadísticas anónimas: nombre del comando, versión y un identificador aleatorio. No recoge rutas, ni contenido, ni entorno, ni IP (desactivada explícitamente). Se apaga con
OPENSPEC_TELEMETRY=0oDO_NOT_TRACK=1, y en CI va apagada sola. - Red: solo hace una consulta al registro de npm durante
openspec updatepara ver si hay versión nueva. Se puede desactivar. - Dependencias: normales y conocidas (
commander,yaml,zod,chalk...). Nada raro. - Documentación de seguridad excelente: explica con detalle el modelo de amenazas. Muy buena señal.
Casos de uso
- Planificar un cambio:
/opsx:explorey/opsx:propose. - Tener un plan revisable: propuesta + specs + diseño + tareas.
- Implementar con orden:
/opsx:apply. - Cerrar y documentar:
/opsx:archive. - Trabajo en equipo: "Stores" (beta) para planes compartidos entre repos.
- Ver el estado: panel (dashboard).
Cómo se instala
npm install -g @fission-ai/openspec@latest
cd tu-proyecto
openspec init¿Dónde funciona?
| CLI | ¿Funciona? | Notas |
|---|---|---|
| OpenCode | ✅ Sí | Compatible |
| Claude Code | ✅ Sí | Compatible |
| Codex | ✅ Sí | Se invoca con $opsx-propose |
| Cursor | ✅ Sí | Se invoca como /opsx-propose |
| GitHub Copilot | ✅ Sí | /opsx-propose |
| Amazon Q | ✅ Sí | @opsx-propose |
| Otros | ✅ Sí | 30+ asistentes compatibles |
De los más compatibles: soporta más de 30 herramientas. El prefijo del comando cambia según el asistente (lo indica openspec init).
Enlaces
- Repositorio: https://github.com/Fission-AI/OpenSpec
- Web oficial: https://openspec.dev
- Flujo nuevo (
/opsx): https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md