Shingan (心眼)

See the code before you write it.

Framework de prompt engineering pour orchestrer le développement assisté par IA. Inspiré de BMAD Method.

Compatible Claude Code et OpenCode.

Contenu

| Composant | Quantite | Description | |-----------|----------|-------------| | Skills | 20+ | Workflows structurés : /shingan:kensho, /shingan:bugfix, /shingan:commit... | | Agents | 9 | Sous-agents spécialisés : executor, code-reviewer, architect, analyst, debugger... | | Profiles | 4+ | Contexte technologique : Rust/Tauri, Vue 3, TypeScript, Python |

Installation

Claude Code

Installation via le marketplace integre :

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

Verification : /shingan:init

OpenCode — via npm (recommande)

Ajoutez le plugin dans votre opencode.json :

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

Le plugin se deploie automatiquement au demarrage d'OpenCode : skills, agents et profiles sont copies vers ~/.config/opencode/.

Pour configurer les modeles interactivement :

npx opencode-shingan setup --models

OpenCode — via script (alternative)

curl -sL https://gitlab.com/ia2925011/shingan/-/raw/main/install.sh | bash

OpenCode — commandes setup

npx opencode-shingan setup              # Deploy local (.opencode/)
npx opencode-shingan setup --global     # Deploy global (~/.config/opencode/)
npx opencode-shingan setup --models     # Deploy + configurer les modeles
npx opencode-shingan uninstall          # Desinstaller

Utilisation

/shingan:kensho        # Pipeline principal Kensho (méthodologie APEX)
/shingan:bugfix        # Diagnostic + correction guidée
/shingan:review-code   # Review structurée (qualité, sécurité, tests)
/shingan:brainstorm    # Exploration multi-perspective
/shingan:commit        # Commit conventionnel automatisé
/shingan:clean-code    # Refactoring guidé
/shingan:debug         # Debugging systématique
/shingan:oneshot       # Implémentation express

Architecture

framework/
├── agents/           # Sous-agents specialises (9 agents)
├── skills/
│   ├── workflows/    # Pipelines multi-steps avec gates (kensho, bugfix, debug...)
│   ├── actions/      # Commandes directes (commit, init, profile...)
│   └── creators/     # Generateurs (create-skill, create-prompt...)
├── profiles/         # Contexte technologique par stack
└── templates/        # Documents standardises (PRD, ADR)

Concepts cles

• Progressive Disclosure : le contexte se charge progressivement pour ne pas saturer la fenetre de l'IA
• Steps avec Gates : chaque skill a des etapes numerotees avec validation entre chaque step
• APEX : methodologie Analyze-Plan-Execute-eXamine (implementee par le skill Kensho)
• Profiles : conventions specifiques a votre stack injectees dans les agents

Documentation

La documentation complète est disponible sur GitLab Pages.

Le code source de la documentation est dans un repo séparé, synchronisé automatiquement à chaque release.

Licence

GPL-3.0