Installation¶

Prérequis système¶

Composant	Version minimale	Vérification	Requis pour
Git	2.30+	`git --version`	tout
Node.js	18+	`node --version`	bootstrap, CLI, hook pre-commit
PowerShell	7+ (pwsh)	`pwsh --version`	hooks runtime Claude Code (optionnels)

Seuls Git et Node sont requis pour un usage de base. PowerShell n'est nécessaire que pour activer les hooks runtime de Claude Code (section optionnelle plus bas).

Option A — Nouveau projet (recommandé)¶

Depuis un dossier parent où le projet consommateur va vivre :

mkdir mon-projet && cd mon-projet
git init
git submodule add https://github.com/<org>/sdeg-kernel.git .sdeg
git commit -m "chore: add sdeg-kernel as submodule"

Le kernel est maintenant monté dans .sdeg/. Il reste lecture seule côté projet consommateur — les modifications s'y font au niveau du repo kernel.

Option B — Projet existant¶

Depuis la racine d'un projet existant :

git submodule add https://github.com/<org>/sdeg-kernel.git .sdeg
git commit -m "chore: integrate sdeg-kernel"

Si le projet a déjà un dossier .sdeg/ pour un autre usage, utiliser un nom alternatif :

git submodule add https://github.com/<org>/sdeg-kernel.git sdeg-kernel

…et adapter les chemins mentionnés dans le reste du guide.

Bootstrap : synchronisation du kernel dans l'espace de travail¶

Le kernel fournit les skills, agents, hooks, et templates. Le script bootstrap.js les copie à leurs emplacements attendus par Copilot Chat et Claude Code. À exécuter depuis la racine du projet consommateur :

node .sdeg/scripts/bootstrap.js

Effet :

.sdeg/.github/prompts/ → .github/prompts/ (21 skills Copilot Chat)
.sdeg/.github/agents/ → .github/agents/ (agent orchestrateur)
.sdeg/scripts/ → .github/scripts/ (hooks PowerShell)
.sdeg/meta/ → .meta/ (templates d'entrée : EO, PRD…)
.sdeg/.claude/plugins/ → .claude/plugins/ (plugin Claude Code sdeg-task-level : 3 skills intra-us.DEV)

Le bootstrap est idempotent : le relancer après une mise à jour du submodule met à jour les fichiers dérivés.

Installation du hook git pre-commit¶

Depuis la racine du projet consommateur :

node .sdeg/sdlc/install-hooks.js

Effet : installe un hook .git/hooks/pre-commit qui refuse tout commit modifiant sdlc-registry.json sans événement associé (voir Invariant sécurité).

Configuration Claude Code (optionnel)¶

Pour activer les 4 hooks PowerShell durant vos sessions Claude Code, ajouter la clé hooks dans .claude/settings.json (fichier committé, partagé avec l'équipe — pas settings.local.json qui est local uniquement) :

{
  "hooks": {
    "SessionStart": ["pwsh -File .github/scripts/hook-session-start.ps1"],
    "PreToolUse":   ["pwsh -File .github/scripts/hook-pretooluse.ps1"],
    "PreCompact":   ["pwsh -File .github/scripts/hook-precompact.ps1"],
    "Stop":         ["pwsh -File .github/scripts/hook-stop.ps1"]
  }
}

Si settings.json existe déjà, merger la clé hooks sans écraser les autres clés (permissions, etc.). Les hooks étant en PowerShell, cette section nécessite pwsh installé.

Structure attendue après installation¶

mon-projet/
├── .sdeg/                       # submodule kernel (read-only)
│   ├── sdlc/                    # CLI + schéma
│   ├── scripts/                 # sources des hooks
│   ├── .github/prompts/         # sources des skills
│   └── .github/agents/          # sources des agents
├── .github/
│   ├── prompts/                 # skills copiés par bootstrap
│   ├── agents/                  # agents copiés
│   └── scripts/                 # hooks copiés
├── .meta/                       # templates (EO, PRD…)
├── .product/                    # ← créé au 1er usage CLI
│   ├── sdlc-registry.json       # registre d'état
│   ├── .events/                 # événements de transitions
│   ├── .epics/, .features/, .stories/
│   └── spiral-state.md          # mémoire de la spirale
└── .claude/
    ├── settings.json            # (optionnel) hooks Claude Code
    └── plugins/
        └── sdeg-task-level/     # plugin Claude Code (3 skills intra-us.DEV)

Vérification¶

node .sdeg/sdlc/sdlc.js status

Attendu : affichage d'un registre vide (Aucun objet dans le registre. Utilisez : node sdlc/sdlc.js init). Si ce message s'affiche, l'installation est fonctionnelle.

Intégration de la référence canonique¶

Le fichier README.md du kernel est la référence d'installation incluse par cette documentation :

Prérequis¶

Git ≥ 2.30
Node.js ≥ 18
PowerShell 7+ (optionnel — requis uniquement pour les hooks runtime Claude Code)

Étapes¶

# 1. Ajouter sdeg-kernel comme sous-module (chemin conventionnel : .sdeg/)
git submodule add <url-du-kernel>.git .sdeg

# 2. Synchroniser skills, agents, hooks et templates dans le workspace
node .sdeg/scripts/bootstrap.js

# 3. Installer le hook git pre-commit
node .sdeg/sdlc/install-hooks.js

# 4. Commiter
git add .
git commit -m "chore(infra): bootstrap sdeg-kernel"

Voir aussi : Première session · Mise à jour du submodule.