Plugin Superpowers para Claude Code: El Tutorial Completo

8 min de lectura
Ing. Patrik Kelemen
Plugin Superpowers para Claude Code: El Tutorial Completo

Transforma Claude Code de un asistente útil a un compañero de desarrollo autónomo con flujos de trabajo estructurados, aplicación de TDD y desarrollo impulsado por subagentes.

Namiru AI

Soporte al cliente con IA para tu sitio web

Pega tu URL. Obtiene un agente de soporte en 30 segundos.

Claude Code es poderoso desde el principio, pero sin estructura, salta directamente a programar: sin planificación, sin pruebas, sin enfoque sistemático. El plugin Superpowers soluciona este problema al aplicar flujos de trabajo de desarrollo probados que previenen el caos.

Qué hace realmente Superpowers

Superpowers es un framework de habilidades que intercepta a Claude Code en momentos clave. En lugar de escribir código inmediatamente cuando le pides algo, se detiene y hace preguntas primero. Luego aplica TDD, crea planes de implementación y revisa su propio trabajo antes de continuar.

El flujo de trabajo principal:

  1. Brainstorm: refina tu idea mediante preguntas socráticas
  2. Plan: crea tareas pequeñas (2-5 minutos cada una) con rutas de archivo exactas
  3. Execute: despacha subagentes por tarea con revisión en dos etapas
  4. Finish: verifica las pruebas, ofrece opciones de PR/merge, limpia

Instalación (10 Segundos)

bash

Abre el menú de plugins

/plugin

Navega a la pestaña "Discover"

Busca "superpowers"

Selecciona e instala

Después de la instalación, reinicia Claude Code. Verás "SessionStart:startup hook succeeded: Success" confirmando que el plugin está activo.

image

Qué se instala

El plugin incluye todo lo que necesitas:

ComponenteIncluido
Commandsexecute-plan, write-plan, brainstorm
Agentscode-reviewer
Skills14 habilidades incluyendo TDD, debugging, git worktrees, revisión de código
HooksSessionStart (auto-inicia el flujo de trabajo)

Los tres comandos principales

/superpowers:brainstorm

Úsalo antes de CUALQUIER nueva funcionalidad. Claude:

  • hará preguntas aclaratorias sobre tu objetivo
  • explorará alternativas que no has considerado
  • presentará el diseño en fragmentos digeribles para validación
  • guardará un documento de diseño como referencia

Cuándo activarlo: Inicio de cualquier funcionalidad, refactorización o migración.

/superpowers:write-plan

Después del brainstorming, esto crea un plan de implementación donde:

  • cada tarea toma 2-5 minutos como máximo
  • cada tarea tiene rutas de archivo exactas y fragmentos de código completos
  • los pasos de verificación están integrados en cada tarea
  • el plan asume que un "ingeniero junior entusiasta sin contexto" lo ejecutará

/superpowers:execute-plan

Ejecuta el plan usando desarrollo impulsado por subagentes:

  • subagente nuevo generado por tarea (contexto limpio)
  • revisión en dos etapas: cumplimiento de especificaciones, luego calidad de código
  • puntos de control humanos entre lotes
  • problemas críticos bloquean el progreso automáticamente

Las 14 habilidades explicadas

HabilidadQué hace
test-driven-developmentAplica RED-GREEN-REFACTOR. Elimina código escrito antes de las pruebas.
systematic-debuggingProceso de causa raíz en 4 fases con defensa en profundidad
using-git-worktreesCrea rama aislada, ejecuta configuración, verifica línea base limpia
using-superpowersIntroducción al sistema de habilidades
dispatching-parallel-agentsFlujos de trabajo de subagentes concurrentes
executing-plansEjecución por lotes con puntos de control
finishing-a-development-branchOpciones de merge/PR/mantener/descartar, limpieza
brainstormingRefinamiento de diseño socrático
writing-plansPlanificación detallada de implementación
requesting-code-reviewLista de verificación previa a revisión, bloquea en problemas críticos
receiving-code-reviewResponder a comentarios sistemáticamente
writing-skillsMeta-habilidad para crear nuevas habilidades
verification-before-completionAsegura que las correcciones realmente funcionen
subagent-driven-developmentRevisión en dos etapas por tarea

image

Cómo se activan las habilidades automáticamente

Las habilidades no son comandos que llamas, se activan según el contexto:

  • comienzas a discutir una nueva funcionalidad → brainstorming se activa
  • diseño aprobado → using-git-worktrees se activa
  • comienza la implementación → test-driven-development se activa
  • tarea completada → requesting-code-review se activa
  • todas las tareas terminadas → finishing-a-development-branch se activa

