SuperClaude Framework (SuperClaude-Org)

22k★ + MIT + active = surface saine en métriques. La promesse (méta-programmation par injection d'instructions comportementales, orchestration de personas, MCPs intégrés) est exactement ce qu'on étudie dans /theory du codex. Question : est-ce skillify-able pièce-par-pièce, ou un monolithe à adopter ou rejeter en bloc ?

• Snapshot baseline + inventory du ~/.claude/ existant : 14 skills custom, 2 agents user-level, 23 plugins, hooks RTK actifs.
• Cross-distribution check : PyPI SuperClaude v4.3.0 (Python ≥3.10, requires uv + pipx — neither installed), npm @bifrost_inc/superclaude v4.0.7, install.sh, Makefile, plugin marketplace.
• Code audit : install.sh écrit 30 cmds → ~/.claude/commands/, scripts/uninstall_legacy.sh liste les artefacts (plugin marketplace + JSON configs), PLUGIN_INSTALL.md (japonais only) décrit le SessionStart hook auto-injection /pm.
• Stack-mapping : 30 commandes /sc:* mappées contre nos skills/agents existants (sparc, save, skillify, cct, superpowers brainstorming, etc.).
• Install NON-effectuée : pollution prévue trop large pour notre stack en place. Verdict basé sur l'analyse de surface + code source.

Le test produit 6 patterns réutilisables sur l'écosystème — en particulier les heuristiques pour reconnaître un méga-framework non-adoptable :

1. 01

   Le worst-case d'invasion testé

   Pire que claude-mem (qui modifiait juste settings.json + 1 plugin). SuperClaude écrirait 30 commandes dans `~/.claude/commands/`, 20 agents dans `~/.claude/agents/`, registrerait un plugin marketplace, ajouterait un SessionStart hook qui auto-exécute /pm à chaque démarrage, et s'auto-chargerait dans toute env pytest via `entry-points.pytest11`. C'est l'archétype du "framework qui veut être ton OS".

2. 02

   Pas d'`uninstall` first-class = signal rouge

   Le seul cleanup script s'appelle `uninstall_legacy.sh` — le mot `legacy` dans le nom indique que c'est pour les vieux installs, pas l'outil principal. Et il ne couvre que les configs JSON + le plugin marketplace : les 30 commandes et 20 agents copiés dans `~/.claude/` doivent être nettoyés à la main. Heuristique : un outil qui écrit dans plusieurs dirs sans script qui retire 100% est non-adoptable.

3. 03

   PLUGIN_INSTALL.md en japonais seulement

   Pour un projet anglophone à 22k★, la doc officielle d'install est uniquement en japonais (`公式インストール方法 (推奨)`). C'est désorientant et signal d'un projet en transition mal documentée. À distinguer de README multi-langue (en/zh/ja/kr) — ça c'est sain. Mais la doc canonique d'install qui n'existe qu'en JP, c'est un red flag.

4. 04

   Demande à désactiver les builtins Claude Code

   PLUGIN_INSTALL.md demande explicitement d'ajouter `export USE_BUILTIN_RIPGREP=0` dans `.zshrc/.bashrc` et de `brew install ripgrep`. Désactiver activement un builtin Claude Code pour utiliser un binaire système est suspect — soit il y a une vraie raison technique non-documentée, soit c'est de la rigidité qui dégrade le harness. Pattern : un outil qui demande de défaire les défauts du harness pour fonctionner mérite scrutiny.

5. 05

   Notre stack custom couvre déjà 7/8 des features

   30 commandes + 20 agents + 7 modes c'est massif, mais pour Sylvain : `/sc:brainstorm` → on a `superpowers:brainstorming`, `/sc:doctor` → on a `cct --health-check`, `/sc:pm` → on a TodoWrite + plans, `/sc:test` → on a `feature-dev:code-reviewer`, etc. Seul `/sc:research` orchestrant Tavily MCP serait un skill candidate. Leçon : avant d'adopter un méga-framework, lister ce qu'il apporte VS ce qu'on a déjà.

6. 06

   Multi-distribution = chaos d'install

   5 chemins documentés : `pipx install`, `./install.sh`, `make reinstall-plugin-dev`, `npm install @bifrost_inc/superclaude`, et plugin marketplace via `/plugin install`. Chacun fait des choses différentes, aucun n'est documenté de bout en bout. Heuristique : quand un projet propose 5 façons de s'installer, aucune n'est solide. Préférer les outils qui documentent UN chemin propre.

Pour décider quoi skillifier, on a mappé chaque catégorie de commande SuperClaude contre ce qu'on a déjà :

Conditions de re-évaluation pour une future adoption :

• ✓ superclaude uninstall first-class (pas le _legacy.sh)
• ✓ Mode opt-in granulaire (1-2 commandes à la fois, pas pack de 30)
• ✓ --dry-run documenté ET vérifié en sandbox
• ✓ PLUGIN_INSTALL.md en anglais
• ✓ Cesse de demander USE_BUILTIN_RIPGREP=0
• ⏳ v5.0 TypeScript plugin system released (issue #419, no ETA)