executing-plans

Présentation

Ce que fait la skill executing-plans

La skill executing-plans est conçue pour les situations où vous disposez déjà d’un plan d’implémentation rédigé et où vous souhaitez qu’un agent l’exécute de manière méthodique. Elle se concentre sur :

• Charger un plan concret, étape par étape, depuis votre projet
• Passer le plan en revue de façon critique avant de commencer tout travail
• Exécuter les tâches une par une avec des changements de statut clairs
• Lancer les vérifications et les tests définis dans le plan
• Transmettre le travail à un workflow de finalisation une fois le développement terminé

Au début d’une session, l’agent est censé annoncer :

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

Cela rend explicite que l’agent est en mode d’exécution structurée, et non en mode de réflexion libre ou de conception de plan.

À qui s’adresse cette skill

Cette skill est particulièrement adaptée :

• Aux développeurs qui préfèrent concevoir en amont, puis laisser un agent exécuter un plan détaillé
• Aux équipes utilisant GitHub avec un plan d’implémentation écrit par fonctionnalité ou par branche
• Aux opérateurs d’agents travaillant dans des environnements comme Claude Code ou Codex qui souhaitent des workflows d’exécution prévisibles et reproductibles
• Aux mainteneurs de projet qui veulent une exécution fidèle à un plan, avec des points de contrôle explicites et des étapes de vérification

Elle est particulièrement utile lorsque votre plan est déjà découpé en petites étapes et qu’il inclut des exigences claires de vérification ou de tests.

Les problèmes que résout executing-plans

La skill executing-plans vous aide à :

• Éviter des implémentations improvisées et fluctuantes en ancrant le travail dans un plan pré‑validé
• Détecter les problèmes tôt grâce à une revue critique du plan avant toute modification de code
• Suivre l’avancement tâche par tâche, en marquant le travail comme in_progress puis completed
• S’assurer que les vérifications et tests prévus dans le plan sont réellement exécutés
• Transmettre proprement la main à une skill de finalisation pour les derniers tests et la prise de décision

En standardisant l’exécution des plans, cette skill réduit les risques de malentendus et facilite une collaboration plus prévisible entre les humains et les agents sur les travaux de développement.

Quand cette skill est (ou n’est pas) adaptée

Utilisez executing-plans lorsque :

• Vous disposez déjà d’un plan d’implémentation écrit
• Le plan est séquencé en tâches ou en étapes
• Vous souhaitez que l’agent se concentre principalement sur l’exécution, et non sur la conception de la solution
• Vous voulez des points de contrôle où l’agent demande de l’aide si quelque chose est flou ou bloqué

Envisagez une autre skill ou un autre workflow lorsque :

• Vous avez besoin d’aide pour créer un plan à partir de zéro (cette skill part du principe que le plan existe déjà)
• Le plan est très vague ou manque d’informations critiques
• Votre plateforme dispose d’un support avancé pour les sous‑agents (par exemple Claude Code, Codex) et vous voulez une orchestration plus sophistiquée — dans ce cas, le référentiel recommande d’utiliser superpowers:subagent-driven-development à la place
• Vous n’êtes pas encore prêt à vous engager sur une stratégie d’implémentation précise et souhaitez encore explorer différentes options

Le référentiel précise également qu’une fois toutes les tâches exécutées, vous devez passer à la sous‑skill requise superpowers:finishing-a-development-branch pour finaliser le travail.

Comment l’utiliser

Installation et configuration

1. Installer la skill executing-plans

Installez la skill depuis le dépôt obra/superpowers :

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

Cela rend le workflow executing-plans disponible dans l’environnement de votre agent.

2. Préparer votre plan d’implémentation

Avant d’appeler la skill, assurez-vous d’avoir un plan d’implémentation écrit dans votre projet. Idéalement, le plan doit :

• Être stocké dans un fichier que votre agent peut lire (par exemple dans votre repo)
• Être découpé en tâches individuelles ou en petites étapes
• Inclure les instructions de vérification ou de tests requises pour chaque tâche

Plus votre plan est clair et de bonne qualité, plus le workflow executing-plans sera fiable.

Workflow principal : du plan à l’exécution

