using-superpowers y brainstorming: Por Qué No Puedes Saltarte el Diseño y Saltar Directamente a Construir

5 min read

El movimiento de apertura predeterminado de mucha gente con los asistentes de codificación con IA es: "Agrégame una funcionalidad." Suena razonable — pero si el agente inmediatamente empieza a modificar archivos, rápidamente entrarás en un escenario clásico: tres revisiones después, te das cuenta de que el AI Agent te malentendió desde la primera versión. Este artículo cubre dos roles que frecuentemente aparecen juntos: using-superpowers (cómo activar correctamente todo el sistema de hábitos) y brainstorming (pensar antes de empezar). El único objetivo: obtener diseño y alineación primero, luego dejar que el AI Agent empiece a construir.

Qué Gestiona using-superpowers

Piensa en using-superpowers como un entrenador: no está escribiendo código por ti — está recordándole al agente (e incidentalmente recordándote a ti mismo) — cómo usar realmente Superpowers, para que la instalación no haya sido en vano.

En la práctica, frecuentemente está haciendo algunas cosas: averiguar qué skills están disponibles en la conversación actual, cuáles leer primero en qué contexto, y — antes de que comience cualquier trabajo de implementación — qué skill de proceso invocar. En pocas palabras: gestiona "movimientos de apertura y enrutamiento" — evitando que te lances directamente a la implementación y dejes que toda la línea se desvíe del curso.

using-superpowers y el frecuentemente siguiente brainstorming también te traerán de vuelta a "explorar el contexto primero": mira qué archivos y convenciones ya existen en el proyecto, qué restricciones tiene tu equipo o entorno que no pueden cruzarse, qué ha cambiado recientemente — no por hábito en sí mismo, sino porque si tu modelo mental de los requisitos no coincide con la base de código real, tu primer intento de implementación probablemente será descartado por completo. Tomarse un breve momento para escanear la situación casi siempre es más barato que reescribir después.

El Flujo Central del brainstorming

El núcleo de un skill de brainstorming no es "conversación casual para pasar el tiempo" — es una línea de producción práctica que roughly funciona así (en concepto, no hay necesidad de memorizar jerga):

  1. Descubrir la intención: ¿Qué problema estás tratando realmente de resolver, para quién? ¿Cómo se ve el éxito?
  2. Aclarar las restricciones: Tiempo, stack tecnológico, código legacy que no se puede tocar, riesgo de despliegue — declara lo que puedas de antemano.
  3. Listar direcciones viables: Más de un camino, convirtiendo los trade-offs en "opción múltiple" en lugar de "telepatía."
  4. Alinear antes de avanzar: Solo después de haber confirmado (o elegido explícitamente una dirección) avanza el flujo de trabajo a planificación más detallada o implementación.

Por eso no es "el brainstorming solo necesita sentirse animado" — se trata de convertir la incertidumbre en opciones seleccionables y dejar un registro de "qué opción realmente elegimos." Sin este paso, la implementación fácilmente se convierte en un sprint paralelo donde todos hablan sin entenderse.

Por Qué Necesitas Aprobación de Diseño Primero

"Aprobación de diseño" no necesita estar pulida — pero necesita alcanzar una línea base: tú y el agente tienen una respuesta consistente a "qué construir, qué no construir todavía y qué cuenta como terminado."

Si te saltas esto, las consecuencias comunes incluyen: el agente piensa que quieres una refactorización, pero solo quieres un pequeño botón; el agente piensa que puede cambiar un paquete, pero tu equipo tiene una política en contra; el agente piensa que "terminado" significa que la pantalla se renderiza, pero tú necesitas pruebas que pasen y verificaciones de accesibilidad.

Obtener aprobación primero no es burocracia — es trasladar los malentendidos costosos a la etapa barata de recuento de palabras para resolverlos. De verdad, esto es mucho más agradable que el infierno de los diffs a medianoche.

Qué Tareas Deberían Pasar por brainstorming Primero

Una heurística fácil para principiantes: siempre que tengas un pensamiento como "no estoy realmente seguro de cuál es el mejor enfoque," brainstorming primero. Por ejemplo:

  • Nuevas funcionalidades: el flujo de usuario, las fuentes de datos y los casos extremos todavía están en la niebla.
  • Modificar código antiguo: preocupado por romper comportamiento del que otros dependen, o no estás seguro de dónde están los efectos secundarios.
  • Trade-offs arquitectónicos: dos o más enfoques, cada uno con costos.
  • Puedes decir "quiero X" pero no puedes decir "y no Y": el alcance todavía se está expandiendo.

Por el contrario, si ya tienes un ticket claro, archivos claros, criterios de aceptación claros, y el cambio es genuinamente lo suficientemente pequeño como para que el malentendido sea casi imposible — entonces podrías considerar un flujo de trabajo más corto. (Pero durante tu fase de principiante, todavía sugeriría: peca del lado de hacer dos preguntas más.)

Conceptos Erróneos Comunes

  • Tratar el brainstorming como simple chat: Sin opciones, sin trade-offs, sin conclusiones, luego "okay tú solo hazlo" — esto es lo mismo que no hacerlo en absoluto.
  • Ya decidiste una solución, pero finges discutirla: Desperdicia pasos y desperdicia el cómputo del agente; mejor di simplemente "estoy eligiendo A, por favor ayúdame a verificar los riesgos."
  • Saltarse el ritmo de using-superpowers: Entrar directamente al código en el momento en que abres una conversación elimina tus propios guardarraíles de calidad. No siempre explotará, pero cuando explota, normalmente es muy difícil recuperarse.
  • Pensar que aprobación de diseño = nunca puede cambiar: Descubrir nueva información más tarde y ajustar está perfectamente bien. La clave es comunicar los cambios claramente al ajustar, no refactorizar silenciosamente hasta que sea irreconocible.

Próximos Pasos


Volver al Índice de la Serie

Este artículo cubre los roles y el momento oportuno para using-superpowers y brainstorming. Para volver al mapa de lectura de la serie y el orden recomendado, abre el Curso para Principiantes de Superpowers.