Superpowers: una metodología de desarrollo para agentes de código

Todo lo que hay que saber sobre obra/superpowers: una biblioteca de instrucciones componibles que impone un proceso de diseño, pruebas, revisión y cierre a los agentes de programación.

---

Qué es Superpowers

Superpowers es un marco de habilidades para agentes de código y, a la vez, una metodología de desarrollo. No es un modelo, un entorno de ejecución ni un servidor: el producto principal son instrucciones y utilidades de un plugin que hacen que el agente consulte una habilidad pertinente antes de actuar.

Su propósito es sustituir la improvisación de una sesión por una secuencia repetible: aclarar el problema, acordar el diseño, planificar, implementar con pruebas, revisar y decidir como cerrar la rama. El README describe las habilidades como obligatorias cuando corresponden; no como sugerencias que el agente pueda omitir.

A 31 de julio de 2026, el README documenta instalaciones separadas para Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, Gemini CLI, GitHub Copilot CLI, Kimi Code, OpenCode y Pi. La compatibilidad no implica un único mecanismo: usa los formatos y mecanismos nativos de cada entorno cuando están disponibles.

El origen: aprovechar una apertura de Anthropic

El repositorio fue creado el 9 de octubre de 2025 por Jesse Vincent (obra), cuya cuenta de GitHub identifica a Prime Radiant como empresa. Ese mismo día Vincent publico el anuncio inicial, “Superpowers: How I am using coding agents in October 2025”.

La cronología importa: Vincent cuenta que llevaba semanas convirtiendo y sistematizando su propio proceso para orientar mejor a su agente, pero Anthropic estreno aquella mañana el sistema de plugins de Claude Code. En vez de esperar a completar todo lo previsto, publico Superpowers de inmediato. El primer flujo se instalaba desde el mercado propio con /plugin marketplace add obra/superpowers-marketplace y /plugin install superpowers@superpowers-marketplace.

El detalle que define la propuesta era un gancho de inicio de sesión: al abrir Claude, el plugin inyectaba una instrucción que exigía leer una habilidad de arranque. Así enfrentaba una tensión de los agentes nativos: tener una biblioteca de instrucciones no basta si el modelo no la recuerda ni decide aplicarla. La respuesta fue una instrucción de activación y una política de consulta de habilidades, no un comando manual que el usuario tuviera que recordar.

El anuncio también ofrece una anécdota reveladora sobre el diseño: al principio Claude daba a sus subagentes cuestionarios fáciles y obtenía puntuaciones perfectas. Vincent le pidió escenarios realistas con presión, por ejemplo una incidencia de autenticación que cuesta dinero por minuto o el sesgo de confirmar una infraestructura de pruebas que ya funciona. El proyecto transformo esos fallos en pruebas de comportamiento para las instrucciones. El texto también reconoce una tensión ética y técnica: las habilidades usan encuadres de autoridad, compromiso y escasez para favorecer disciplina, y Vincent lo presenta explícitamente como una manera de mejorar fiabilidad, no de eludir controles.

Filosofía y principios

El README resume cuatro principios verificables:

• Desarrollo guiado por pruebas: escribir antes una prueba que falle, implementar lo mínimo para que pase y refactorizar.
• Proceso sistemático antes que improvisación: investigar y planificar antes de modificar código.
• Reducir complejidad: YAGNI y DRY aparecen como límites prácticos al diseño.
• Evidencia antes que afirmaciones: no declarar una tarea terminada sin verificarla.

Hay una idea adicional en el anuncio: las habilidades son conocimiento operativo reutilizable. Vincent describe que un agente puede leer documentos o una base de código, extraer lecciones y convertirlas en nuevas habilidades; a su vez, esas habilidades se someten a pruebas con subagentes. Es una propuesta de mejora de instrucciones mediante casos de uso, no una garantía de que el agente aprenda por si mismo.

Cómo funciona

El flujo básico documentado tiene siete etapas:

