executing-plans

Descripción general

Qué hace la skill executing-plans

La skill executing-plans está pensada para situaciones en las que ya tienes un plan de implementación escrito y quieres que un agente lo lleve a cabo de forma metódica. Se centra en:

• Cargar desde tu proyecto un plan concreto, paso a paso
• Revisar el plan de forma crítica antes de empezar cualquier trabajo
• Ejecutar las tareas una por una con cambios de estado claros
• Ejecutar verificaciones y pruebas según lo especificado en el plan
• Derivar a un flujo de finalización cuando el desarrollo se haya completado

Al inicio de una sesión, se espera que el agente anuncie:

"I'm using the executing-plans skill to implement this plan."

Esto deja claro que el agente está en modo de ejecución estructurada, no en modo de lluvia de ideas o planificación libre.

A quién va dirigida esta skill

Esta skill encaja bien para:

• Personas desarrolladoras que prefieren diseñar por adelantado y luego dejar que un agente ejecute un plan detallado
• Equipos que usan GitHub y trabajan con un plan de implementación escrito por funcionalidad o rama
• Operadores de agentes que trabajan en entornos como Claude Code o Codex y quieren flujos de ejecución predecibles y repetibles
• Mantenedores de proyectos que buscan una adhesión constante a un plan con puntos de control explícitos y pasos de verificación

Es especialmente útil cuando tu plan ya está desglosado en pasos pequeños e incluye requisitos claros de verificación o pruebas.

Qué problemas resuelve executing-plans

La skill executing-plans te ayuda a:

• Evitar implementaciones improvisadas y cambiantes al anclar el trabajo a un plan previamente aprobado
• Detectar problemas pronto al exigir una revisión crítica del plan antes de cualquier cambio de código
• Seguir el progreso tarea por tarea, marcando el trabajo como in_progress y luego completed
• Asegurar que se ejecuten las verificaciones y pruebas especificadas en el plan
• Derivar de forma ordenada a una skill de finalización para la verificación final de pruebas y la toma de decisiones

Al estandarizar la ejecución de planes, reduce malentendidos y ayuda a que humanos y agentes colaboren de forma más predecible en el trabajo de desarrollo.

Cuándo esta skill es, y no es, la adecuada

Usa executing-plans cuando:

• Ya tienes un plan de implementación escrito
• El plan está secuenciado en tareas o pasos
• Quieres que el agente se centre principalmente en la ejecución, no en diseñar la solución
• Quieres puntos de control en los que el agente pida ayuda si algo no está claro o se bloquea

Valora otra skill o flujo de trabajo cuando:

• Necesitas ayuda para crear un plan desde cero (esta skill asume que el plan ya existe)
• El plan es extremadamente vago o carece de detalles críticos
• Tu plataforma tiene soporte avanzado de subagentes (por ejemplo, Claude Code, Codex) y quieres una orquestación más compleja; en ese caso, el repositorio recomienda usar superpowers:subagent-driven-development en su lugar
• Aún no estás listo para comprometerte con una estrategia concreta de implementación y quieres seguir explorando opciones

El repositorio también especifica que, una vez ejecutadas todas las tareas, debes pasar a la sub-skill requerida superpowers:finishing-a-development-branch para cerrar el trabajo.

Cómo usarla

Instalación y configuración

1. Instalar la skill executing-plans

Instala la skill desde el repositorio obra/superpowers:

npx skills add https://github.com/obra/superpowers --skill executing-plans

Esto pone el flujo de trabajo executing-plans a disposición de tu agente.

2. Preparar tu plan de implementación

Antes de invocar la skill, asegúrate de tener un plan de implementación escrito en tu proyecto. Idealmente, el plan debería:

• Estar guardado en un archivo que tu agente pueda leer (por ejemplo, dentro de tu repo)
• Estar desglosado en tareas individuales o pasos pequeños
• Incluir las instrucciones de verificación o pruebas necesarias para cada tarea

Cuanto mayor sea la calidad y claridad de este plan, más fiable será el flujo de trabajo de executing-plans.

Flujo principal: del plan a la ejecución

