Aller au contenu

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.

Voir en Markdown

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.

É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.

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@ironlane

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

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 :

Fenêtre de terminal
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.

Fenêtre de terminal
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.

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.

Fenêtre de terminal
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 :

Fenêtre de terminal
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.

  • 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.
  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.

  • 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.