Étape 1 : Charger et relire le plan

Quand vous démarrez une session avec executing-plans, l’agent doit :

1. Lire le fichier de plan depuis votre projet
2. Passer le plan en revue de manière critique, en recherchant :
   • Des informations manquantes ou des instructions ambiguës
   • Des conflits ou contradictions entre les étapes
   • Des hypothèses irréalistes ou des prérequis qui pourraient ne pas être remplis
3. Si l’agent identifie des problèmes, il doit vous les signaler avant de commencer l’exécution
4. S’il n’y a pas de point bloquant, l’agent doit créer sa structure de to‑do interne (par exemple TodoWrite) et se préparer à exécuter

Cette étape de revue est essentielle. Elle évite que l’agent ne suive aveuglément un plan défaillant et favorise des clarifications précoces.

Étape 2 : Exécuter les tâches avec suivi de statut

Pour chaque tâche du plan, la skill executing-plans attend le schéma suivant :

1. Marquer la tâche comme in_progress afin que vous puissiez suivre le travail en cours
2. Suivre chaque étape à la lettre telle qu’elle est décrite dans le plan
   • Le plan est supposé contenir des étapes concrètes et de petite taille
   • L’agent doit éviter d’improviser sauf si le plan est manifestement insuffisant
3. Exécuter les vérifications prévues
   • Cela peut inclure l’exécution de tests, de linters ou de contrôles manuels décrits dans le plan
4. Marquer la tâche comme completed une fois que tout le travail et les vérifications associées sont terminés

Cette structure facilite le suivi de l’avancement par les humains et aide l’agent à ne pas négliger la phase de validation.

Étape 3 : Finaliser le développement via la finishing skill

Une fois toutes les tâches du plan exécutées et vérifiées :

• L’agent doit annoncer :

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

• Puis utiliser la sous‑skill requise : superpowers:finishing-a-development-branch

• Suivre cette finishing skill pour :

  • Relancer ou vérifier les tests si nécessaire
  • Présenter des options ou résultats finaux (état de la branche, prochaines étapes, etc.)
  • Exécuter les actions de finalisation choisies

Executing-plans doit donc être vu comme la partie centrale de votre pipeline de développement : elle vous amène d’un plan écrit à des changements implémentés, puis transmet la main à un workflow de finalisation dédié.

Gestion des blocages et des incertitudes

Quand s’arrêter et demander de l’aide

Selon la définition de la skill, l’agent doit interrompre immédiatement l’exécution et demander de l’aide si :

• Il rencontre un blocage, par exemple :
  • Des dépendances ou outils manquants
  • Des tests qui échouent de façon inattendue
  • Des instructions impossibles à suivre avec le contexte disponible
• Le plan présente des lacunes critiques empêchant de lancer ou poursuivre le travail
• L’agent ne comprend pas suffisamment une partie du plan pour continuer en toute confiance

Dans ces situations, la session doit passer de l’exécution à la clarification, l’agent expliquant ce qui bloque l’avancement et ce dont il a besoin de votre part.

Bonnes pratiques avec executing-plans

Pour tirer le meilleur parti de la skill executing-plans :

• Écrivez des plans spécifiques et séquencés, avec un résultat clair par tâche
• Incluez des instructions de vérification pour chaque changement important
• Encouragez l’agent à résumer les points de vigilance repérés lors de la revue initiale plutôt que de deviner en silence
• Utilisez systématiquement la skill finishing-a-development-branch après l’exécution pour garder un workflow global prévisible

FAQ

Qu’est-ce que la skill executing-plans, en termes simples ?

La skill executing-plans est un workflow structuré permettant aux agents de charger, relire et exécuter un plan d’implémentation pré‑rédigé. Elle déroule les tâches étape par étape, exécute les vérifications prévues, puis passe la main à une finishing skill une fois le développement terminé.

Comment installer la skill executing-plans ?

Vous pouvez l’installer depuis le dépôt obra/superpowers avec :

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

Après l’installation, configurez votre agent ou votre environnement pour qu’il puisse lire le fichier de plan d’implémentation et invoquer executing-plans pour les sessions concernées.

