Installation du plugin

Installez Shingan une seule fois, utilisez-le dans tous vos projets.

Prérequis

• Git installé
• Claude Code ou OpenCode installé et à jour

Pour Claude Code

Depuis le TUI recommandé

Tout se fait directement dans l'interface de Claude Code, sans quitter le terminal :

1. Ajouter la marketplace

/plugin marketplace add https://gitlab.com/ia2925011/shingan.git

2. Installer le plugin

/plugin install shingan@shingan-marketplace

Ou naviguez dans /plugin > Discover pour trouver et installer Shingan.

3. Redémarrer Claude Code

Fermez et rouvrez Claude Code pour charger le plugin.

Via la ligne de commande (alternative)

Si vous préférez utiliser le CLI en dehors de Claude Code :

# 1. Ajouter la marketplace
claude plugin marketplace add https://gitlab.com/ia2925011/shingan.git

# 2. Installer le plugin (disponible dans tous vos projets)
claude plugin install shingan@shingan-marketplace --scope user

# 3. Redémarrer Claude Code

Vérifier l'installation

Étape 1 — Vérifiez que le plugin est reconnu :

claude plugin list

Résultat attendu :

shingan@shingan-marketplace
  Version: 1.1.0
  Scope: user
  Status: enabled

Étape 2 — Testez un skill dans une nouvelle session :

/shingan:kensho

Si le skill se charge sans erreur, c'est bon.

Mise à jour

/plugin marketplace update

Ou via le CLI :

claude plugin update shingan@shingan-marketplace

Désinstallation

claude plugin uninstall shingan@shingan-marketplace
claude plugin marketplace remove shingan-marketplace

---

Pour OpenCode

Via npm recommandé

Ajoutez le plugin dans votre opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-shingan"]
}

Au prochain démarrage d'OpenCode, le plugin s'installe automatiquement via Bun et déploie les skills, agents et profiles vers ~/.config/opencode/.

Mise à jour automatique

Le plugin utilise un marqueur de version (.shingan-version). Quand une nouvelle version est publiée sur npm, les fichiers sont re-déployés automatiquement au démarrage.

Configuration des modèles (optionnel)

Après installation, configurez les modèles interactivement :

npx opencode-shingan setup --models

Le CLI propose 3 modes :

1. Uniforme — un seul modèle pour tous les rôles
2. Par tier — un modèle par niveau (rapide, standard, avancé)
3. Par agent — un modèle par agent (configuration fine)

Commandes CLI

npx opencode-shingan setup              # Déployer en local (.opencode/)
npx opencode-shingan setup --global     # Déployer en global (~/.config/opencode/)
npx opencode-shingan setup --models     # Déployer + configurer les modèles
npx opencode-shingan uninstall          # Désinstaller les fichiers

Via le script (alternative)

Si vous préférez ne pas utiliser npm :

git clone https://gitlab.com/ia2925011/shingan.git
cd shingan
bash install.sh

Le script propose deux modes d'installation :

Mode	Emplacement	Portée
Global	~/.config/opencode/	Tous les projets
Projet	.opencode/	Ce projet uniquement

---

Ce que le plugin installe

Composant	Quantité	Exemples
Skills	20	/shingan:kensho, /shingan:bugfix, /shingan:commit
Agents	9	analyst, architect, executor, code-reviewer, etc.
Profiles	4	Rust/Tauri, Vue 3, TypeScript, xterm

Skills disponibles

Tous les skills utilisent le préfixe shingan: :

/shingan:kensho        # Pipeline principal (méthodologie APEX)
/shingan:bugfix        # Correction de bug guidée
/shingan:review-code   # Review structurée
/shingan:commit        # Commit conventionnel automatisé
/shingan:brainstorm    # Exploration multi-perspective
/shingan:debug         # Debugging systématique
/shingan:clean-code    # Refactoring guidé
/shingan:oneshot       # Implémentation express
/shingan:profile       # Activer un tech profile

Agents et profiles

Les agents et profiles sont chargés automatiquement par les skills quand nécessaire. Pas besoin de les invoquer manuellement.

Coexistence avec d'autres plugins

Shingan fonctionne avec Claude Code natif, sans aucune dépendance externe. Si oh-my-claudecode ou d'autres plugins sont installés, les namespaces distincts (shingan: vs oh-my-claudecode:) garantissent l'isolation — aucun conflit.

Troubleshooting

Problème	Solution
Plugin non trouvé après installation	Redémarrez Claude Code, puis claude plugin list
Skills non disponibles	Fermez et rouvrez votre session Claude Code
Conflit de namespace	Utilisez le préfixe complet : shingan:nom-du-skill
Version obsolète	claude plugin update shingan@shingan-marketplace
Marketplace absent	/plugin marketplace add https://gitlab.com/ia2925011/shingan.git

Référence : plugin.json

Structure du manifeste

Le fichier .claude-plugin/plugin.json déclare le contenu du plugin :

{
  "name": "shingan",
  "version": "1.1.0",
  "description": "Shingan — Framework for AI-assisted development with skills, agents, and workflows.",
  "author": { "name": "Shingan" },
  "license": "GPL-3.0",
  "skills": "./framework/skills/"
}

Claude Code scanne le dossier skills/ et enregistre chaque sous-dossier contenant un SKILL.md sous le namespace shingan:.