Paso 1: Cargar y revisar el plan

Cuando inicies una sesión usando executing-plans, el agente debería:

1. Leer el archivo del plan desde tu proyecto
2. Revisar el plan críticamente, buscando:
   • Información faltante o instrucciones ambiguas
   • Conflictos o contradicciones entre pasos
   • Suposiciones poco realistas o requisitos previos que pueden no cumplirse
3. Si el agente encuentra problemas, debería plantearlos contigo antes de empezar cualquier ejecución
4. Si no hay problemas, el agente debería crear su estructura interna de tareas pendientes (por ejemplo, TodoWrite) y prepararse para ejecutar

Este paso de revisión es crucial. Evita que el agente siga a ciegas un plan defectuoso y fomenta la aclaración temprana.

Paso 2: Ejecutar tareas con seguimiento de estado

Para cada tarea del plan, la skill executing-plans espera el siguiente patrón:

1. Marcar la tarea como in_progress para que puedas seguir el trabajo en curso
2. Seguir cada paso exactamente como está escrito en el plan
   • Se asume que el plan tiene pasos pequeños y concretos
   • El agente debería evitar improvisar salvo que el plan sea claramente insuficiente
3. Ejecutar las verificaciones especificadas
   • Esto puede incluir ejecución de pruebas, linters o comprobaciones manuales descritas en el plan
4. Marcar la tarea como completed cuando se hayan completado todo el trabajo y las verificaciones de esa tarea

Esta estructura facilita que los humanos supervisen el progreso y ayuda al agente a no saltarse validaciones.

Paso 3: Completar el desarrollo mediante la skill de finalización

Una vez que todas las tareas del plan se han ejecutado y verificado:

• El agente debería anunciar:

  "I'm using the finishing-a-development-branch skill to complete this work."

• Después, usar la sub-skill obligatoria: superpowers:finishing-a-development-branch

• Seguir esa skill de finalización para:

  • Re-ejecutar o verificar pruebas según sea necesario
  • Presentar opciones o resultados finales (como el estado de la rama o los siguientes pasos)
  • Ejecutar las acciones de finalización elegidas

Executing-plans debe entenderse como la parte central de tu pipeline de desarrollo: te lleva de un plan escrito a cambios implementados, y luego deriva a un flujo de finalización dedicado.

Cómo gestionar bloqueos e incertidumbre

Cuándo parar y pedir ayuda

Según la definición de la skill, el agente debe detener la ejecución de inmediato y pedir ayuda si:

• Se encuentra con un bloqueo, como por ejemplo:
  • Dependencias o herramientas que faltan
  • Pruebas que fallan de forma inesperada
  • Instrucciones que no se pueden llevar a cabo con el contexto disponible
• El plan tiene lagunas críticas que impiden iniciar o continuar el trabajo
• El agente no entiende bien una parte del plan como para continuar con confianza

En estos casos, la sesión debería pasar de la ejecución a la aclaración, con el agente explicando qué está bloqueando el progreso y qué necesita de ti.

Buenas prácticas al usar executing-plans

Para sacarle el máximo partido a la skill executing-plans:

• Escribe planes específicos y secuenciados, con un resultado claro por tarea
• Incluye instrucciones de verificación para cada cambio importante
• Anima al agente a resumir las dudas o problemas que detecta durante la revisión inicial en lugar de adivinar en silencio
• Usa la skill finishing-a-development-branch de forma constante después de la ejecución para que tu flujo general siga siendo predecible

FAQ

¿Qué es la skill executing-plans en términos sencillos?

La skill executing-plans es un flujo de trabajo estructurado para que los agentes carguen, revisen y ejecuten un plan de implementación preescrito. Recorre las tareas paso a paso, ejecuta las verificaciones indicadas y luego cede el control a una skill de finalización cuando el desarrollo termina.

¿Cómo instalo la skill executing-plans?

Puedes instalarla desde el repositorio obra/superpowers con:

npx skills add https://github.com/obra/superpowers --skill executing-plans

Tras la instalación, configura tu agente o entorno para que pueda leer el archivo de tu plan de implementación e invocar executing-plans en las sesiones relevantes.

