obra/superpowers : ce que le README permet réellement d'évaluer

Une méthodologie qui commence avant la première ligne de code

Superpowers est une méthodologie de développement logiciel pour agents de codage, construite sur un ensemble de compétences composables et des instructions initiales qui garantissent que l'agent les utilise. La README la décrit comme une méthodologie complète plutôt qu'un outil unique. Au démarrage, l'agent ne se met pas directement à écrire du code. Il demande ce que vous voulez vraiment accomplir, extrait une spécification de la conversation et la présente en segments assez courts pour être lus et assimilés. Les compétences se déclenchent automatiquement, donc après l'installation, vous n'avez rien de spécial à faire : votre agent de codage a simplement Superpowers. Lecture ciblée 1 de obra/superpowers : ce passage est rattaché à Superpowers.

Dans obra/superpowers, le repère Superpowers donne une limite de lecture précise pour la section 1. Le README décrit Superpowers comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère skills permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère éditorial 1.

Dans obra/superpowers, le repère commands donne une limite de lecture précise pour la section 4. Le README décrit commands comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère Claude Code permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère de comparaison 1.

Ce qui se passe après l'approbation de la conception

Une fois la conception approuvée, l'agent élabore un plan d'implémentation que la README décrit comme assez clair pour qu'un ingénieur junior enthousiaste, avec un mauvais goût, aucun jugement, aucun contexte de projet et une aversion pour les tests puisse le suivre. Il met l'accent sur le vrai TDD rouge/vert, YAGNI et DRY. Une fois que vous dites go, il lance un processus de développement piloté par sous-agents, où des agents travaillent sur chaque tâche d'ingénierie, inspectent et examinent leur travail, et poursuivent. La README indique qu'il n'est pas rare que l'agent travaille de manière autonome pendant quelques heures d'affilée sans s'écarter du plan. Lecture ciblée 2 de obra/superpowers : ce passage est rattaché à skills.

Dans obra/superpowers, le repère skills donne une limite de lecture précise pour la section 2. Le README décrit skills comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère agents permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère éditorial 2.

Dans obra/superpowers, le repère Claude Code donne une limite de lecture précise pour la section 5. Le README décrit Claude Code comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère Codex permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère de comparaison 2.

Le workflow en sept étapes

