# Démarrer avec le kit de développement

Le kit qui prépare Claude Code pour travailler sur Ironlane : règles, agents, compétences, garde-fous et environnement local.


Le kit de développement prépare Claude Code pour travailler sur Ironlane. Vous ouvrez le dépôt, vous dites à Claude **« Installe ça »**, et il met en place l'encadrement et l'environnement local.

:::caution[Parcours en cours d'essai, cible en construction]
Le kit suit l'état actuel du dépôt (une pile de base locale en conteneurs). Ironlane devient une application Next.js sur PostgreSQL seul, installable en une commande : le kit suivra cette cible, et cette page sera réécrite.


Le parcours décrit ici est celui que fixe le fichier d'installation du dépôt. Un essai sur un dossier vierge a déjà montré un blocage : **sur une base vide, les migrations s'arrêtent aujourd'hui à `20260831000000_chantier_devient_affaire.sql`** (une colonne `chaine_id` est absente). La base locale n'est donc pas encore prête à l'issue de `/start`. Le socle doit être régénéré, et cette page sera corrigée quand ce sera fait.
:::

## Ce que le kit apporte

| Élément | Ce que c'est |
| --- | --- |
| Les règles | Les [96 règles de développement](/regles/), lues à la demande par domaine, avec leur identifiant. |
| Les agents | `project-lead`, `code-reviewer`, `database-reviewer`, `screens-reviewer`, `second-opinion`. Des rôles que **vous** lancez : ils lisent, ils n'écrivent pas. |
| Les compétences | `migration`, `screen-test`, `database-review`, `verification`. Les gestes qui reviennent, écrits une fois. |
| Les commandes | `/start` prépare l'environnement local, `/review` lance les relecteurs, `/rules` lit les règles. |
| Les crochets | Un rappel au début de session, des rappels sur le SQL, et une garde de commit : pas de `git add -A`, aucun secret mis en attente. |
| Les permissions | La mise en ligne, un import réel, un nouveau paquet et une base distante demandent toujours votre accord. |

Le kit encadre le travail **dans le produit** : écrans, base de données, tests. Il ne couvre pas l'écriture d'un plugin. Il ne crée pas de conversations : les rôles sont lancés par la personne.

## Charger le kit : deux façons

### Vous avez cloné le dépôt (le cas normal)

Le dossier `.claude/`, le fichier de consignes et le fichier d'installation sont déjà dans le clone. Claude Code les charge quand il ouvre le dossier. Si Claude Code demande s'il doit faire confiance aux crochets du projet, c'est à vous de répondre : ce sont trois petits scripts, dans `.claude/hooks/`.

### Vous travaillez sans clone, ou dans un autre dossier

Installez le plugin depuis le même dépôt :

```text
/plugin marketplace add <adresse du dépôt>
/plugin install ironlane-dev@ironlane
```

Les commandes portent alors le préfixe du plugin : `/ironlane-dev:start`, `/ironlane-dev:review`, `/ironlane-dev:rules`.

:::note
Un plugin ne peut pas porter de permissions. Fusionnez à la main le fichier `kit/ironlane-dev/permissions.json` dans le fichier `.claude/settings.json` de votre projet.
:::

## Préparer l'environnement local

Le plus simple : dites à Claude « Installe ça », ou lancez `/start`. Claude vous pose les questions une par une, annonce chaque commande avant de la lancer et s'arrête à la première erreur.

**1. Vérifier ce qui manque.** Cette commande ne change rien :

```bash
node scripts/kit/start.mjs --check
```

Elle liste ce qui manque parmi Node 20 ou plus, pnpm, Docker (ou OrbStack) et Python 3.

**2. Préparer.**

```bash
node scripts/kit/start.mjs
```

Le script installe les dépendances JavaScript et les crochets git, installe les outils Python, démarre la base locale (nommée `ironlane`) dans des conteneurs, applique les migrations sur une base vide et écrit le fichier `.env.local` avec les clés **locales**. Il ne les affiche jamais.

:::caution
Docker est nécessaire. La première exécution télécharge environ **2 Go** d'images de conteneurs et applique plus d'un millier de migrations : comptez **plusieurs minutes**. Vous pouvez relancer le script quand vous voulez, il ne refait que ce qui manque. Avec `--reset`, il reconstruit la base locale (il détruit les données locales, jamais celles d'une base distante).
:::

**Les ports.** La base locale utilise les ports `563xx` et non `543xx`, pour ne pas heurter une base déjà lancée sur votre machine. Son adresse est `http://127.0.0.1:56321`, jamais `54321`.

**3. Lancer l'application.**

```bash
pnpm dev
```

Elle répond sur `http://localhost:3210`.

**4. Vérifier que tout passe.** Sur un dépôt fraîchement cloné, ces quatre commandes doivent réussir :

```bash
pnpm lint
pnpm exec tsc --noEmit
pnpm unit
python3 scripts/controler-la-base.py
```

Si une migration échoue sur la base vide, arrêtez-vous et signalez son nom et l'erreur : c'est un défaut du dépôt, pas de votre installation.

## Vérifier que le kit est actif

- La compétence `regles-ironlane` apparaît, et la session a commencé par le rappel « kit de développement actif ».
- `/start` et `/review` existent, et `/agents` liste les cinq agents.
- `git add -A` est refusé par la garde de commit.
- `pnpm add` et `git push` demandent confirmation.

## Travailler avec le kit

1. Lisez le fichier de consignes, puis seulement la partie de `docs/` qui touche ce que vous changez.
2. Écrivez le changement sur une branche. La compétence `migration` aide pour la base, `screen-test` pour un écran.
3. Lancez `verification`, puis `/review` sur le changement. Corrigez ce que les relecteurs rapportent.
4. Commitez une chose à la fois, fichier par fichier : `type(domaine): ce que ça fait`, puis le pourquoi.

Pour un sujet plus large, lancez l'agent `project-lead` : il le découpe en morceaux indépendants et propose lesquels lancer dans des sessions séparées.

## Ce que le kit ne fait pas

- Il n'écrit pas de plugin : voir [les plugins](/modules/plugins/).
- Il ne touche jamais une base distante. Rien dans l'installation n'en demande une.
- Il ne remplace pas la relecture par une personne : il la prépare.

## Voir aussi

- [Installer Ironlane chez soi](/code-ouvert/installation/) : l'installation d'une instance, hors développement.
- [Contribuer](/code-ouvert/contribuer/)
- [Règles de développement](/regles/)
- [Harness engineering](/ingenierie/harness/) : pourquoi le kit est construit ainsi.
