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.
Ce que le kit apporte
Section intitulée « Ce que le kit apporte »| Élément | Ce que c’est |
|---|---|
| Les règles | Les 96 règles de développement, 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
Section intitulée « Charger le kit : deux façons »Vous avez cloné le dépôt (le cas normal)
Section intitulée « 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
Section intitulée « Vous travaillez sans clone, ou dans un autre dossier »Installez le plugin depuis le même dépôt :
/plugin marketplace add <adresse du dépôt>/plugin install ironlane-dev@ironlaneLes commandes portent alors le préfixe du plugin : /ironlane-dev:start, /ironlane-dev:review, /ironlane-dev:rules.
Préparer l’environnement local
Section intitulée « 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 :
node scripts/kit/start.mjs --checkElle liste ce qui manque parmi Node 20 ou plus, pnpm, Docker (ou OrbStack) et Python 3.
2. Préparer.
node scripts/kit/start.mjsLe 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.
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.
pnpm devElle 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 :
pnpm lintpnpm exec tsc --noEmitpnpm unitpython3 scripts/controler-la-base.pySi 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
Section intitulée « Vérifier que le kit est actif »- La compétence
regles-ironlaneapparaît, et la session a commencé par le rappel « kit de développement actif ». /startet/reviewexistent, et/agentsliste les cinq agents.git add -Aest refusé par la garde de commit.pnpm addetgit pushdemandent confirmation.
Travailler avec le kit
Section intitulée « Travailler avec le kit »- Lisez le fichier de consignes, puis seulement la partie de
docs/qui touche ce que vous changez. - Écrivez le changement sur une branche. La compétence
migrationaide pour la base,screen-testpour un écran. - Lancez
verification, puis/reviewsur le changement. Corrigez ce que les relecteurs rapportent. - 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
Section intitulée « Ce que le kit ne fait pas »- Il n’écrit pas de plugin : voir les 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
Section intitulée « Voir aussi »- Installer Ironlane chez soi : l’installation d’une instance, hors développement.
- Contribuer
- Règles de développement
- Harness engineering : pourquoi le kit est construit ainsi.