1. brainstorming formula preguntas y presenta el diseño por partes antes de programar.
2. using-git-worktrees crea un espacio aislado y comprueba una base de pruebas limpia.
3. writing-plans produce tareas pequenas con rutas, pasos y comprobaciones concretas.
4. subagent-driven-development o executing-plans ejecuta el plan: el primero delega una tarea por subagente y la revisa; el segundo permite lotes con puntos de control humanos.
5. test-driven-development exige el ciclo rojo → verde → refactorización.
6. requesting-code-review revisa contra el plan y bloquea el avance ante problemas críticos.
7. finishing-a-development-branch vuelve a ejecutar comprobaciones y propone fusionar, abrir una solicitud de cambios, conservar o descartar la rama.

Las habilidades disponibles se agrupan en pruebas, depuración, colaboración y meta-proceso. Entre las de colaboración están dispatching-parallel-agents, using-git-worktrees, writing-plans, requesting-code-review y subagent-driven-development; las meta-habilidades incluyen writing-skills y using-superpowers.

La versión v6.2.0, publicada el 24 de julio de 2026, muestra que no se trata solo de texto estático. Introdujo espacios de trabajo de desarrollo dirigido por subagentes por plan en .superpowers/sdd/<nombre-del-plan>/, eliminados al concluir una revisión limpia; también reanuda al implementador para corregir hallazgos y usa una nueva revisión centrada en las correcciones. La nota de versión declara resultados de pruebas internas de 25 de 25 en dos conjuntos, pero esos resultados son del proyecto y no constituyen una evaluación independiente.

Estado oficial y semioficial

Superpowers tiene aceptación oficial en varios mercados, según su README actual:

• Anthropic: esta disponible en el mercado oficial de plugins de Claude mediante superpowers@claude-plugins-official.
• OpenAI: esta disponible en el mercado oficial de plugins de Codex, tanto en Codex App como en Codex CLI.
• Kimi Code: el README indica que esta en su mercado de plugins.
• Cursor: se instala desde su mercado con /add-plugin superpowers o buscando el nombre.

Esto no significa que Anthropic, OpenAI, Kimi o Cursor certifiquen la metodología ni sus resultados; significa que el paquete es instalable desde sus catálogos oficiales. También existe el mercado mantenido por el proyecto, obra/superpowers-marketplace, para Claude Code y otros plugins relacionados. En la practica, la presencia simultánea en mercados de proveedores y la integración con once entornos hacen que funcione como una referencia de facto para el patrón de habilidades de flujo de trabajo, pero no hay una designación formal de estándar en las fuentes consultadas.

El ecosistema

Repositorios del autor y de Prime Radiant

• obra/superpowers-marketplace: mercado curado de plugins de Claude Code; 1.191 estrellas y 242 bifurcaciones en la búsqueda de GitHub consultada.
• obra/superpowers-skills: habilidades editables por la comunidad para el plugin; 734 estrellas y 164 bifurcaciones.
• obra/superpowers-lab: habilidades experimentales y herramientas para Superpowers; 402 estrellas y 30 bifurcaciones.
• obra/superpowers-chrome: plugin para controlar Chrome mediante el Protocolo de Herramientas de Desarrollo, sin dependencias; 336 estrellas y 51 bifurcaciones.
• obra/amplifier-bundle-superpowers: adaptación del sistema de flujo de trabajo para Amplifier; 70 estrellas y 14 bifurcaciones.
• prime-radiant-inc/superpowers-evals: laboratorio de evaluación conductual. Ejecuta interfaces de línea de comandos de agentes, incluidas Claude, Codex, Gemini y Kimi, y califica el cumplimiento del flujo con criterios de escenarios y comprobaciones deterministas; 91 estrellas y 9 bifurcaciones.

El propio README enlaza superpowers-evals para probar el comportamiento de habilidades mediante el arnés Drill. Se distingue de las pruebas de infraestructura del plugin, que viven en tests/ y se ejecutan con los guiones run-*.sh pertinentes o con npm test.

Puertos, traducciones y extensiones comunitarias

