TL;DR
- OpenSpec (Fission AI, MIT, CLI de npm
@fission-ai/openspec) es un sistema de artefactos de specs: specs vivas, carpetas por cambio, specs delta y flujos/opsx:*respaldados por una CLI que las skills consultan para obtener el estado estructurado. - Superpowers (Jesse Vincent / Prime Radiant, MIT, plugin) es una capa que aplica una metodología: skills que se activan automáticamente y definen cómo el agente explora ideas, planifica, implementa (TDD), revisa y finaliza ramas, sin imponer una estructura de specs en el repo.
- Resuelven distintos modos de fallo. OpenSpec evita que los requisitos se pierdan en el chat: los convierte en specs duraderas que se pueden fusionar. Superpowers evita que los agentes omitan el diseño, las pruebas, las revisiones y las buenas prácticas de worktrees.
- Generación de specs: OpenSpec produce artefactos estructurados (
proposal.md,spec.mddelta,design.md,tasks.md) enopenspec/changes/. Superpowers produce secciones de diseño conversacional y un plan de microtareas mediante las skillsbrainstormingywriting-plans, no un árbol formal de specs, a menos que tú lo agregues. - Implementación:
/opsx:applyde OpenSpec recorretasks.mdy actualiza las casillas. Superpowers utilizasubagent-driven-developmentoexecuting-plans, aplica TDD RED/GREEN y ejecuta una revisión en dos etapas: cumplimiento de la spec y luego calidad del código. - Se pueden combinar. OpenSpec se encarga de qué construir y de la trazabilidad; Superpowers, de cómo ejecuta el agente el trabajo con disciplina. Por defecto, ninguno reemplaza al otro.
Qué aprenderás aquí
- Qué optimiza cada herramienta, OpenSpec y Superpowers, y por qué no son sustitutos directos
- Una comparación función por función de flujos integrados, artefactos e interfaces para agentes
- En qué difiere la generación de specs: specs delta estructuradas frente a diseño conversacional + planes
- En qué difiere la implementación: aplicación guiada por tareas frente a pipelines de TDD + subagentes/revisión
- Consideraciones de plataforma, especialmente las limitaciones de Cursor para los subagentes de Superpowers
- Una tabla de decisión para elegir uno, el otro o ambos
- Un ejemplo concreto que lleva la misma funcionalidad por cada conjunto de herramientas
- Cómo usar el selector Spec workflow picker de la barra lateral para navegar entre todas las comparaciones de estas tres herramientas en este sitio
El July 14, 2026, revisé la documentación vigente de OpenSpec (opsx.md, workflows.md, commands.md, README), los metadatos de npm para @fission-ai/openspec@1.6.0, el README de Superpowers y la versión v6.1.1 (July 2, 2026), los archivos de skills de Superpowers (writing-plans, executing-plans, subagent-driven-development), las notas de versión y el anuncio original de Superpowers de Jesse Vincent. Las conclusiones comparativas sobre su adecuación a los equipos y la combinación de las herramientas son inferencias editoriales, salvo que estén vinculadas a una fuente primaria.
Por qué estas dos herramientas aparecen juntas
Ambos proyectos entraron en la misma conversación durante el mismo periodo (finales de 2025 – mediados de 2026) como respuesta al mismo problema principal: los asistentes de programación con IA avanzan rápido, pero el proceso se desmorona cuando todo vive en el chat.
Difieren en la solución:
| Perspectiva | OpenSpec | Superpowers |
|---|---|---|
| Metáfora principal | Specs vivas + deltas de cambio | Skills obligatorias + disciplina de SDLC |
| Qué se guarda en git | openspec/specs/, openspec/changes/<name>/ | Planes por defecto en docs/superpowers/plans/; documentos de diseño según la skill (sin árbol de specs delta) |
| Forma del proceso | Acciones fluidas (propose, apply, archive) | Cadena de skills activadas automáticamente (explorar ideas → planificar → implementar → revisar) |
| Entorno de ejecución | Node.js 20.19+, CLI @fission-ai/openspec | Plugin por harness (Cursor, Claude Code, Codex, …) |
| Interfaz para agentes | Skills y comandos /opsx:* (30+ herramientas) | Archivos SKILL.md componibles + inicialización al comenzar la sesión |
| Enfoque para proyectos existentes | Explícito: las specs describen el comportamiento actual; los cambios son deltas | Neutral: funciona en cualquier repo git; pone énfasis en worktrees + TDD |
| Personalización | schema.yaml, plantillas, openspec/config.yaml | Editar skills localmente; el proyecto original acepta PRs de skills de forma limitada |
OpenSpec se compara con Spec Kit y Kiro en su README. Superpowers se compara con la programación ad hoc mediante agentes en su README y en la publicación de lanzamiento. Son capas adyacentes, no la misma categoría de producto; por eso resulta útil compararlas lado a lado.
┌─────────────────────────────────────┐
│ Your coding agent │
└─────────────────┬───────────────────┘
│
┌───────────────────────┴───────────────────────┐
│ │
▼ ▼
┌──────────────────────┐ ┌──────────────────────┐
│ Superpowers │ │ OpenSpec │
│ HOW the agent works │ │ WHAT you're building │
│ TDD, reviews, │ │ specs, deltas, │
│ worktrees, subagents│ │ archive, sync │
└──────────────────────┘ └──────────────────────┘
│ │
└───────────────────────┬───────────────────────┘
▼
Application code + tests
Configuración lado a lado
OpenSpec
npm install -g @fission-ai/openspec@latest
cd your-repo
openspec init
# optional: openspec init --tools cursor,claude
# optional: openspec config profile && openspec update # expanded workflows
Después de la inicialización, OpenSpec crea openspec/specs/, openspec/changes/, el archivo opcional openspec/config.yaml y skills/comandos específicos del harness (por ejemplo, .cursor/skills/openspec-propose/SKILL.md y .cursor/commands/opsx-propose.md).
Superpowers
En el chat de Cursor Agent:
/add-plugin superpowers
También puedes instalarlo desde el marketplace de plugins en Claude Code, Codex, Factory Droid, Copilot CLI, OpenCode, Pi, Kimi Code y otros. No hay un paso de inicialización del repo: el plugin inyecta la inicialización using-superpowers al comenzar la sesión.
OpenSpec entry points Superpowers entry points
───────────────────── ────────────────────────
Terminal: openspec init Plugin: /add-plugin superpowers
Terminal: openspec list|validate Automatic: skills trigger on context
AI chat: /opsx:propose Implicit: "help me build X" → brainstorming
AI chat: /opsx:apply Implicit: approved design → writing-plans → implement
Funciones integradas: comparación lado a lado
Flujo principal (respaldado por fuentes)
| Capacidad | OpenSpec | Superpowers |
|---|---|---|
| Exploración antes de programar | /opsx:explore — compañero para explorar ideas, con captura opcional de artefactos | brainstorming — preguntas socráticas, diseño en secciones fáciles de asimilar |
| Generación de specs / diseño | /opsx:propose o /opsx:continue del perfil ampliado — propuesta, specs, diseño, tareas | brainstorming → documento de diseño guardado; writing-plans → plan de microtareas |
| Requisitos vivos | Specs delta en openspec/changes/<name>/specs/; specs principales en openspec/specs/ | Sin modelo de specs delta de primera clase; el plan es el contrato durante la implementación |
| Ejecución de la implementación | /opsx:apply — recorre tasks.md y marca casillas | subagent-driven-development o executing-plans — asignación de tareas + revisión |
| Disciplina de pruebas | Se menciona en las instrucciones de apply; no se exige de forma centralizada | test-driven-development — RED/GREEN/REFACTOR obligatorio; elimina el código escrito antes de las pruebas |
| Revisión de código | No es una fase integrada dedicada | requesting-code-review + revisión en dos etapas en el flujo con subagentes |
| Aislamiento de ramas | Tu flujo de git; OpenSpec no administra worktrees | using-git-worktrees — crea una rama/worktree después de aprobar el diseño |
| Verificación antes de finalizar | /opsx:verify (perfil ampliado) | verification-before-completion, finishing-a-development-branch |
| Archivar / fusionar specs | /opsx:archive, /opsx:sync, /opsx:bulk-archive | finishing-a-development-branch — opciones para fusionar/crear un PR/descartar |
| Flujo de depuración | No especializado | systematic-debugging — proceso de causa raíz en 4 fases |
| Planificación entre repos | Stores (beta) — repo compartido de OpenSpec | No está integrado |
Interfaz para agentes
| Interfaz | OpenSpec | Superpowers |
|---|---|---|
| Skills | openspec-propose, openspec-explore, openspec-apply-change, openspec-sync-specs, openspec-archive-change, … | 14 skills documentadas de pruebas, depuración, colaboración y meta |
| Comandos con barra | /opsx:propose, /opsx:apply, /opsx:archive, … (según el perfil) | No tiene un conjunto equivalente de comandos: el comportamiento está guiado por skills |
| Integración con CLI | Central — openspec status --json, openspec instructions --json | Ninguna: las skills son archivos Markdown autocontenidos |
| Inicialización de sesión | Invocación por comando o por skill | Un hook al inicio de la sesión carga using-superpowers automáticamente |
| Modelo de activación | El usuario invoca un comando o una skill | El agente debe buscar y aplicar las skills relevantes antes de actuar |
Las skills de OpenSpec no son prompts decorativos. Consultan la CLI para obtener el estado estructurado antes de escribir un artefacto a la vez:
User: /opsx:continue
│
├─► openspec status --change add-dark-mode --json
├─► openspec instructions specs --change add-dark-mode --json
├─► read dependency artifacts (proposal.md, …)
└─► write ONE artifact (e.g. delta spec)
Superpowers invierte ese modelo: el agente busca skills aplicables antes de cada tarea, y las skills codifican comportamientos obligatorios (TDD, controles de revisión, configuración de worktrees).
Grafo de artefactos predeterminado (esquema spec-driven de OpenSpec)
El esquema predeterminado de OpenSpec produce cuatro tipos de artefactos vinculados:
proposal ──→ specs ──→ design ──→ tasks ──→ /opsx:apply
Las specs delta usan secciones ADDED / MODIFIED / REMOVED para que los cambios en proyectos existentes sigan siendo auditables. Al archivar, los deltas se fusionan en openspec/specs/<capability>/spec.md.
La cadena predeterminada de Superpowers (según el README):
brainstorming ──→ using-git-worktrees ──→ writing-plans
│
└──► subagent-driven-development | executing-plans
│
├── test-driven-development (during each task)
├── requesting-code-review (between tasks)
└── finishing-a-development-branch
El plan de Superpowers enfatiza tareas de 2–5 minutos con rutas de archivo exactas, pasos de verificación y suficiente detalle para que un «ingeniero junior con mal gusto» pueda ejecutarlo: una granularidad distinta a la de tasks.md de OpenSpec, que registra elementos de una lista de implementación vinculados a las specs.
Generación de specs: dónde difieren realmente
Este es el centro de la comparación para arquitectos.
OpenSpec: specs como artefactos duraderos del repo
OpenSpec trata las especificaciones como archivos de primera clase y versionados:
- Las specs principales describen el comportamiento actual del sistema (
openspec/specs/). - Las carpetas de cambios contienen la propuesta, las specs delta, el diseño y las tareas (
openspec/changes/<name>/). - El archivo mueve los cambios completados a
openspec/changes/archive/y, de forma opcional, sincroniza los deltas con las specs principales. - La configuración del proyecto (
openspec/config.yaml) inyecta el contexto del stack y reglas por artefacto (por ejemplo, escenarios Given/When/Then).
Ventajas (respaldadas por fuentes + inferencia):
| Ventaja | Por qué importa |
|---|---|
| Modelo delta para proyectos existentes | Los cambios en los requisitos se expresan explícitamente con ADDED/MODIFIED/REMOVED, en lugar de reescribir documentos de origen incierto |
| Historial de specs legible para el equipo | Los PMs y otros ingenieros pueden leer las specs sin tener que reconstruir el chat |
| Grafo de artefactos validado por la CLI | Las dependencias entre artefactos se pueden verificar automáticamente |
| Esquemas personalizados | Los equipos pueden definir sus propios tipos de artefactos mediante schema.yaml |
| Stores (beta) | Las funcionalidades que abarcan varios repos pueden compartir un único espacio de planificación |
Desventajas (inferencia):
- Requiere inicialización, convenciones y ejecutar
openspec updateocasionalmente después de las actualizaciones. - La calidad de las specs sigue dependiendo del modelo + las plantillas: OpenSpec permite editar las plantillas, pero alguien tiene que mantenerlas.
Superpowers: specs como conversación negociada → plan
Superpowers genera specs mediante skills, no con un esquema de directorios fijo:
brainstorming— Refina la intención mediante preguntas y presenta el diseño en secciones cortas para que una persona lo apruebe.writing-plans— Convierte el diseño aprobado en un plan de implementación granular (ruta de guardado predeterminada:docs/superpowers/plans/).
A partir de Superpowers v6.x, brainstorming y writing-plans usan listas de autoverificación integradas durante la creación de la spec o el plan, en lugar de ciclos de revisión con subagentes: es más rápido, pero sigue sin ser un modelo de specs delta que se puedan fusionar.
No hay una función integrada para fusionar specs delta, un árbol de specs orientado a capacidades ni un equivalente de /opsx:sync. El plan se convierte en el contrato de implementación para esa sesión/rama.
Ventajas (respaldadas por fuentes + inferencia):
| Ventaja | Por qué importa |
|---|---|
| Sin trámites en el repo | Instalas el plugin y el comportamiento cambia de inmediato |
| Activación automática | No hace falta recordar comandos con barra: las skills se activan según el contexto |
| Secciones de diseño fáciles de leer | La publicación de lanzamiento enfatiza secciones fáciles de asimilar, no bloques interminables de Markdown |
| Skills probadas bajo presión | El autor documenta evaluaciones basadas en escenarios para comprobar el cumplimiento de las skills |
Desventajas (inferencia):
- Los requisitos son menos duraderos entre sesiones, a menos que hagas commit manualmente de los archivos de diseño/plan.
- Es más difícil que varios equipos usen las specs como «fuente de verdad» sin agregar OpenSpec o algo similar.
- El comportamiento de las skills varía según el harness (consulta las notas de plataforma más abajo).
Tabla comparativa de generación de specs
| Dimensión | OpenSpec | Superpowers |
|---|---|---|
| Ubicación de salida | openspec/changes/<name>/ | Por defecto, docs/superpowers/plans/YYYY-MM-DD-<topic>.md (se puede cambiar) |
| Formato de requisitos | Escenarios estructurados + secciones delta | Diseño conversacional + plan de tareas |
| Fusión con la spec canónica | /opsx:sync al archivar | No está integrado |
| Specs para varias capacidades | specs/<capability>/spec.md por dominio | No está integrado |
| Explorar sin comprometerse | /opsx:explore | brainstorming (puede permanecer como conversación) |
| Personalización | Plantillas, esquemas, reglas de configuración | Hacer fork/editar skills; PRs de skills al proyecto original de forma limitada |
Implementación: de dónde viene la disciplina
OpenSpec /opsx:apply
Según la documentación de comandos de OpenSpec, /opsx:apply:
- Lee
tasks.mde identifica los elementos incompletos. - Implementa las tareas una por una: código, archivos y pruebas según sea necesario.
- Marca las tareas completadas.
- Puede actualizar los artefactos cuando la implementación revela vacíos en la spec (flujo fluido).
OpenSpec no exige de forma centralizada TDD, asignación de subagentes ni revisión en dos etapas. Eso depende de las reglas de tu agente, el modelo y cualquier plugin que cubra esas funciones.
Stack de implementación de Superpowers
Superpowers trata la implementación como un pipeline con puntos de control:
| Skill | Función |
|---|---|
using-git-worktrees | Rama aislada + línea base de pruebas sin fallos antes de programar |
writing-plans | Microtareas con pasos de verificación |
subagent-driven-development | Un subagente nuevo por tarea + revisión en dos etapas |
executing-plans | Ejecución con un solo agente en harnesses sin soporte para subagentes (alternativa) |
test-driven-development | Primero hace que la prueba falle; elimina el código escrito antes de las pruebas |
requesting-code-review | Problemas clasificados por gravedad; los críticos bloquean el avance |
finishing-a-development-branch | Pruebas en verde → fusionar/crear un PR/descartar |
El README afirma que puede ejecutar procesos autónomos de varias horas que se mantienen fieles al plan. Es una afirmación del autor, no un benchmark. Tómala como una intención de diseño, no como un SLA.
Consideración de plataforma: soporte de subagentes en el harness
Superpowers trata la orquestación de subagentes como una capacidad del harness, no como algo que todas las instalaciones del plugin obtienen por igual.
Según las notas de versión de Superpowers v6.x y la skill executing-plans (July 2026):
- Harnesses con capacidad para subagentes (enumerados explícitamente): Claude Code, Codex CLI, Codex App, Copilot CLI.
subagent-driven-developmentes obligatorio en esos harnesses después de aprobar el plan.executing-plansestá reservado para harnesses sin capacidad para subagentes e indica al usuario que Superpowers funciona mejor en plataformas que sí la tienen.
Cursor es compatible como plugin, pero no figura entre los harnesses de Superpowers con capacidad para subagentes en la versión v6.1.1. En Cursor, espera executing-plans (ejecución de tareas en línea con puntos de control) en lugar del ciclo completo de asignación de subagentes, a menos que Superpowers agregue posteriormente Cursor a su lista de plataformas con capacidad para subagentes.
El /opsx:apply de OpenSpec es independiente del harness: consiste en instrucciones y archivos de tareas, no en infraestructura de subagentes.
| Harness | OpenSpec | Superpowers |
|---|---|---|
| Cursor | Skills completas + /opsx:* | Plugin + hook de sesión; ruta executing-plans (sin capacidad para subagentes según la documentación de Superpowers) |
| Claude Code | Skills y comandos completos | Stack completo de skills + subagent-driven-development |
| Codex / Pi / otros | Compatible mediante openspec init --tools | Instalación separada del plugin por harness; consulta la lista de plataformas con capacidad para subagentes |
Extensibilidad y personalización
OpenSpec
openspec/config.yaml— contexto del proyecto + reglas por artefacto.schema.yaml+ plantillas — grafos de artefactos personalizados (existe un catálogo de esquemas de la comunidad).- Perfiles de flujo —
core(propose/explore/apply/sync/archive) frente al ampliado (new/continue/ff/verify/bulk-archive/onboard). - Stores (beta) — repos independientes de planificación compartidos entre repos de código.
La documentación de OPSX de OpenSpec plantea explícitamente la personalización como la edición de plantillas/esquemas sin esperar a nuevas versiones del paquete.
Superpowers
- Biblioteca de skills — 14 skills documentadas que cubren pruebas, depuración, colaboración y meta.
writing-skills— meta-skill para crear y probar bajo presión nuevas skills.- Actualizaciones del plugin — a menudo automáticas según el harness.
- Política de contribución — el README indica que, en general, no aceptan nuevas skills en el proyecto original; los cambios deben funcionar en todos los agentes compatibles.
Superpowers optimiza la consistencia del comportamiento. OpenSpec optimiza la flexibilidad de los artefactos.
Cuándo usar cada uno
| Situación | Preferir OpenSpec | Preferir Superpowers | Usar ambos |
|---|---|---|---|
| Aplicación existente con requisitos que evolucionan | ✓ specs delta + archivo | ✓ combinación habitual | |
| Proyecto individual rápido, sin necesidad de historial de specs | ✓ poca ceremonia | ||
| El equipo necesita una fuente de verdad legible para las specs | ✓ | ✓ agregar Superpowers para TDD/revisiones | |
| El agente omite pruebas y revisiones | ✓ skills obligatorias de TDD + revisión | ✓ | |
| Planificación de funcionalidades entre repos | ✓ Stores (beta) | ||
| Equipo que solo usa Cursor | ✓ conjunto completo de comandos | parcial (sin subagentes completos) | ✓ |
| Entorno regulado / historial de auditoría para requisitos | ✓ carpetas de cambios archivadas | parcial (solo planes) | ✓ |
| Depuración de incidentes en producción | ✓ skill systematic-debugging |
Criterio editorial: Si debes elegir uno, elige OpenSpec cuando la trazabilidad de las specs y los deltas en proyectos existentes sean el cuello de botella; elige Superpowers cuando lo sea la disciplina del agente (TDD, revisiones, worktrees).
La misma funcionalidad, dos rutas
Funcionalidad: Agregar reproducción de un resumen de audio de artículos a un devlog de Astro.
Ruta A — OpenSpec
/opsx:explore → clarify delivery (inline player vs modal), scope caps
/opsx:propose article-audio-summary-pipeline
→ proposal.md, delta specs (ui, generation, delivery),
design.md, tasks.md
/opsx:apply → implement tasks; check off items
/opsx:archive → sync deltas into openspec/specs/; archive change
Los artefactos permanecen legibles para el siguiente ingeniero, incluidos los requisitos que el agente ya no tiene que volver a deducir del chat.
Ruta B — Superpowers
"Help me add audio summaries to articles"
→ brainstorming: questions on UX, storage, generation API
→ design sections approved
→ using-git-worktrees: feat/article-audio branch
→ writing-plans: 2–5 min tasks with file paths + verification
→ executing-plans or subagent-driven-development
→ test-driven-development on each task
→ finishing-a-development-branch: PR or merge
Obtienes buenas prácticas sólidas de implementación. Los requisitos duraderos quedan donde las skills los hayan escrito, a menos que adoptes OpenSpec (o algo similar) para la capa de specs.
Ruta C — Combinada (inferencia)
OpenSpec: /opsx:propose + delta specs ← WHAT + traceability
Superpowers: TDD + review skills ← HOW with discipline
Este no es un producto integrado oficial: es un stack práctico que muchos equipos pueden armar manualmente.
Riesgos de combinarlos (inferencia): Ambas herramientas inyectan skills y reglas de comportamiento. Sin coordinación, puedes terminar con fases de planificación duplicadas (OpenSpec /opsx:propose más Superpowers brainstorming) o instrucciones de git/worktree contradictorias. Un patrón práctico: usa OpenSpec para crear artefactos y luego deja que las skills de Superpowers se encarguen únicamente de las buenas prácticas de implementación.
Resumen de ventajas
| OpenSpec | Superpowers | |
|---|---|---|
| Ventaja principal | Specs duraderas que se pueden fusionar y están vinculadas a los cambios | Skills obligatorias de SDLC que evitan que el agente tome atajos |
| Huella en el repo | Árbol openspec/ + skills/comandos generados | Solo plugin; archivos Markdown de salida opcionales |
| Mejor para arquitectos | Specs de capacidades, deltas, historial de auditoría archivado | Aislamiento mediante worktrees, controles de revisión, flujo de finalización |
| Mejor para implementadores | Lista clara en tasks.md derivada de las specs | Skill de TDD, microplanes, revisión entre tareas |
| Punto más débil | Aplicación del comportamiento del agente | Gestión de specs canónicas de larga duración |
| Licencia / costo | MIT, CLI de npm | MIT, plugin gratuito |
Fuentes
Fuentes primarias consultadas el July 14, 2026:
- README de OpenSpec — filosofía, inicio rápido, comparaciones, licencia MIT
- Flujo OPSX de OpenSpec — acciones fluidas, artefactos, configuración, esquemas
- Flujos de OpenSpec — perfiles principal y ampliado
- Comandos de OpenSpec — comportamiento de
/opsx:*, incluidos apply y archive - npm
@fission-ai/openspec— versión 1.6.0 al momento de escribir el artículo - README de Superpowers — biblioteca de skills, flujo, instalación, versión v6.1.1
- RELEASE-NOTES de Superpowers — comportamiento de subagentes según el harness en v6.x, soporte del plugin para Cursor
- Skill
writing-plansde Superpowers — formato del plan, ruta de guardado predeterminada, transferencia a la ejecución - Skill
executing-plansde Superpowers — lista de plataformas con capacidad para subagentes - Skill
subagent-driven-developmentde Superpowers — modelo de revisión en dos etapas - Publicación de lanzamiento de Superpowers — origen del flujo explorar ideas → planificar → implementar, justificación de las skills (October 9, 2025)
- Herramientas compatibles con OpenSpec — IDs de herramientas y nombres de skills generadas
Lecturas relacionadas en este devlog:
- OpenSpec vs GitHub Spec Kit — compara dos frameworks de artefactos de specs (usa el Spec workflow picker en la barra lateral del artículo)
- OpenSpec avanzado: flujos ampliados —
/opsx:verify, esquemas personalizados, perfiles - Reemplaza Plan Mode con OpenSpec — cuándo las specs estructuradas superan el modo de planificación del IDE