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.

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

    Sin tarjeta de credito

    Namiru.ai

    AI chat for your website