Superpowers : 311 000 étoiles pour une méthodologie en Markdown

Le dépôt le plus étoilé du classement GitHub de la semaine n'est ni un modèle, ni un framework, ni le loss leader open source d'une startup. C'est un dossier de fichiers Markdown qui explique à votre agent de code comment se comporter.

Superpowers, de Jesse Vincent, tourne autour de 311 000 étoiles, avec environ 5 900 ajoutées la semaine dernière. Sa description : une méthodologie complète de développement logiciel pour vos agents de code, bâtie sur un ensemble de skills composables et quelques instructions initiales qui garantissent que l'agent les utilise vraiment.

Trois cent mille étoiles pour une méthodologie, c'est étrange à regarder. Soit la plus grande cohorte de développeurs de la décennie a soudain décidé qu'elle voulait du processus, soit le bouton étoile est devenu un marque-page pour « il faudra que je pense à ça ». Probablement les deux. Mais le contenu mérite d'être pris au sérieux, parce que c'est la réponse la plus affirmée jamais livrée à la question de ce qu'un agent doit faire avant d'écrire du code.

Le premier geste est de ne pas commencer

Voici le déroulé tel que le décrit le README. Dès que l'agent voit que vous construisez quelque chose, il ne se jette pas sur le code. Il prend du recul et demande ce que vous cherchez vraiment à faire.

Une fois qu'il a tiré une spec de la conversation, il vous la montre par morceaux assez courts pour être lus. Pas un mur d'exigences. Des morceaux. Après votre validation, il produit un plan d'implémentation assez détaillé, selon les mots du README, pour qu'un « jeune ingénieur enthousiaste, sans goût, sans jugement, sans contexte projet et allergique aux tests » puisse le suivre.

Cette phrase est la meilleure chose du dépôt. C'est aussi une description exacte de ce qu'est un LLM un mauvais jour, et écrire le plan pour ce lecteur est une discipline que la plupart des ingénieurs sautent, parce que nous supposons que le lecteur partage notre contexte.

Puis, quand vous dites go, il lance le développement piloté par sous-agents : les agents traitent chaque tâche, inspectent et relisent leur travail, et continuent. Le README affirme qu'il n'est pas rare que l'agent travaille en autonomie deux heures durant sans dévier du plan.

Ce qu'il y a vraiment dans la boîte

Une quinzaine de skills, groupés par fonction.

Les tests ont une entrée, et c'est celle qui compte : test-driven-development, le cycle rouge-vert-refactor, avec un document de référence sur les anti-patrons de test. Le débogage a systematic-debugging, un processus de cause racine en quatre phases avec des techniques de traçage, de défense en profondeur et d'attente conditionnelle, plus verification-before-completion, dont l'unique travail est d'empêcher l'agent de proclamer victoire sur un problème non corrigé.

C'est la collaboration qui porte le poids : brainstorming pour faire émerger l'intention, writing-plans, executing-plans, dispatching-parallel-agents, demander et recevoir une revue de code, using-git-worktrees, finishing-a-development-branch, et subagent-driven-development avec sa revue en deux temps — conformité à la spec d'abord, qualité du code ensuite.

Deux méta-skills bouclent l'ensemble : writing-skills, pour en créer de nouveaux, et using-superpowers, l'introduction qui pousse le modèle à charger le système au début d'une conversation. Comme les skills se déclenchent automatiquement, la théorie veut que vous n'ayez rien à retenir. Votre agent l'a, c'est tout.

Installer, harnais par harnais, seize fois

C'est ici qu'on mesure la fragmentation du marché de l'outillage pour agents. Superpowers fournit des instructions pour Claude Code, Antigravity, l'appli et le CLI Codex, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code, Hermes et Muse.

Claude Code, via la place de marché officielle :

/plugin install superpowers@claude-plugins-official