Le workflow de base comprend sept étapes numérotées. Le brainstorming s'active avant l'écriture du code et enregistre un document de conception. using-git-worktrees crée un espace de travail isolé sur une nouvelle branche et vérifie une base de tests propre. writing-plans divise le travail en tâches de deux à cinq minutes, chacune avec des chemins de fichiers exacts, du code complet et des étapes de vérification. subagent-driven-development ou executing-plans envoie ensuite un sous-agent neuf par tâche avec une revue en deux étapes (d'abord la conformité à la spécification, puis la qualité du code), ou exécute par lots avec des points de contrôle humains. test-driven-development impose le cycle rouge-vert-refactor, requesting-code-review a lieu entre les tâches, et finishing-a-development-branch vérifie les tests et présente les options fusionner, pull request, conserver ou supprimer. La README précise que l'agent vérifie les compétences pertinentes avant toute tâche, et qu'il s'agit de workflows obligatoires, pas de suggestions. Lecture ciblée 3 de obra/superpowers : ce passage est rattaché à agents.

Dans obra/superpowers, le repère agents donne une limite de lecture précise pour la section 3. Le README décrit agents comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère commands permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère éditorial 3.

Dans obra/superpowers, le repère Codex donne une limite de lecture précise pour la section 6. Le README décrit Codex comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère plugin permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère de comparaison 3.

Ce que contient la bibliothèque de compétences

Le dépôt organise les compétences en quatre groupes. Testing contient test-driven-development avec son cycle rouge-vert-refactor et une référence sur les anti-modèles de test. Debugging comprend systematic-debugging, un processus de recherche de cause racine en quatre phases, ainsi que verification-before-completion. Collaboration est le plus grand groupe : brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch et subagent-driven-development. Meta contient writing-skills, pour créer de nouvelles compétences selon les bonnes pratiques, et using-superpowers, une introduction à l'ensemble du système. Lecture ciblée 4 de obra/superpowers : ce passage est rattaché à commands.

Dans obra/superpowers, le repère commands donne une limite de lecture précise pour la section 4. Le README décrit commands comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère Claude Code permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère éditorial 4.

Dans obra/superpowers, le repère plugin donne une limite de lecture précise pour la section 7. Le README décrit plugin comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère Superpowers permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère de comparaison 4.

Une installation par environnement

La README liste onze environnements d'agents de codage avec des étapes d'installation distinctes : Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, Gemini CLI, GitHub Copilot CLI, Kimi Code, OpenCode et Pi. Si vous utilisez plusieurs environnements, vous installez Superpowers séparément pour chacun. Claude Code propose une installation via la place de marché officielle de plugins ainsi qu'une place de marché Superpowers distincte. Gemini CLI, Factory Droid et Pi installent directement depuis ce dépôt. OpenCode n'utilise pas d'installation de plugin ; vous demandez à l'agent de récupérer des instructions depuis une URL dans le dépôt. Les mises à jour dépendent de l'agent de codage, mais sont souvent automatiques. Lecture ciblée 5 de obra/superpowers : ce passage est rattaché à Claude Code.

Dans obra/superpowers, le repère Claude Code donne une limite de lecture précise pour la section 5. Le README décrit Claude Code comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère Codex permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère éditorial 5.

Dans obra/superpowers, le repère Superpowers donne une limite de lecture précise pour la section 8. Le README décrit Superpowers comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère skills permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère de comparaison 5.

Contribution, télémétrie et licence

La contribution commence par un fork du dépôt et le passage à la branche dev. La README indique que les nouvelles compétences ne sont généralement pas acceptées et que toute mise à jour des compétences doit fonctionner sur tous les agents de codage pris en charge. Les tests de comportement des compétences utilisent le harnais d'évaluation drill de superpowers-evals, cloné dans evals/, tandis que les tests d'infrastructure des plugins se trouvent dans tests/. Une section télémétrie explique que le compagnon visuel optionnel du brainstorming charge le logo Prime Radiant depuis le site web du projet par défaut, incluant la version de Superpowers utilisée mais aucun détail sur le projet, le prompt ou l'agent. Il peut être désactivé avec la variable d'environnement SUPERPOWERS_DISABLE_TELEMETRY, et les opt-outs de Claude Code sont respectés. La README mentionne également un support commercial, des outils supplémentaires et des dépenses gérées pour les utilisateurs en entreprise, à l'adresse sales@primeradiant.com. Le projet est développé par Jesse Vincent et Prime Radiant. La licence MIT accorde les droits d'utilisation, de copie, de modification, de fusion, de publication, de distribution, de sous-licence et de vente des copies, et fournit le logiciel tel quel, sans garantie. Le texte de la licence ne dit rien sur le support, les garanties de sécurité ou l'état de préparation à la production. Lecture ciblée 6 de obra/superpowers : ce passage est rattaché à Codex.

Dans obra/superpowers, le repère Codex donne une limite de lecture précise pour la section 6. Le README décrit Codex comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère plugin permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère éditorial 6.

Dans obra/superpowers, le repère skills donne une limite de lecture précise pour la section 9. Le README décrit skills comme une entrée, un composant ou une contrainte du projet, sans fournir ici une promesse générale de résultat. Le repère agents permet de poursuivre l'examen dans le dépôt avec le vocabulaire propre à superpowers. Cette distinction évite de transformer une fonction documentée en garantie de compatibilité. Elle compte pour une équipe qui doit choisir entre une intégration ciblée et une solution plus large. La licence MIT encadre la réutilisation du code, tandis que le README reste la source pour les conditions techniques. Repère de comparaison 6.

Conclusion éditoriale

Le projet s'adresse aux personnes dont le besoin correspond à Superpowers et qui acceptent les limites écrites dans le README. Il convient moins à une équipe qui attend une garantie absente des sources. Avant décision, vérifiez skills avec la commande ou le fichier indiqué par superpowers, puis contrôlez le résultat propre à agents.

Sources officielles

1. Official README
2. Project repository
3. Release notes