Ai-je besoin de sous-agents pour utiliser executing-plans ?

Non. La skill executing-plans est conçue pour fonctionner même sans support de sous‑agents. Toutefois, le référentiel indique que Superpowers fonctionne mieux avec des sous‑agents, et si votre plateforme les prend en charge (par exemple Claude Code ou Codex), vous devriez envisager d’utiliser superpowers:subagent-driven-development pour une orchestration plus riche, plutôt que executing-plans.

Quand privilégier executing-plans par rapport à subagent-driven development ?

Utilisez executing-plans lorsque :

• Votre environnement offre un support limité ou inexistant pour les sous‑agents
• Vous souhaitez une exécution simple et linéaire d’un plan existant
• Vous privilégiez un flux clair revue → exécution → finalisation, sans orchestration complexe d’agents

Si vous avez besoin de collaboration multi‑agents, de décomposition dynamique des tâches ou d’une prise de décision plus autonome, l’alternative recommandée est superpowers:subagent-driven-development.

Quel type de plan fonctionne le mieux avec executing-plans ?

Executing-plans est particulièrement efficace avec des plans :

• Rédigés dans un fichier accessible par votre agent
• Découpés en tâches ordonnées et de petite taille
• Clairs sur les attentes, les entrées et les sorties
• Explicites sur les étapes de vérification ou de tests après chaque changement

Les plans très haut niveau ou vagues risquent de déclencher davantage de cycles de clarification et de bloquer l’exécution.

Comment executing-plans gère-t-elle les tests et les vérifications ?

La skill s’attend à ce que le plan décrive quels tests ou vérifications exécuter. Pour chaque tâche, l’agent doit :

• Appliquer les changements de code ou de configuration décrits
• Lancer les tests, contrôles ou commandes spécifiés dans le plan
• Ne marquer la tâche comme completed que lorsque ces vérifications ont réussi ou ont été arbitrées avec vous

Ainsi, l’exécution des tests fait partie intégrante du workflow, et non une étape ajoutée après coup.

Que se passe-t-il une fois toutes les tâches terminées ?

Une fois toutes les tâches exécutées et leurs vérifications réussies, executing-plans passe la main au workflow finishing-a-development-branch :

• L’agent annonce qu’il bascule vers la finishing skill
• Il utilise superpowers:finishing-a-development-branch comme sous‑skill requise
• Cette skill prend en charge les derniers contrôles, la présentation des options et l’exécution des actions de finalisation que vous choisissez

Cette séparation rend les enjeux d’exécution et de finalisation plus clairs et plus faciles à raisonner.

Que faire si le plan s’avère incorrect ?

Si l’agent découvre qu’appliquer le plan conduirait à un comportement erroné ou qu’il ne peut pas réussir tel qu’il est rédigé, il doit :

1. Arrêter l’exécution des tâches
2. Expliquer clairement ce qui ne va pas dans le plan
3. Vous demander s’il faut mettre à jour le plan, en créer un nouveau ou basculer vers un autre workflow

Executing-plans considère que le plan est la source de vérité ; lorsque cette hypothèse ne tient plus, une revue humaine est nécessaire.

Executing-plans est-elle réservée aux changements de code ?

La skill est principalement orientée vers le travail de développement (code et tâches connexes), mais le même schéma — charger un plan, le relire, exécuter les tâches, lancer les vérifications — peut s’appliquer à d’autres workflows de projet bien spécifiés. Pour de meilleurs résultats, utilisez-la là où vous pouvez définir des tâches claires et des critères de réussite objectifs.

Comment évaluer si executing-plans fonctionne bien pour mon projet ?

Surveillez les signaux suivants :

• Les tâches de votre plan sont systématiquement marquées in_progress puis completed avec une bonne traçabilité
• L’agent exécute régulièrement les vérifications que vous avez définies et en rapporte les résultats
• Vous recevez des alertes précoces lorsque le plan est flou ou bloqué
• Le passage à finishing-a-development-branch est fluide et prévisible

Si ces conditions sont réunies, executing-plans est probablement bien adaptée aux besoins de gestion de projet et d’automatisation de workflow de votre équipe.