Ou via la place de marché de Vincent :

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor, dans le chat de l'agent : /add-plugin superpowers. Gemini CLI : gemini extensions install https://github.com/obra/superpowers. Copilot CLI : enregistrez la place de marché, puis copilot plugin install superpowers@superpowers-marketplace. Antigravity : agy plugin install https://github.com/obra/superpowers. Devin : devin plugins install obra/superpowers. Factory Droid : enregistrer, puis installer. L'appli Codex et le CLI passent tous deux par la place de marché officielle des plugins.

Si vous utilisez plusieurs harnais, vous l'installez séparément pour chacun. Autrement dit, les mêmes douze skills existent en douze copies sans chemin de mise à jour partagé, et le conseil du README pour la mise à jour est « cela dépend un peu de l'agent de code, mais souvent automatique ». Ce n'est pas une critique du projet. C'est l'état actuel de l'écosystème, et voir un dépôt de méthodologie s'en accommoder est instructif.

La politique de contribution trahit le raisonnement

Enterré dans la section contributions : ils n'acceptent globalement pas de nouveaux skills, les mises à jour de skills doivent fonctionner sur tous les agents pris en charge, et ils refusent les PR écrites par un agent qui corrigent un ticket ouvert par quelqu'un d'autre, sauf demande d'un mainteneur, même si vous rencontrez le même problème.

Demandez-vous à quoi sert cette dernière règle. Le mode de défaillance évident pour un dépôt comme celui-ci, c'est d'être enseveli sous des skills plausibles générés par les agents que ces skills sont censés encadrer. Vincent l'a vu venir et l'a bloqué d'avance, au prix d'une apparence peu aimable.

La conséquence est plus subtile. Si votre agent peut générer un skill pour n'importe quoi, la ressource rare cesse d'être le skill et devient le jugement sur ce qui vaut la peine d'exister. Ce jugement est ce que le dépôt vend réellement, et il n'est pas ouvert aux pull requests.

Là où la méthode casse

Quatre choses, par ordre de fréquence.

Le processus ne corrige pas le goût. Un plan parfaitement exécuté pour une fonctionnalité mal conçue produit une version bien testée de la mauvaise chose. Le skill brainstorming aide en demandant ce que vous voulez vraiment, mais il ne vous dira pas que l'idée est plate.

L'économie des tokens. Spec, revue par morceaux, plan, dispatch de sous-agents, revue en deux temps par tâche, vérification avant clôture. Sur une petite tâche, c'est une quantité spectaculaire de surcharge. La méthode est conçue pour du travail qui se compte en jours, et elle paraîtra absurde sur une correction d'une ligne.

Les plans dérivent. Deux heures d'autonomie sur un plan écrit à la minute zéro, c'est très bien quand le plan était juste. Quand la troisième tâche révèle que la deuxième reposait sur une hypothèse fausse, vous obtenez deux heures de travail assuré dans la mauvaise direction, et la revue est la seule chose qui vous sépare d'un diff très volumineux.

Et la vérité désagréable : les skills sont des prompts, et les prompts sont des suggestions. Tout repose ici sur le fait que le modèle choisisse de suivre le skill plutôt que cinq autres choses qu'il sait aussi. C'est pour ça que using-superpowers existe comme amorce : c'est un prompt dont le travail est de faire charger les autres prompts.

À qui ça s'adresse

Si vous livrez du code dont d'autres dépendent, et que vous avez vu un agent marquer avec aplomb comme terminé quelque chose qui ne l'était pas, c'est un ensemble de garde-fous raisonnable et il coûte une commande à essayer. Commencez par test-driven-development et verification-before-completion, et ignorez le reste une semaine. Ces deux-là changent le plus le comportement.

Si vous prototypez, passez. La méthode est optimisée pour ne pas livrer de déchets, objectif différent de celui qui consiste à savoir si l'idée tient.

Trois cent mille étoiles ne sont pas un verdict sur la méthode. C'est un verdict sur le moment : beaucoup de gens ont désormais des agents qui écrivent du code plus vite qu'ils ne peuvent le superviser, et ils cherchent de quoi rendre la supervision moins chère. Superpowers est une réponse. Le fait qu'elle soit en Markdown est la partie la plus intéressante.