• jnMetaCode/superpowers-zh es una traducción y ampliación comunitaria al chino: anuncia la traducción completa y seis habilidades originales; 7.383 estrellas y 713 bifurcaciones. Es el puerto no inglés mas visible encontrado en la búsqueda, no un repositorio de Prime Radiant.
• anthonylee991/gemini-superpowers-antigravity adapta la idea a Gemini Antigravity; 815 estrellas y 107 bifurcaciones.
• skainguyen1412/antigravity-superpowers porta los flujos de lluvia de ideas, planificación, pruebas, revisión y verificación a Antigravity; 322 estrellas y 35 bifurcaciones.
• K-Dense-AI/science-superpowers se presenta como una reimplementación para agentes de investigación científica, con registro previo en vez de pruebas guiadas por desarrollo; 276 estrellas y 26 bifurcaciones.
• SYZ-Coder/superpowers-openspec-team-skills combina Superpowers y OpenSpec en una biblioteca de habilidades para equipos con memoria y autoaprendizaje; 183 estrellas y 50 bifurcaciones.
• MakFly/superpowers-symfony extiende el patrón a Symfony con habilidades, subagentes y comandos especificos; 183 estrellas y 17 bifurcaciones.

Estas cifras son las que devolvió la búsqueda de repositorios de GitHub durante esta investigación; no son una auditoría de calidad, soporte ni compatibilidad de cada derivado.

El lanzamiento original cita también Microsoft Amplifier como un marco relacionado que usa el patrón de documentación en Markdown y herramientas que el agente puede ampliar. Esa relación aparece como inspiración del autor, no como afiliación ni dependencia técnica de Superpowers.

Números del repo

Medición: 31 de julio de 2026, API de GitHub.

Métrica	Valor
Estrellas	264.367
Bifurcaciones	23.603
Suscriptores	998
Commits	680
Incidencias abiertas indicadas por la API	304
Lenguaje principal	Shell
Licencia	MIT
Creación	9 de octubre de 2025
Última actualización de metadatos	31 de julio de 2026
Última publicación	v6.2.0, 24 de julio de 2026

Los principales contribuidores que devolvió la API, por número de contribuciones, fueron obra (Jesse Vincent), mhenke, robertjakub y larsroettig. El conteo de 680 se obtuvo de la página final del enlace de paginación de la API de commits. La API de GitHub usa open_issues_count; ese campo puede incluir solicitudes de cambios abiertas, por lo que no debe leerse como un conteo exclusivo de incidencias. Asimismo, watchers_count de la respuesta general réplica las estrellas; por eso se informa por separado el campo subscribers_count como suscriptores reales.

Cómo contribuir

El proceso documentado es concreto:

1. Crear una bifurcación del repositorio.
2. Cambiar a la rama dev.
3. Crear una rama para el trabajo.
4. Seguir writing-skills para crear o modificar habilidades y sus pruebas.
5. Abrir una solicitud de cambios y completar la plantilla.

El README advierte que normalmente no aceptan contribuciones de habilidades nuevas y que toda modificación debe funcionar en todos los agentes compatibles. Para las habilidades se usa el arnés Drill de superpowers-evals; para infraestructura, las pruebas están en tests/. Esta limitación multi-entorno explica parte de la exigencia del proceso: una instrucción que funciona en un agente puede no activarse igual en otro.

Cómo lo recibió la comunidad

La evidencia recuperada muestra adopción e influencia, pero también objeciones claras sobre coste y confianza:

• En el hilo de Hacker News 48140677, el usuario anaq42 presentó JDS, una suite para Copilot inspirada por Superpowers. Escribió que le gustó imponer disciplina con un flujo basado en habilidades porque los agentes “se desvían y pierden el hilo”, y atribuyo a Superpowers la capacidad de sostener sesiones largas sin perder foco. El envío alcanzó 9 puntos y 0 comentarios; es una muestra de reconocimiento explícito, no una medición amplia de satisfacción.
• En 46864977, dsifry presentó Metaswarm y nombró a Superpowers, junto con Beads, como una base esencial para flujos disciplinados de pruebas, lluvia de ideas y depuración. El envío tuvo 5 puntos y 2 comentarios. Es evidencia de reutilización en una herramienta posterior, no una validación independiente de sus afirmaciones de rendimiento.
• El usuario sermakarevich, en 48459609, expuso la objeción contraria: no instala habilidades ajenas sin revisarlas y citó una evaluación enlazada que, según su resumen, observaba peor rendimiento con mas consumo de tokens para el enfoque de pruebas de Superpowers. El hilo tenía 1 punto y 0 comentarios al consultarlo. Dado que la evaluación externa enlazada no se recuperó directamente en esta investigación, esa conclusión debe tratarse como una crítica atribuida a ese usuario, no como un resultado confirmado.
• La nota de lanzamiento aporta otra reserva de primera mano: el propio Vincent explica que los encuadres persuasivos de las instrucciones son “fascinantes y ligeramente inquietantes”. La estrategia busca que el agente no se salte un procedimiento bajo presión, pero también incrementa la necesidad de que el usuario inspeccione las instrucciones que instala.

