Saltar al contenido
9/10
O Programación

OpenSpec

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):

ComandoQué 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:applyImplementa las tareas del plan
/opsx:archiveArchiva 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=0 o DO_NOT_TRACK=1, y en CI va apagada sola.
  • Red: solo hace una consulta al registro de npm durante openspec update para 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:explore y /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

Volver a Skills