Jorge Saavedraiaproductividadherramientasclaude-codebuenas-practicas
Los agentes de IA para programar son increíblemente poderosos, pero también increíblemente caóticos. Les das una tarea y se lanzan directo al código sin pensar. No preguntan, no planean, no consideran alternativas. El resultado es código que técnicamente funciona, pero que es desordenado, sin tests y difícil de mantener. Terminas gastando más tiempo arreglando lo que generó la IA que lo que hubieras tardado escribiéndolo tú mismo.
Hace unas semanas descubrí Superpowers, un proyecto de Jesse Vincent. Es un conjunto de "skills" componibles que le dan estructura a tu agente de IA. En vez de decirle "escríbeme X", el flujo de trabajo se convierte en: lluvia de ideas, diseño, plan, implementación con TDD, revisión. El agente deja de ser un generador de código descontrolado y empieza a comportarse como un ingeniero disciplinado.
Lo he estado usando las últimas semanas con Claude Code y cambió fundamentalmente mi forma de trabajar. Esto es lo que aprendí.
El problema: agentes sin estructura
Sin un framework que los guíe, los agentes de IA tienden a repetir los mismos errores:
- Se saltan la fase de requerimientos y van directo al código
- No escriben tests
- Sobreingenierizan cosas simples
- No siguen los patrones existentes en tu codebase
- Producen código que "funciona" pero que nadie quiere mantener
Esto no es culpa de la IA. Es culpa de cómo la usamos. Si le das cero estructura, te va a devolver cero estructura. Es como darle un proyecto a un desarrollador junior sin ningún proceso: va a escribir código, sí, pero no necesariamente el código que necesitas.
¿Qué es Superpowers?
Superpowers es una colección de "skills" que se conectan a Claude Code (aunque también funciona con Cursor, Gemini CLI y Codex). Cada skill define un proceso estructurado para una fase específica del desarrollo. La instalación es un solo comando:
bash
/plugin install superpowers@claude-plugins-officialLos skills principales cubren: lluvia de ideas (brainstorming), escritura de planes de implementación, TDD, desarrollo con subagentes, revisión de código y manejo de git worktrees. Cada uno es independiente, así que puedes usar solo los que necesites.
Lo que cambió para mí
Voy a ser concreto. Estos son tres ejemplos reales de cómo Superpowers cambió mi flujo de trabajo.
Brainstorming antes de codear
Antes: le decía "Agrega autenticación con JWT" y el agente escribía código inmediatamente. A veces acertaba, pero muchas veces tomaba decisiones que yo no hubiera tomado: guardaba tokens en localStorage, no validaba la expiración, o implementaba un flujo que no encajaba con la arquitectura del proyecto.
Después: el skill de brainstorming hace preguntas una por una, propone dos o tres enfoques con sus ventajas y desventajas, y presenta un diseño para tu aprobación. Tú apruebas, y recién ahí empieza a codear. Esto es lo que se ve en la práctica:
text
> Agrega autenticacion con JWT al servicio de usuarios
Superpowers: Antes de implementar, algunas preguntas:
1. Donde se almacena el token en el cliente?
A) localStorage
B) Cookie httpOnly
C) En memoria (SPA)
> B
2. Quien emite el token?
A) Tu propio backend (signing con secret)
B) Un proveedor externo (Auth0, Cognito, Firebase)
> A
Propongo 2 enfoques:
- Enfoque A: Middleware global que valida JWT en cada request (recomendado)
- Enfoque B: Decorador por endpoint
Aprobado? Entonces procedo al plan de implementacion.La diferencia es enorme. En vez de corregir después, defines bien desde el principio. El agente entiende exactamente qué quieres antes de escribir una sola línea de código.
Planes que se pueden seguir
Antes: el agente hacía 15 cambios en 8 archivos sin un orden claro. Si algo fallaba en el paso 10, era casi imposible saber qué había salido mal porque todo estaba mezclado.
Después: el skill de writing-plans produce un plan paso a paso con los archivos exactos que se van a tocar, el código específico que se va a escribir y los comandos que se van a ejecutar. Cada paso toma entre 2 y 5 minutos. Lo más importante es que puedes revisar el plan completo antes de que se escriba una sola línea de código. Si algo no te convence, lo ajustas en el plan, no en el código ya generado.
Subagentes con revisión automática
Este es el skill que más me sorprendió. El skill de subagent-driven-development lanza un agente nuevo por cada tarea, y cuando termina, ejecuta automáticamente una revisión de cumplimiento de especificaciones y una revisión de calidad de código. Si algo falla, el agente lo corrige antes de pasar a la siguiente tarea. No necesitas estar supervisando cada paso.
En la práctica, esto significa que puedes definir tres o cuatro tareas, lanzarlas, y volver cuando estén listas con la confianza de que pasaron por al menos dos rondas de revisión automática. No es perfecto, pero es mucho mejor que el enfoque de "generar todo y rezar".
Lo que no me convence (todavía)
No todo es perfecto, y quiero ser honesto al respecto. El proceso de brainstorming puede sentirse lento para tareas simples. A veces solo quieres decir "corrige este typo" sin pasar por una revisión de diseño. Para esos casos, simplemente no invocas el skill, pero la tentación de "hacer todo con proceso" puede ser contraproducente.
El enforcement de TDD es estricto, lo cual en teoría es excelente. Pero para un blog estático sin un framework de testing configurado, no siempre aplica. También hay que considerar que cada skill ocupa entre 1 y 2 mil tokens en la ventana de contexto, así que cargar muchos a la vez puede reducir el espacio disponible para tu conversación. Son trade-offs reales que vale la pena tener en cuenta.
¿Para quién es Superpowers?
Ideal para: features complejas, cambios que tocan múltiples archivos, proyectos en equipo, y cualquier persona que haya sido quemada por la IA generando código desordenado.
No es necesario para: correcciones rápidas, typos, cambios simples de un solo archivo. Para eso, un agente sin estructura funciona bien.
No necesitas usar todo en cada tarea
No necesitas usar todos los skills en cada tarea. Puedes invocar solo el brainstorming para una feature compleja y saltarte el TDD para un cambio cosmético. La clave es tener la estructura disponible cuando la necesitas.
Superpowers no reemplaza tu criterio técnico
Algo importante que quiero dejar claro: Superpowers estructura el proceso, pero no toma las decisiones por ti. Cuando el brainstorming te presenta tres enfoques con trade-offs, necesitas el conocimiento técnico para elegir el correcto. Cuando el plan propone una arquitectura, necesitas saber si tiene sentido para tu proyecto. Cuando la review encuentra un issue, necesitas evaluar si es real o un falso positivo.
Sin esa base técnica, Superpowers es solo un proceso bonito que produce código que no entiendes. Y código que no entiendes es código que no puedes mantener. La IA es una herramienta, no un reemplazo. Te hace más rápido, pero solo si ya sabes hacia dónde vas.
La IA amplifica, no reemplaza
Un junior usando Superpowers va a producir código estructurado pero potencialmente incorrecto en las decisiones de diseño. Un senior usando Superpowers va a producir código estructurado Y correcto, porque sabe guiar al agente en cada punto de decisión. La diferencia está en quién está al volante.
Si quieres profundizar en cómo sacarle el máximo provecho a las herramientas de IA para programar (no solo Superpowers sino Claude Code, Cursor y cualquier otra), escribí un post dedicado a eso: Codeando con IA: agentes, skills y buenas prácticas.
Para terminar
Superpowers no hizo que la IA escriba mejor código. Hizo que la IA piense antes de escribir código. Pero eso solo funciona si tú también piensas. La combinación de un buen framework de proceso con criterio técnico sólido es lo que realmente marca la diferencia.
Si te interesa probarlo, el repositorio está en github.com/obra/superpowers. Dale una oportunidad. Tu yo del futuro te lo va a agradecer.