No se encontró un anuncio original de Superpowers con una discusión amplia y verificable en Hacker News durante las consultas realizadas. Por ello no se infieren cientos de comentarios ni un consenso que las fuentes no muestran.

Superpowers frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
josipmusa/jds	Suite de habilidades que impone pensar → planificar → ejecutar a un agente de código.	JDS se declara adaptada a Copilot y añade un grafo visual de tareas; su autor dice que tomo inspiración de Superpowers, no que sea un puerto literal.
andonimichael/arxitect	Plugin de Claude Code inspirado en Superpowers y orientado a mejorar el comportamiento del agente.	Arxitect centra sus habilidades en principios de arquitectura, diseño de API y calidad de código; Superpowers cubre un ciclo de desarrollo mas amplio.
K-Dense-AI/science-superpowers	Reimplementa el enfoque de metodología compuesta por habilidades.	Se dirige a investigación científica y declara registro previo en lugar de la disciplina de pruebas de software de Superpowers.
Microsoft Amplifier	El anuncio de Vincent lo identifica como un marco que usa documentación y herramientas ampliables por el agente.	La fuente no permite afirmar una equivalencia funcional ni una integración técnica; se presenta como referencia conceptual.

La comparación mas útil no es por popularidad: Superpowers destaca cuando se quiere imponer un proceso transversal y portable entre agentes. Una extensión especializada puede ser preferible cuando el dominio, como arquitectura o ciencia, exige reglas que el flujo general no contiene.

Casos de uso y a quién puede ayudar este repositorio

• Equipos que desarrollan con Claude Code, Codex, Cursor u otro de los entornos compatibles pueden adoptar el recorrido brainstorming → writing-plans → implementación → revisión para que una tarea no pase directamente de una petición ambigua a un cambio sin diseño ni comprobación.
• Responsables de una incidencia o de una entrega con varios cambios pueden usar using-git-worktrees, el espacio por plan en .superpowers/sdd/ y la revisión por tarea para aislar el trabajo del agente, conservar el estado del plan y decidir al final si fusionar, abrir una solicitud de cambios, conservar o descartar la rama.
• Personas que mantienen instrucciones internas para agentes pueden partir de writing-skills y del arnés superpowers-evals para convertir un procedimiento repetible en una habilidad y someterla a escenarios de comportamiento. Antes de instalar o extender el flujo conviene inspeccionar las instrucciones y medir el coste en tokens y resultados en el entorno propio.

Recursos

• Repositorio: https://github.com/obra/superpowers
• Documentación e instalación: https://github.com/obra/superpowers#installation
• Anuncio de lanzamiento y contexto: https://blog.fsck.com/2025/10/09/superpowers/
• Habilidades oficiales: https://github.com/obra/superpowers/tree/main/skills
• Mercado de Superpowers: https://github.com/obra/superpowers-marketplace
• Evaluaciones oficiales: https://github.com/prime-radiant-inc/superpowers-evals
• Mercado oficial de Claude: https://claude.com/plugins/superpowers
• Mercado oficial de Codex: https://github.com/openai/plugins
• Comunidad Discord: https://discord.gg/35wsABTejz
• Conversaciones y referencias: https://news.ycombinator.com/item?id=48140677, https://news.ycombinator.com/item?id=46864977, https://news.ycombinator.com/item?id=48459609

---

Nota: este artículo combina el README, las publicaciones de lanzamiento y las notas de versión de Superpowers, la API de GitHub y resultados de Hacker News consultados el 31 de julio de 2026. Las cifras cambian con el tiempo.