obra/superpowers es un framework de skills para coding agents y también una metodología de desarrollo de software. Su objetivo no es crear otro prompt universal, sino hacer que el agente siga un proceso: aclarar objetivos, producir diseño, escribir un plan, implementar con TDD, revisar y cerrar.
Proyecto: https://github.com/obra/superpowers
En el momento de escribir, la API de GitHub muestra más de 190.000 stars, licencia MIT y actividad reciente. El README lo describe como An agentic skills framework & software development methodology that works.
Qué problema resuelve
Muchas herramientas de AI Coding no fallan por no saber escribir código, sino por escribirlo demasiado pronto.
El usuario da una petición vaga, el agente edita archivos y el resultado parece terminado, aunque los límites, tests y arquitectura sigan sin estar claros. En tareas pequeñas puede pasar; en proyectos complejos se convierte en retrabajo y deuda técnica.
Superpowers hace que el agente entre en un workflow antes de tocar código:
- Si detecta que el usuario quiere construir algo, pregunta primero por el objetivo.
- Convierte la conversación en una especificación y la confirma por partes.
- Tras aprobar el diseño, genera un plan de implementación.
- Solo cuando el usuario dice “go” empieza a implementar.
- Durante la implementación enfatiza TDD, YAGNI, DRY y revisión.
No es ingeniería nueva, pero los agentes rápidos necesitan barandillas más fuertes.
Herramientas soportadas
Superpowers no está ligado a un único agente. El README lista Claude Code, Codex CLI, Codex App, Factory Droid, Gemini CLI, OpenCode, Cursor y GitHub Copilot CLI.
Su papel se parece más a una capa de workflow entre harnesses que a un truco para un modelo concreto.
Workflow base
Primero está brainstorming: antes de implementar, el agente convierte ideas vagas en diseño ejecutable y lo confirma.
Después using-git-worktrees: crea un worktree y una rama aislados, y comprueba que instalación y tests parten de una base limpia.
Luego writing-plans: divide el diseño en tareas pequeñas con rutas, alcance de código y pasos de validación.
En ejecución puede usar subagent-driven-development para delegar o executing-plans para avanzar por lotes. Cada tarea debe poder revisarse y verificarse.
Después llega test-driven-development: RED-GREEN-REFACTOR real. Escribir un test que falla, confirmar el fallo, implementar lo mínimo, confirmar el paso y refactorizar.
requesting-code-review introduce revisión entre tareas, y los hallazgos críticos bloquean el avance.
Finalmente finishing-a-development-branch valida tests y ofrece opciones como merge, PR, conservar o descartar el worktree.
Qué hay en la Skills Library
La parte de testing gira alrededor de test-driven-development.
La parte de debugging incluye systematic-debugging y verification-before-completion: reproducir, minimizar, formular hipótesis, validar y no declarar completado sin verificar.
Las skills de colaboración incluyen:
brainstormingwriting-plansexecuting-plansdispatching-parallel-agentsrequesting-code-reviewreceiving-code-reviewusing-git-worktreesfinishing-a-development-branchsubagent-driven-development
También hay skills meta como writing-skills y using-superpowers.
Juntas dan al agente hábitos de ingeniería: cuándo preguntar, planificar, testear y detenerse para review.
Diferencia frente a un prompt normal
Un prompt normal suele apilar reglas en un system prompt: no cambies de más, piensa primero, prueba, explica, sé breve. Cuantas más reglas, más fácil es que el modelo olvide algunas en tareas complejas.
Superpowers divide las reglas en módulos de workflow activables. Cada skill es más corta y enfocada. El agente sabe en qué fase está, el proceso se vuelve revisable y el equipo puede codificar sus propias prácticas.
La lección no es solo usar un modelo más inteligente, sino darle una forma repetible de trabajar.
Para quién sirve
Superpowers encaja mejor con desarrolladores que ya usan coding agents en proyectos reales: tareas de varios archivos, diseño antes de implementación, TDD o validación, ramas o worktrees paralelos, subagents para implementación o review, y equipos que quieren convertir su flujo en skills reutilizables.
Para cambiar una línea de configuración puede ser pesado. Para trabajos de varias fases, sus restricciones aportan valor.
Precauciones
No es piloto automático. Da proceso al agente, pero requisitos, límites y aceptación final siguen siendo humanos.
TDD y review añaden coste inicial. En tareas pequeñas pueden parecer lentos; en tareas complejas reducen retrabajo.
Los subagents en paralelo no siempre ayudan. Funcionan si los límites y el alcance de escritura son claros. Si el requisito es borroso, el paralelismo multiplica la confusión.
También hay que mantener la calidad de las skills. Procesos obsoletos, instrucciones vagas y reglas conflictivas perjudican al agente.
Resumen
Superpowers vale porque aleja al coding agent de “recibir petición y editar código” y lo devuelve al proceso de ingeniería de software.
Lo que falta en AI Coding no suele ser velocidad de generación, sino aclaración, planificación, verificación, review y cierre. Cuanto más fuerte sea el modelo, menos conviene saltarse esos pasos.
Si usas Codex, Claude Code, Cursor o Gemini CLI en proyectos reales, Superpowers merece una lectura. Aunque no lo instales, su forma de dividir skills sirve como referencia para diseñar tu propio workflow de agentes.