Obra Superpowers sur Mac mini : guide agent de code (2026)

Les agents qui ignorent conception et tests livrent vite des bugs plausibles. Obra Superpowers (MIT) impose brainstorming → spec approuvée → TDD → revue via 14+ skills. Sur un Mac mini M4 loué, associez OpenClaw et launchd pour du 24/7 SSH.

Pourquoi un Mac mini cloud

SSH stable, clés API isolées, ~99 $/mois (tarifs). Comparez les tokens via tarification Codex CLI.

Architecture

Superpowers rend obligatoires approbation de design et TDD — pas des suggestions de chat. Voir spécifications Mac mini.

Le flux standard comporte sept phases déclenchées automatiquement : brainstorming, git worktrees, writing-plans, subagent-driven-development ou executing-plans, test-driven-development, requesting-code-review, finishing-a-development-branch. Chaque fichier SKILL.md commence par une règle non négociable (« Iron Law ») et une liste de rationalisations que l’agent pourrait utiliser pour sauter l’étape—c’est le cœur du design Jesse Vincent.

Sur un Mac mini loué ProxyMac, vous installez le plugin sur la machine qui exécute réellement l’agent. Si vous pilotez Cursor depuis un portable mais compilez sur le serveur, installez Superpowers là où le dépôt git vit pour éviter des chemins incohérents.

Guide en 9 étapes

1. 16 Go RAM min ; 24 Go avec OpenClaw.
2. Outils : Xcode CLI, git, Node 22+.
3. ~/agents/superpowers-workspace.
4. Cursor : /add-plugin superpowers
5. Claude Code : marketplace officiel.
6. Codex : /plugins → superpowers.
7. PATH dans launchd (variables MCP).
8. Test : questions avant code.
9. Option install OpenClaw.

Cursor

Dans le chat Agent : /add-plugin superpowers. Redémarrez la session. Demandez une petite fonctionnalité : l’agent doit poser des questions avant d’éditer. Sans cela, le marketplace n’a pas chargé le plugin.

Claude Code

/plugin install superpowers@claude-plugins-official ou via obra/superpowers-marketplace. Vérifiez avec /plugin list. Les sessions longues consomment plus de tokens—surveillez Codex/Claude billing séparément du loyer Mac.

Après approbation du design, l’agent rédige un plan avec chemins de fichiers et commandes de test. Les sous-agents traitent chaque tâche avec revue en deux temps (conformité spec, puis qualité code). C’est là que le Mac mini 24/7 rentabilise le surcoût initial de réflexion.

Dépannage

Skills ignorés

Nouvelle session ; plugin activé ; demandez explicitement le brainstorming Superpowers.

Marketplace bloqué

Proxy : voir egress HTTP.

FAQ

Matrice des outils

Superpowers s’installe par harness : le plugin Cursor n’apparaît pas dans Codex. Claude Code convient aux sessions longues ; Codex aux équipes OpenAI. Copilot CLI : copilot plugin install superpowers@superpowers-marketplace.

Sécurité et exploitation

Utilisateur macOS dédié, secrets dans Keychain, pas de Bureau iCloud. Les worktrees peuvent consommer 5–15 Go. Le flux impose conception + TDD : +5–15 min en amont, moins de retouches ensuite. Mise à jour : /plugin update superpowers (Claude).

Agents bruts vs Superpowers

Sur le même Mac mini loué, une session « brute » peut livrer une fonctionnalité en une heure avec des régressions découvertes plus tard en CI. Avec Superpowers, comptez ~20 minutes de design/tests puis ~40 minutes d’implémentation, souvent avec moins de surprises. Le framework est MIT : l’expérience ne coûte que du temps ingénieur.

OpenClaw gère canaux et MCP ; Superpowers gère le processus—les deux sont complémentaires. Mesurez les incidents post-merge : s’ils baissent, gardez Superpowers pour les features multi-fichiers.

Les sept phases en détail

Brainstorming force l’agent à clarifier objectifs, contraintes et API existantes avant toute modification. Vous validez le design par morceaux—idéal sur SSH depuis un Mac mini toujours allumé.

Git worktrees isolent la branche de feature avec une baseline de tests verte. Sur disque APFS, prévoyez un répertoire de travail par agent si vous lancez plusieurs features en parallèle.

Writing-plans découpe le travail en tâches de 2–5 minutes avec chemins de fichiers et commandes de vérification explicites—réduisant les dérives sur longues sessions autonomes.

Subagent-driven-development envoie un sous-agent par tâche avec revue spec puis qualité. C’est la fonctionnalité la plus gourmande en CPU/RAM sur Mac mini M4.

TDD impose rouge-vert-refactor : tout code écrit avant le test est supprimé. Les équipes CI voient moins de régressions silencieuses.

Code review classe les problèmes par sévérité ; les critiques bloquent la suite du plan.

Finishing-a-branch propose fusion, PR, conservation ou abandon du worktree—évitant l’accumulation de branches zombies sur un serveur partagé.

Pour les typos d’une ligne, préfixez skip superpowers. Pour toute story touchant plus de deux fichiers sur un Mac loué, laissez le flux complet s’exécuter.

Coût Mac loué vs laptop personnel

Un MacBook M4 coûte souvent 1 000 €+ à l’achat ; une location ProxyMac autour de 99 $/mois évite l’amortissement pour un bac à sable agents uniquement. Les tokens Claude/Codex restent facturés à part—Superpowers allonge les sessions, donc budgétisez les plafonds API avant d’activer subagent-driven-development sur des features larges.

En région UE, isoler les secrets sur le Mac loué aide aussi la conformité : pas de clés prod sur le portable qui voyage. Couplez variables MCP launchd avec Keychain pour injections non interactives.

Si vous hébergez aussi Gemini CLI ou Copilot CLI sur le même Mac mini, répétez l’installation marketplace pour chaque outil. Les skills restent des fichiers Markdown—la portabilité est excellente, mais aucune synchronisation automatique n’existe entre harness.

À lire

• Guide Hermes Agent sur Mac
• Qu'est-ce qu'un agent harness ?
• Installation OpenClaw
• Prix Codex
• Variables MCP

Les 14 skills essentiels

brainstorming

Clarification des objectifs et contraintes avant tout diff. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

using-git-worktrees

Branches isolées et baseline de tests verte sur le Mac loué. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

writing-plans

Tâches de 2–5 minutes avec chemins et commandes de vérification. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

subagent-driven-development

Sous-agents et double revue—phase la plus lourde en CPU. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

executing-plans

Exécution par lots avec points de contrôle humains. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

test-driven-development

Rouge-vert-refactor ; code écrit avant le test supprimé. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

requesting-code-review

Findings par sévérité ; critiques bloquants. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

receiving-code-review

Réponse structurée aux commentaires de revue. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

systematic-debugging

Analyse en quatre phases au lieu de deviner. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

verification-before-completion

Preuve que le correctif tient. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

dispatching-parallel-agents

Sous-agents parallèles pour modules indépendants. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

finishing-a-development-branch

Fusion, PR, garder ou jeter le worktree. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

writing-skills

Création de nouveaux skills selon les règles upstream. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.

using-superpowers

Introduction pour charger les skills avant chaque tâche. Sur Mac mini M4 loué, chaque phase consomme RAM et disque—surveillez Activity Monitor et df -h pendant subagent-driven-development.