Superpowers: Metodología Ágil con Agentes de Código
El framework de 250K estrellas que transforma Claude Code, Codex y Cursor en ingenieros metódicos
Superpowers es un marco completo de metodología de desarrollo para agentes de código. En lugar de lanzarse a escribir código sin dirección, tu agente aprende a hacer brainstorming, diseñar, planificar en tareas, ejecutar con sub-agentes autónomos y mantener calidad con TDD. Creado por obra y usado en Claude Code, Codex CLI, Cursor, OpenCode y más. Este curso te enseña a instalarlo, entenderlo y sacarle el máximo partido.
Contenido
- ¿Qué es Superpowers? Filosofía y Workflow
- Instalación en Claude Code
- Instalación en Codex CLI, Cursor, OpenCode y más
- Brainstorming: De la Idea al Diseño
- Git Worktrees: Aislamiento sin Drama
- Writing Plans: Descomposición en Tareas
- Subagent-Driven Development: Ejecución Autónoma
- TDD, YAGNI y DRY en la Práctica
- El Ecosistema de Skills Componibles
- Workflow Completo y Producción
1. ¿Qué es Superpowers? Filosofía y Workflow
Superpowers (por obra) es una metodología completa de desarrollo software diseñada para agentes de código como Claude Code, Codex CLI, Cursor u OpenCode. Con más de 250.000 estrellas en GitHub, es el proyecto de metodología agentic más popular del mundo.
La idea central es simple: cuando le pides a tu agente que construya algo, este no se lanza a escribir código. En su lugar, sigue un proceso estructurado:
- Brainstorming — Refina las ideas con preguntas, explora alternativas y genera un documento de diseño.
- Git Worktrees — Crea un workspace aislado en una rama nueva con un baseline de tests limpio.
- Writing Plans — Descompone el diseño en tareas de 2-5 minutos con rutas de archivo y pasos de verificación.
- Subagent-Driven Development — Lanza sub-agentes para ejecutar cada tarea, revisa su trabajo y repite.
No es un plugin cualquiera. Superpowers no añade una habilidad suelta; cambia la forma en que tu agente aborda todo el ciclo de desarrollo. Es como pasar de un becario que escribe código sin preguntar a un ingeniero senior con metodología.
| Sin Superpowers | Con Superpowers |
|---|---|
| Escribe código directamente sin plan | Hace brainstorming primero, diseña y acuerda la dirección |
| Modifica archivos en el working tree actual | Crea un git worktree aislado por feature |
| Prompt único, resultado aleatorio | Plan descompuesto en tareas verificables |
| Sin disciplina de testing | Red/Green TDD estricto |
| Tú supervisas cada paso | Sub-agentes trabajan autónomamente |
2. Instalación en Claude Code
Claude Code es el harness principal de Superpowers. La instalación se hace desde el marketplace oficial de plugins de Anthropic o desde el marketplace comunitario de Superpowers.
Opción A: Marketplace Oficial (recomendada)
Abre Claude Code en tu terminal
claudeInstala el plugin desde el marketplace oficial
/plugin install superpowers@claude-plugins-officialOpción B: Marketplace de Superpowers
Registra el marketplace comunitario
/plugin marketplace add obra/superpowers-marketplaceInstala el plugin
/plugin install superpowers@superpowers-marketplaceVerificación
Una vez instalado, al iniciar una nueva sesión de Claude Code verás mensajes como "Loading Superpowers..." y tu agente empezará a preguntarte qué quieres construir antes de escribir código.
Si usas más de un harness (ej. Claude Code + Codex CLI), instala Superpowers por separado en cada uno. El plugin no se sincroniza entre herramientas.
3. Instalación en Codex CLI, Cursor, OpenCode y más
Superpowers es multi-harness: funciona en todos los coding agents principales. Aquí tienes las instrucciones rápidas para cada uno.
| Harness | Comando de instalación |
|---|---|
| Codex CLI | /plugins → buscar "superpowers" → Install Plugin |
| Codex App | Sidebar → Plugins → "+" junto a Superpowers |
| Cursor | /add-plugin superpowers |
| OpenCode | Decirle: "Fetch and follow instructions from raw.githubusercontent.com/obra/superpowers/main/.opencode/INSTALL.md" |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers luego droid plugin install superpowers@superpowers |
| GitHub Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace luego copilot plugin install superpowers@superpowers-marketplace |
| Kimi Code | /plugins → Marketplace → Superpowers → Install |
| Pi | pi install git:github.com/obra/superpowers |
No asumas que porque instalaste Superpowers en Claude Code, ya funciona en Cursor. Cada harness tiene su propio sistema de plugins y la instalación es independiente.
4. Brainstorming: De la Idea al Diseño
El primer skill que se activa en Superpowers es brainstorming. Cuando le pides a tu agente que construya algo, en lugar de escribir código, el agente:
- Pregunta — Te pide que expliques qué necesitas realmente, no solo cómo lo imaginas.
- Explora alternativas — Sugiere enfoques distintos al que planteaste inicialmente.
- Presenta el diseño en secciones — Muestra el plan en fragmentos cortos, fáciles de leer y validar.
- Guarda el diseño — Escribe el documento de diseño aprobado como referencia.
Ejemplo práctico
Si le pides a tu agente: "Crea un script que monitorice el precio de Bitcoin y me avise si baja de 60K", Superpowers activará brainstorming y te preguntará:
Vamos a diseñar esto juntos.
Antes de escribir código, unas preguntas:
1. ¿Prefieres polling cada N minutos o WebSocket en tiempo real?
2. ¿Qué fuente de datos usar? CoinGecko API, Binance, otras?
3. ¿Cómo quieres recibir la alerta? Terminal, email, Telegram?
4. ¿Necesitas histórico o solo el precio actual?
Propongo empezar con polling cada 5 min vía CoinGecko
(API gratuita, sin auth) y alerta por terminal.
¿Te parece bien?La calidad del resultado final depende directamente de lo bien que hagas esta fase. Cuanto más refines el diseño en brainstorming, menos sorpresas en la implementación.
5. Git Worktrees: Aislamiento sin Drama
Una vez aprobado el diseño, Superpowers activa el skill using-git-worktrees. En lugar de trabajar en tu rama actual (lo que podría ensuciarla), el agente:
- Crea un git worktree en un directorio temporal
- Hace checkout de una nueva rama para la feature
- Ejecuta la configuración del proyecto
- Verifica que los tests existentes pasan (baseline limpio)
¿Qué es un git worktree?
Un git worktree te permite tener múltiples ramas checkout simultáneamente en directorios diferentes. Es como clonar el repo, pero sin duplicar el historial de git:
# Ejemplo de lo que ocurre internamente
git worktree add /tmp/superpowers-feature-xyz feature/xyz
cd /tmp/superpowers-feature-xyz
npm install # o pip install, etc.
npm test # verificar baselineSi tu proyecto tiene hooks de git o depende de variables de entorno locales, el worktree puede no heredarlas automáticamente. Revisa que la configuración se copie al worktree.
6. Writing Plans: Descomposición en Tareas
Con el diseño aprobado y el workspace aislado listo, Superpowers activa el skill writing-plans. Este es el corazón de la metodología: convertir el diseño en tareas pequeñas, concretas y verificables.
Características de cada tarea
- 2-5 minutos de duración — Lo suficientemente pequeña para ejecutarse sin desviarse
- Rutas de archivo exactas — Sabe qué archivos crear o modificar
- Código completo — No deja placeholders ni "TODO"
- Pasos de verificación — Cómo validar que la tarea está correcta
Ejemplo de plan
## Tarea 1: Configurar estructura de archivos
- Crear src/bitcoin_monitor.py
- Crear tests/test_monitor.py
- Crear requirements.txt con requests
## Tarea 2: Implementar cliente CoinGecko
- src/bitcoin_monitor.py:
- Función get_btc_price() que llama a
GET https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd
- Manejar errores HTTP y rate limiting
- Verificar: python3 -c "from src.bitcoin_monitor import get_btc_price; print(get_btc_price())"
## Tarea 3: Sistema de alertas
- ...Si ves que una tarea sería mejor dividirla en dos, puedes pedírselo al agente antes de lanzar la ejecución. El plan se refina contigo antes de ejecutarse.
7. Subagent-Driven Development: Ejecución Autónoma
Una vez que firmas el plan ("go"), Superpowers lanza su skill más potente: subagent-driven-development. El agente principal actúa como supervisor y lanza sub-agentes para ejecutar cada tarea del plan.
El ciclo de ejecución
Despachar tarea
El agente principal crea un sub-agente con la tarea específica, las rutas de archivo y los criterios de éxito.
Ejecutar
El sub-agente escribe el código siguiendo TDD: primero el test, luego la implementación, luego verifica que pase.
Inspeccionar
El agente supervisor revisa el diff, verifica que los tests pasen y que la calidad sea aceptable.
Iterar
Si algo falla, el sub-agente lo corrige. Si todo está bien, se pasa a la siguiente tarea.
El resultado: tu agente puede trabajar autónomamente durante horas sin desviarse del plan que acordaste, y sin que tengas que supervisar cada línea de código.
Es común que el agente trabaje 1-2 horas seguidas sin intervención. Puedes irte a hacer otro cosa y volver a revisar el progreso. Cada tarea completada tiene su diff y verificación.
8. TDD, YAGNI y DRY en la Práctica
Superpowers impone disciplina de ingeniería a través de tres principios fundamentales:
TDD (Test-Driven Development)
El agente escribe el test primero (Red), luego la implementación mínima para que pase (Green), y finalmente refactoriza si es necesario. Esto garantiza que cada pieza de código esté cubierta por tests desde el momento cero.
# Sub-agente ejecutando TDD[TDD] RED: Escribiendo test_btc_price_returns_float... [TDD] GREEN: Implementando get_btc_price()... [TDD] Todos los tests pasan. Commit: t1-coin-gecko-client
YAGNI (You Aren't Gonna Need It)
El agente no añade funcionalidades que no estén en el plan. Si se le ocurre una idea adicional, la anota como posible mejora pero no la implementa hasta que tú la apruebes.
DRY (Don't Repeat Yourself)
El agente identifica patrones repetidos y los extrae en funciones o clases reutilizables, siguiendo el principio de responsabilidad única.
| Principio | Cómo lo aplica Superpowers | Beneficio |
|---|---|---|
| TDD | Test → Código → Refactor en cada tarea | Cobertura completa desde el inicio |
| YAGNI | Solo lo especificado en el plan | Sin código muerto ni features sin usar |
| DRY | Extrae duplicación en funciones compartidas | Código mantenible y consistente |
Si tu proyecto usa un framework de tests distinto al que el agente asume (por ejemplo, pytest vs unittest), especifícalo en el prompt inicial para que el plan incluya la configuración correcta.
9. El Ecosistema de Skills Componibles
Superpowers no es un monolito: es un conjunto de skills componibles que se activan según el contexto. Cada skill es un archivo markdown con instrucciones específicas que el agente lee y sigue.
Skills principales del repositorio
| Skill | Cuándo se activa | Qué hace |
|---|---|---|
| brainstorming | Antes de escribir código | Refina ideas, explora alternativas, genera diseño |
| using-git-worktrees | Tras aprobar diseño | Crea workspace aislado con nuevo branch |
| writing-plans | Con diseño aprobado | Descompone en tareas con rutas y verificación |
| subagent-driven-development | Tras firmar plan | Lanza sub-agentes, inspecciona y repite |
| red-green-refactor | En cada tarea | Impone TDD estricto |
Estructura de un skill
# Ejemplo simplificado de un skill de Superpowers
# .agents/skills/my-skill.md
---
name: my-skill
description: Mi skill personalizada
---
## Instrucciones
Cuando el usuario pida [X], haz [Y]:
1. Paso uno: ...
2. Paso dos: ...
## Ejemplos
### Ejemplo 1: ...
Puedes crear tus propios skills y el agente los leerá automáticamente si los colocas en el directorio correcto. Superpowers es un framework extensible, no un producto cerrado.
10. Workflow Completo y Producción
Para cerrar, veamos el workflow completo de principio a fin con un ejemplo real, y luego consejos para usar Superpowers en producción.
Workflow completo
Prompt inicial
"Construye un monitor de precios de cripto con alertas por Telegram"
Brainstorming
El agente pregunta sobre fuente de datos, frecuencia, formato de alerta. Genera diseño. Tú apruebas.
Worktree + Plan
Crea rama aislada, configura proyecto, escribe plan con 8-12 tareas pequeñas. Revisas y dices "go".
Ejecución autónoma
Sub-agentes ejecutan tareas una a una con TDD. Tú vuelves en 30 min y todo funciona.
Review y merge
Revisas el diff completo, ejecutas tests finales, mergeas a main. Todo documentado.
Consejos para producción
- Sé específico en el prompt inicial — Cuanto más contexto des (stack, estructura de archivos, preferencias), mejor será el plan.
- Revisa el plan antes de decir "go" — Es tu última oportunidad de corregir la dirección antes de la ejecución autónoma.
- Usa GitHub Issues o tickets — Superpowers puede leer issues como entrada y generar el plan basado en la descripción del ticket.
- Combina con CI/CD — El worktree aislado facilita integrar con GitHub Actions o GitLab CI.
- Experimenta con skills propios — Añade skills específicos de tu equipo o proyecto para extender la metodología.
Superpowers está en constante evolución (versión 6.1.1 a fecha de este curso). Sigue el repo en GitHub para enterarte de nuevas skills y mejoras: github.com/obra/superpowers
Preguntas Frecuentes
¿Superpowers funciona con cualquier agente de código?
Sí. Actualmente soporta Claude Code, Codex CLI, Codex App, Cursor, OpenCode, Factory Droid, GitHub Copilot CLI, Kimi Code, Pi y Antigravity. Cada uno tiene su propio método de instalación (ver lecciones 2-3).
¿Necesito saber programar para usar Superpowers?
Necesitas conocimientos básicos de línea de comandos y git. Superpowers está diseñado para desarrolladores que quieren que sus agentes de código trabajen de forma más metódica y autónoma.
¿Superpowers ralentiza al agente?
Los primeros segundos de cada sesión se usan para cargar los skills y hacer brainstorming. Pero una vez en marcha, la ejecución es más rápida y precisa porque el agente no pierde tiempo yendo en direcciones equivocadas.
¿Es gratis?
Sí, Superpowers es código abierto (MIT). Puedes usarlo, modificarlo y distribuirlo libremente. También hay opciones de soporte comercial para empresas.