¿Necesito subagentes para usar executing-plans?

No. La skill executing-plans está diseñada para funcionar incluso sin soporte de subagentes. Sin embargo, el repositorio indica que Superpowers funciona mejor con subagentes, y si tu plataforma los admite (por ejemplo, Claude Code o Codex), deberías considerar usar superpowers:subagent-driven-development para una orquestación más rica en lugar de executing-plans.

¿Cuándo debería preferir executing-plans frente a subagent-driven development?

Usa executing-plans cuando:

• Tu entorno tiene soporte limitado o nulo para subagentes
• Quieres una ejecución directa y lineal de un plan existente
• Valoras un flujo sencillo de revisar → ejecutar → finalizar sin orquestación compleja de agentes

Si necesitas colaboración entre varios agentes, descomposición dinámica de tareas o una toma de decisiones más autónoma, la alternativa recomendada es superpowers:subagent-driven-development.

¿Qué tipo de plan funciona mejor con executing-plans?

Executing-plans funciona mejor con planes que estén:

• Escritos en un archivo al que tu agente pueda acceder
• Desglosados en tareas pequeñas y ordenadas
• Claros en cuanto a expectativas, entradas y salidas
• Explícitos sobre los pasos de verificación o pruebas después de cada cambio

Los planes de alto nivel o vagos probablemente generen más ciclos de aclaración y bloqueen la ejecución.

¿Cómo gestiona executing-plans las pruebas y verificaciones?

La skill espera que el plan describa qué pruebas o verificaciones ejecutar. Para cada tarea, el agente debería:

• Realizar los cambios de código o configuración descritos
• Ejecutar las pruebas, comprobaciones o comandos específicos mencionados en el plan
• Marcar la tarea como completed solo cuando esas verificaciones hayan tenido éxito o se hayan conciliado contigo

Esto convierte la ejecución de pruebas en parte del flujo de trabajo, y no en algo que se deja para el final.

¿Qué sucede cuando todas las tareas han terminado?

Cuando todas las tareas se han ejecutado y sus verificaciones han sido satisfactorias, executing-plans deriva al flujo finishing-a-development-branch:

• El agente anuncia que está cambiando a la skill de finalización
• Usa superpowers:finishing-a-development-branch como sub-skill obligatoria
• Esa skill se encarga de las comprobaciones finales, de presentarte opciones y de ejecutar las acciones de finalización que elijas

Esta separación mantiene la ejecución y la finalización bien diferenciadas y más fáciles de razonar.

¿Qué pasa si el plan resulta estar mal?

Si el agente descubre que seguir el plan provocaría un comportamiento incorrecto o no puede tener éxito tal como está escrito, debería:

1. Dejar de ejecutar las tareas restantes
2. Explicar claramente qué está mal en el plan
3. Preguntarte si quieres actualizar el plan, crear uno nuevo o cambiar a otro flujo de trabajo

Executing-plans asume que el plan es la fuente de verdad; cuando esa suposición falla, hace falta una revisión humana.

¿Executing-plans es solo para cambios de código?

La skill está orientada principalmente al trabajo de desarrollo (código y tareas relacionadas), pero el mismo patrón —cargar plan, revisar, ejecutar tareas, ejecutar verificaciones— puede aplicarse a otros flujos de trabajo de proyecto bien especificados. Para obtener los mejores resultados, úsala donde puedas definir tareas claras y comprobaciones objetivas de éxito.

¿Cómo puedo evaluar si executing-plans funciona bien en mi proyecto?

Fíjate en estas señales:

• Las tareas de tu plan se marcan de forma constante como in_progress y completed, con trazabilidad clara
• El agente ejecuta con regularidad las verificaciones que especificas e informa de sus resultados
• Recibes avisos tempranos cuando el plan es poco claro o está bloqueado
• La transición a finishing-a-development-branch se siente fluida y predecible

Si se cumplen estas condiciones, executing-plans probablemente encaje bien con las necesidades de gestión de proyecto y automatización de flujos de trabajo de tu equipo.