Claude verifica habilidades relevantes antes de cualquier tarea. Estos son flujos de trabajo obligatorios, no sugerencias.

Integración con git worktree

Superpowers usa git worktrees para desarrollo aislado: bash

Lo que sucede detrás de escena:

git worktree add ../project-feature feature-branch cd ../project-feature

Claude trabaja aquí, la rama main permanece limpia

Beneficios:

  • ejecutar múltiples instancias de Claude en diferentes funcionalidades
  • mantener la rama main estable durante experimentación
  • limpieza fácil si algo sale mal

Desarrollo impulsado por subagentes

El patrón más poderoso. En lugar de una sesión larga de Claude:

  1. El agente principal crea el plan
  2. Un subagente nuevo ejecuta cada tarea
  3. El agente de revisión (code-reviewer) verifica el trabajo
  4. El agente principal continúa o solicita correcciones

Por qué funciona: cada subagente comienza con contexto limpio enfocado en UNA tarea. Sin confusión acumulada de sesiones largas.

Aplicación de TDD

Superpowers se toma el TDD en serio. La habilidad:

  • requiere prueba fallida ANTES de la implementación
  • observa la prueba fallar (demuestra que prueba algo)
  • implementa código mínimo para pasar
  • hace commit en verde
  • refactoriza solo después de verde

Si Claude escribe código antes de las pruebas, la habilidad le indica eliminar ese código y comenzar de nuevo.

Ejemplo práctico

Tú: Necesito autenticación de usuarios para mi app Express

Claude (con Superpowers): → Activa habilidad de brainstorming → Pregunta: ¿OAuth o contraseñas? ¿Sesión o JWT? ¿Qué proveedores? → Explora: ¿Limitación de tasa? ¿Bloqueo de cuenta? ¿Requisitos de contraseña? → Presenta diseño en secciones para tu aprobación

Tú: Se ve bien, planifiquémoslo

Claude: → Activa habilidad de writing-plans → Crea 12 tareas, cada una de 2-5 minutos → Tarea 1: Crear prueba fallida para endpoint /signup → Tarea 2: Implementar manejador de signup para pasar prueba → Cada tarea tiene rutas de archivo exactas y código

Tú: Ejecuta

Claude: → Genera subagente para Tarea 1 → Agente code-reviewer valida salida → Genera subagente para Tarea 2 → Reporta progreso, pide aprobación para continuar

Gestión del plugin

Desde el menú /plugin puedes:

  • Disable plugin: desactivar temporalmente
  • Mark for update: marcar para próximo ciclo de actualización
  • Update now: obtener última versión inmediatamente
  • Uninstall: eliminar completamente
  • View on GitHub: ver código fuente

Cuándo NO usar Superpowers

  • preguntas rápidas puntuales
  • ediciones simples de archivos
  • tareas menores de 5 minutos

Para estos casos, la sobrecarga no vale la pena. Superpowers brilla en funcionalidades multi-archivo, refactorizaciones y migraciones que requieren ejecución sistemática.

Referencia Rápida

AcciónCómo
Instalar/plugin → Discover → superpowers
Iniciar diseño/superpowers:brainstorm
Crear plan/superpowers:write-plan
Ejecutar plan/superpowers:execute-plan
Actualizar/plugin → seleccionar superpowers → Update now

Superpowers transforma Claude Code de "asistente útil que a veces se descarrila" a "compañero de desarrollo sistemático que sigue procesos probados". El flujo de trabajo estructurado previene los modos de fallo más comunes: pruebas omitidas, casos extremos faltantes y funcionalidades que se desvían de los requisitos.

Creado por Namiru.ai - chat IA plug-and-play para tu sitio web.

Patrik Kelemen
Author
Ing. Patrik Kelemen
Founder of Namiru.aiSlovakia, EU

Senior software engineer with 10+ years of experience, specializing in AI chat widgets and automation. Building Namiru.ai to help businesses leverage AI without complexity.

AI AgentsAngularReactNodeJSAWSAzure
Te gusto este articulo?

Descubre lo que la IA puede hacer por tu sitio web

Pega tu URL y observa como tu agente de IA cobra vida en segundos.

Namiru AI

Soporte al cliente con IA para tu sitio web

Pega tu URL. Obtiene un agente de soporte en 30 segundos.

Tus clientes obtienen respuestas al instante. Tu obtienes leads, analisis y recuperas tu tiempo.

Sin tarjeta de credito