Installation en tant que plugin

Shingan est distribuable sous forme de plugin Claude Code. Cette méthode d'installation est la plus simple : une seule commande, et tous les skills, agents, personas et profiles sont disponibles immédiatement dans n'importe quel projet.

Méthode recommandée

L'installation via plugin est désormais la méthode privilégiée. L'installation manuelle reste disponible pour les cas où vous souhaitez modifier le framework lui-même.

Contenu du plugin

Le plugin shingan fournit :

Composant	Quantité	Exemples
Skills	20	/shingan:apex, /shingan:bugfix, /shingan:commit
Agents	8	shingan:executor, shingan:code-reviewer, shingan:explore
Personas	4	analyst, architect, developer, reviewer
Profiles	4	Rust/Tauri, Vue 3, TypeScript, Python

Prérequis

• Claude Code installé et à jour
• Un projet existant avec un dépôt Git

Installation

Depuis GitLab (recommandé)

git clone git@gitlab.com:ia2925011/shingan.git
claude plugins install ./shingan

Claude Code détecte le fichier .claude-plugin/plugin.json à la racine et enregistre tout le contenu sous le namespace shingan:.

Depuis un chemin local

Si vous avez déjà cloné le repository :

claude plugins install /chemin/vers/shingan

Vérification de l'installation

Après installation, vérifiez que le plugin est actif :

# Lister les plugins installés
claude plugins list

Vous devriez voir shingan@1.0.0 dans la liste. Ensuite, dans une session Claude Code :

/shingan:init

Si le skill se charge, l'installation est fonctionnelle.

Le manifeste plugin.json

Le fichier .claude-plugin/plugin.json à la racine du framework déclare le contenu du plugin :

{
  "name": "shingan",
  "version": "1.0.0",
  "description": "Framework de Prompt Engineering — skills, personas, profiles et agents pour orchestrer le développement assisté par IA",
  "skills": "./framework/skills/",
  "agents": "./framework/agents/",
  "personas": "./framework/personas/",
  "profiles": "./framework/profiles/"
}

Claude Code lit ce manifeste lors de l'installation pour enregistrer les skills, agents, personas et profiles sous le namespace shingan:.

Utilisation après installation

Skills

Tous les skills sont disponibles avec le préfixe shingan: :

/shingan:apex          # Pipeline principal APEX
/shingan:bugfix        # Correction de bug guidée
/shingan:review-code   # Review structurée
/shingan:commit        # Commit conventionnel automatisé
/shingan:profile       # Activer un tech profile
/shingan:brainstorm    # Exploration multi-perspective

Agents

Les agents sont invocables dans les prompts ou les steps de skills :

shingan:executor
shingan:code-reviewer
shingan:security-reviewer
shingan:explore
shingan:debugger
shingan:analyst
shingan:test-engineer
shingan:quality-reviewer

Personas et Profiles

Les personas et profiles sont chargés automatiquement par les skills quand nécessaire. Vous n'avez pas besoin de les invoquer directement — un /shingan:apex activera le bon persona à chaque étape.

Pour configurer votre tech profile :

/shingan:profile

Plugin vs installation manuelle

Critère	Plugin	Manuel
Installation	1 commande	Copier framework/, configurer CLAUDE.md
Mises à jour	claude plugins update shingan	Pull + copie manuelle
Namespace	shingan: (isolé)	Direct (pas de préfixe)
Personnalisation	Utiliser tel quel	Modifier les fichiers à volonté
Multi-projets	Installé une fois, disponible partout	Copier dans chaque projet
Cas d'usage	Utilisation quotidienne	Développement du framework

Coexistence avec d'autres plugins

Le framework shingan n'a aucune dépendance sur oh-my-claudecode, superpowers, ou tout autre plugin. Il fonctionne avec Claude Code natif.

Si oh-my-claudecode est également installé, les deux plugins coexistent sans conflit. Les namespaces distincts (shingan: vs oh-my-claudecode:) garantissent l'isolation. En cas d'agents homonymes (par exemple executor), utilisez le préfixe complet pour lever l'ambiguïté.

Mise à jour

claude plugins update shingan

Désinstallation

claude plugins uninstall shingan

La désinstallation supprime tous les skills, agents, personas et profiles du namespace shingan: sans affecter les autres plugins ni la configuration du projet.

Troubleshooting

Problème	Solution
Plugin non trouvé après installation	Vérifiez le chemin du .claude-plugin/plugin.json. Vérifiez que le clone GitLab est complet. Relancez claude plugins list.
Skills non disponibles	Essayez /shingan:init — si erreur, réinstallez le plugin.
Conflit de namespace avec un autre plugin	Utilisez le préfixe complet shingan:nom-du-skill.
Version obsolète	claude plugins update shingan pour mettre à jour.