Le projet15 min de lecture
Ma contribution et l’IA
L’IA comme levier, l’ingénierie comme exigence. Comment je conçois et construis avec Claude Code, ce que je cadre, tranche et vérifie, et les traces qui le montrent.
L’IA comme levier. L’ingénierie comme exigence.
J’intègre l’intelligence artificielle à mon processus de développement pour explorer, concevoir et construire plus efficacement. De la réflexion à l’implémentation, j’utilise Claude Code pour aller plus loin, tout en gardant la maîtrise des choix techniques, de la cohérence du produit et de la qualité de ce que je livre.
| Qui | Ce qui lui revient |
|---|---|
| Le gérant du magasin | les règles du métier qui engagent le magasin, qu’il valide dans l’ERP sous « Décisions à valider » |
| Moi | le besoin et le cadre métier, les arbitrages, les règles et les garde-fous qui encadrent l’IA, la cohérence du produit, les tests, la vérification du rendu à l’écran et la mise en production |
| Claude Code | l’exploration, les propositions et l’implémentation (le code, les tests, les migrations, cette documentation), dans le cadre que je pose et sous les garde-fous du dépôt |
Ce qui suit s’appuie sur des traces relevées le 13 novembre 2026 : l’historique git, mes messages dans les sessions Claude Code, l’ancien journal des décisions et les consignes qui encadrent les sessions. Les traces et le relevé sont détaillés en fin de page. Le même partage, décision d’architecture par décision, est dans Ce qui me revient dans ces décisions.
Conception
Ce qui me revient :
- Le cadre métier, que je redonne aux sessions et contre lequel je fais juger leurs propositions : « audit toutes les décisions metier, vérifie qu'elles sont cohérentes avec meublesmorinière PME meubles particuliers entreprises entreprise familiale un seul entrepôt TVA 10% et 20%. 2026-2027 » (22 octobre).
- Les besoins vus à l’usage : « quand j'essaye de supprimer un meuble et qu'il reste des pièces en stock je ne veux pas que l'utilisateur soit bloqué » et « liste des produits erp le drag handle est confusant on ne sait pas à quoi il sert, ce qu'il réordonne et pourquoi, à quelle fin » (22 octobre).
- Le lien avec le magasin. Les questions au gérant passent par moi, et les retours des personnes qui utilisent l’ERP me reviennent : « vérifie que rien n'a été oublié n'oublie pas que le gérant n'y connaît rien à l'informatique également » (26 octobre).
- Le premier schéma de données, d’après le journal : « schéma fourni par Adrien, appliqué mot pour mot » (24 août, trace rapportée).
L’IA m’aide à explorer : elle propose des écrans et des architectures, mène des audits, fait évoluer le modèle de données et suggère la plupart des noms et des formes. Je juge ces propositions contre le cadre métier, et je garde celles qui servent le magasin.
Arbitrages
Voici ce que j’ai tranché :
| Date | Décision | Trace |
|---|---|---|
| 23 août | les professionnels peuvent acheter en ligne, au lieu du « B2C strict » envisagé le même jour | journal |
| 24 août | le remboursement sort du périmètre de la V1, contre les deux relectures externes du même jour | journal |
| 31 août | la migration de production se joue à la main, avant la fusion | journal |
| 12 octobre | l’IA ne lance aucun test : des sessions parallèles saturaient la machine | consignes |
| 25 octobre | « Migrer la prod » part sans copie de la base, et le retour arrière passe par la restauration à un instant de Neon | apps/erp/scripts/pre-deploy-migrate.mts |
| 26 octobre | Fisher n’a plus de limite de périmètre, et passe sans la non-conservation des échanges, faute de plan Pro | consignes, et le commentaire ci-dessous |
| 9 novembre | supprimer avant d’ajouter, et ne rien recopier que le code sait déjà | consignes |
Un arbitrage qui a un coût s’écrit là où il s’applique. Celui du 26 octobre accepte que les échanges avec Fisher soient conservés trente jours chez Anthropic, et la page Confidentialité du site le dit.
apps/erp/shared/server/ai/availability.ts · lignes 5–18/**
* Fisher se montre dès que la passerelle peut s'ouvrir. Décision d'Adrien (26/10/2026) : sans plan
* Pro, la non-conservation (ZDR) n'est pas offerte par la passerelle ; Fisher passe quand même, sans
* entraînement chez Anthropic, qui efface les échanges sous 30 jours. `AI_ZERO_DATA_RETENTION` la
* redemande le jour où l'offre la permet (`aiModelOptions`).
*/
export function isAiAvailable(): boolean {
if (env.AI_DISABLED !== undefined) return false;
return (
env.AI_GATEWAY_API_KEY !== undefined ||
env.VERCEL_OIDC_TOKEN !== undefined ||
env.VERCEL_ENV !== undefined
);
}Pour les arbitrages techniques courants, je donne le critère plutôt que la solution : « et vas y corrige tout fais les meilleurs choix sans sur ingenierie pour trancher les décisions et adpatées à meublesmoriniere le plus simplement possible » (13 novembre). L’IA compare et applique dans ce cadre. Ce qui engage le produit s’écrit, daté, là où il s’applique (les consignes, les ADR), pour que la raison d’un choix se relise comme le code.
Les règles du métier qui engagent le magasin reviennent au gérant. Elles lui sont soumises dans l’ERP, sous « Décisions à valider », et chaque réponse garde le verdict, qui l’a donné et la règle en vigueur à ce moment (DecisionAnswer, packages/db/prisma/schema.prisma). Le 9 novembre, la liste comptait 302 décisions (reports/ERP Morinière registre des décisions.md), et j’ai demandé de n’y laisser que les vraies : « Analyse chaque décision demandée au gérant. Supprime les choix inutiles, regroupe ceux qui se recoupent et conserve uniquement les véritables décisions métier nécessitant son intervention. » Elle est passée à 44 le 11 novembre (6327df8f1c), puis à 8 le 13 (7703182e16). Ses réponses sont dans la base de production, pas ici.
Développement
L’implémentation passe par Claude Code : le code, les tests, les migrations, les messages de commit et la documentation, cette page comprise.
Ce qui me revient, c’est le cadre qui rend cette vitesse sûre :
- Les consignes (
AGENTS.md), sur le chargement des pages de l’ERP, les toasts, Fisher, la maintenabilité et la migration de production. - Les garde-fous de la machine, des hooks de Claude Code nés de surcharges mesurées, qui portent chacun la décision qui les a fait naître : aucun test lancé par l’IA, trois serveurs de dev au plus (sept occupaient 27 Go sur 24), deux
tscà la fois, chaque commande en priorité d’arrière-plan. - Deux commandes qui cadrent un audit,
/audit-backendet/audit-frontend: un périmètre, un constat sur la base ou le rendu réels, puis la correction. Elles viennent d’une demande précise : « je ne veux pas décrire le but je veux définir une fonctionnalité, un domaine, un périmètre avec cette commande et corriger/appliquer/améliorer » (22 octobre). - L’orchestration des sessions, chacune dans son worktree, et l’intégration de leur travail sur
main.
Ce qui le prouve : les consignes, les hooks, leur branchement (.claude/settings.json) et les deux commandes sont dans le dépôt depuis le 13 novembre. Seuls la session enregistrée de l’ERP, mes permissions et les worktrees restent sur mon poste. Du 14 octobre au 13 novembre, git les ignorait, donc ce mois-là n’a pas d’historique. Un garde-fou, tel qu’une session le rencontre :
.claude/hooks/no-tests.mjs · lignes 5–11const MESSAGE = `🚫 Tests interdits à l'IA sur ce poste (décision d'Adrien, 12/10/2026).
Adrien lance les tests lui-même, à la main, quand c'est nécessaire : des runs
IA en parallèle ont surchargé son Mac (charge 84 sur 10 cœurs, swap saturé).
Ne lance NI vitest, NI playwright, NI \`pnpm test*\` / \`pnpm e2e*\` / \`pnpm validate\`,
même sur un seul fichier. Écris le code (et les tests demandés) sans les
exécuter, puis donne dans ta réponse la commande exacte qu'Adrien jouera, ciblée
sur les fichiers touchés.`;Validation
Ce qui me revient :
- Les tests. Depuis le 12 octobre, c’est moi qui les lance, à la main, sur les fichiers touchés. L’IA écrit les tests et donne la commande.
- Le rendu réel, à l’usage : « footer logo est immense juste rajouter logo et non le nom » (2 novembre), « c'est trop long » (12 novembre), « site menu sheet je ne veux pas de croix fixed c'est moche » (13 novembre).
- Ce que l’IA affirme, que je mets en doute (section suivante).
S’y ajoute l’outillage que j’ai fait mettre en place : la porte pre-push, qui juge le commit en tête de chaque push sur main dans un worktree détaché (Qualité), et les tests qui lisent le code.
Et certains gestes ne se prouvent pas. Le journal des attestations de la porte consigne quatre suites Postgres déclarées jouées en novembre, et quinze reçus de migration de production sont sur mon poste. Mais tous portent mon utilisateur système, sous lequel tournent aussi mes sessions, donc ils ne distinguent pas mon geste de celui d’un agent.
Comprendre et mettre en doute
Voici ce que les traces montrent, épisode par épisode, avec mes messages tels que je les ai tapés.
Une idée fausse, corrigée par l’IA, puis vérifiée
Le 10 novembre, j’écris : « je ne veux pas que l'erp ai un logiciel de caisse car loi légale oblige je crois un outil externe ? ». L’IA répond, texte de l’administration fiscale à l’appui, que la loi n’impose pas d’outil externe mais une caisse sécurisée et un justificatif, et renvoie un point au comptable. Je lui demande alors : « vérifie l'erp contre les quatre conditions ». Le lendemain, un commit scelle les ventes dès leur premier encaissement et rend les clôtures inaltérables (6327df8f1), et le lien se déduit de l’ordre des faits. Le 13 novembre, j’écris encore : « que faire je ne comprends pas logiciel de caisse ? ». Le choix entre certificat, justificatif et caisse certifiée à côté reste à faire avec le comptable (ADR 0008). Il me revient, pas à l’outil.
Une question qui a changé le produit
Le 26 octobre, je demande : « pourquoi demander à fisher est dans toutes les pages s'il sert juste pour chercher dans le manuel ? », puis « pourquoi ne pas centraliser (déposer un fichier etc) ». La décision datée du même jour fait de Fisher un seul chat, sur chaque page, qui lit les données de l’ERP sous les droits de la personne et reçoit les documents déposés (Fisher).
Exiger la source
Le 12 novembre : « pour les loading tu es sur ? inspecte la documentation next js ». L’IA relit la documentation de Next.js installée dans le dépôt, et corrige un point de sa réponse précédente.
Une question qui ne trouve pas d’erreur
Le 13 novembre : « produits à la une pourquoi product card n'est pas réutilisé ? ». L’IA justifie l’écart : la suite « Aussi à la une » n’a ni la mise en page ni les informations de ProductCard. Mettre en doute ne voulait pas dire avoir raison.
Freiner ce que l’outil produit
Le 3 novembre, j’écris « supprime la sur ingenierie frontend site public », et le 9 novembre « je souhaite éviter une maintenabilité trop lourde pour l'ERP ». Ce second message précède l’état des lieux et le plan d’allègement datés du même jour (git show b3f1e845d2:docs/allegement-erp.md), puis la règle « supprimer avant d’ajouter ».
La maîtrise se vérifie en entretien
Un dépôt montre ce qui a été construit, et ce volume est réel :
- lignes de TypeScript hors tests : routes, modules et code commun des deux applications, sources des paquets
- 408 398
- apps/{erp,site}/{app,modules,shared}, packages/*/src
- lignes de tests : unitaires, sur Postgres, qui lisent le code, de bout en bout
- 381 832
- *.test.ts(x) et *.spec.ts sous apps/ et packages/
La maîtrise, elle, se vérifie en entretien, sans l’IA. Ce que je développe en équipe depuis 2022, hors de ce dépôt, est décrit dans l’étude de cas (Hors de ce projet). Je propose qu’on me demande :
- Suivre une commande du panier à la facture, en disant à chaque pas quelle application écrit quoi, et sous quels droits (Le parcours d’une commande).
- Expliquer pourquoi le site ne peut pas marquer une commande payée, et ce qui l’en empêche dans la base (Sécurité).
- Lire une contrainte
CHECKet son test de refus, et dire ce qu’elle protège (Qualité). - Changer une règle de
packages/domainet prédire ce qui casse. - Défendre un ADR, et dire ce qui me ferait changer d’avis (Décisions).
Ce que j’en retiens
Une décision qui compte doit s’écrire. Quand je donne un critère plutôt qu’une solution (« meilleur choix »), la raison du choix reste dans le rapport de la session. J’en ai tiré une règle : une décision qui compte s’écrit, datée, là où elle s’applique, et les ADR séparent la raison confirmée de l’hypothèse.
L’IA accélère tout, y compris la croissance du code : trente-deux rapports d’audit en huit jours fin août, 605 000 lignes de TypeScript dans l’ERP au 9 novembre, dont 302 000 de tests. Le volume ne prouve pas la qualité, et chaque ajout se paie à chaque retouche. D’où la règle du 9 novembre et ce qui a été retiré depuis août : le journal des décisions, presque toutes les décisions soumises au gérant.
Des décisions prises vite se sont renversées. Le stock est sorti du modèle puis y est revenu le même jour, après un troisième audit (24 août). Le remboursement, sorti de la V1 le 24 août, est aujourd’hui le modèle Refund. Le 29 août, j’ai refusé un historique des étapes de commande (« je ne veux pas de order status event »). Le 5 novembre, quand plus rien ne datait le passage en fabrication, le journal OrderStep est arrivé (2f4e60058c). La quarantaine des nouvelles versions de dépendances, retirée sur ma décision le 29 août, est aujourd’hui d’un jour (minimumReleaseAge, pnpm-workspace.yaml). Couper vite ne coûte presque rien dans le code, mais revenir coûte une migration. J’en garde ceci : demander le besoin avant de couper, comme avant d’ajouter.
Orchestrer l’IA est un métier en soi. Quand mes sessions ont saturé ma machine (charge 84 sur 10 cœurs, mémoire d’échange pleine), j’en ai tiré des règles et des hooks. Ils ont un prix : l’IA ne lance pas les tests, donc un changement peut arriver sans qu’elle les ait joués. La porte du push et mes lancements à la main compensent, mais les parcours de bout en bout restent manuels.
La partie la plus personnelle de mon travail est restée un mois hors du dépôt. Du 14 octobre au 13 novembre, git ignorait mes consignes et mes hooks, alors que plusieurs pages de cette documentation citaient AGENTS.md comme source. Ils sont versionnés depuis, parce que ce qui encadre l’IA doit se relire comme le code qu’elle écrit.
Trois sortes de traces
| Trace | Ce que c’est | Ce qu’elle vaut |
|---|---|---|
| Directe | ce que j’ai tapé moi-même, conservé tel quel : mes messages dans les sessions Claude Code | montre ce que j’ai demandé, refusé ou mis en doute |
| Rapportée | écrite par l’IA au moment des faits : « décision d’Adrien » dans le journal, une consigne, un commentaire du code | date une décision et me l’attribue, mais la rédaction est celle de l’IA, et l’échange qui l’a produite n’est plus conservé avant le 22 octobre |
| Déduite | tirée après coup du code ou de l’ordre des commits, cette page comprise | une hypothèse, donnée comme telle |
Le relevé
Ce relevé daté du 13 novembre 2026 n’est pas revérifié depuis.
| Source | Ce qu’elle montre |
|---|---|
main, 3 076 commits du 23 août au 13 novembre 2026 | 1 188 ont Claude pour auteur : des sessions dans le cloud, du 30 octobre au 9 novembre. Sur mes 1 882 commits, 1 456 portent Co-Authored-By: Claude …. |
| Mes 426 commits sans cette mention | 184 fusions, 39 instantanés wip: de sessions parallèles et 203 autres (70 en août, 131 en septembre, 2 en novembre). |
| Synclune, un projet frère | une copie de ce dépôt devenue boutique de bijoux le 23 septembre, revenue sur main en un seul commit le 14 octobre (72332fcd97, 3 770 fichiers). Ses 24 commits, hors de main, portent tous la mention de Claude. |
| Mes sessions Claude Code, du 22 octobre au 13 novembre | 462 sessions sur mon poste, 818 messages tapés. Les sessions plus anciennes ne sont plus conservées, et celles du cloud n’y figurent pas. |
| L’ancien journal des décisions, du 23 août au 1er septembre | 390 entrées datées : 40 m’attribuent une décision, une demande, un arbitrage ou un refus, 196 s’appuient sur un audit. Rédigé par les sessions, retiré le 1er septembre. |
Les consignes des sessions (AGENTS.md, .claude/) | sept décisions et demandes datées, en vigueur, versionnées depuis le 13 novembre avec les hooks qui les appliquent. git les ignorait depuis le 14 octobre : les décisions de ce mois-là n’ont pas d’historique, et leur date est celle qu’elles portent. |
Ce qui se rejoue depuis le dépôt :
git shortlog -sn HEAD
git log --author=Adrien490 --format='%(trailers:key=Co-Authored-By,valueonly,separator=%x2C)' | grep -c Claude
git show '2fd35cdb09^:docs/decisions.md' | grep -E '^- 2026-' | grep -c Adrien
git log --format='%h %ad %s' --date=short -- AGENTS.md .claude/Les sessions, elles, sont sur mon poste (~/.claude/projects) et ne se rejouent pas depuis le dépôt.
Méthode
- Cette page a été rédigée avec Claude Code, à partir de ce relevé du 13 novembre 2026. Mes messages y sont cités tels que je les ai tapés, fautes comprises.
- Les messages comptés sont ceux que j’ai tapés dans les sessions de mon poste, sans les messages des sous-agents, les modèles de commande ni les sorties d’outils. Un feu vert est un message de quelques mots qui approuve, relance ou fait commiter.
- Les épisodes de la section Comprendre et mettre en doute ont été choisis à la lecture, sans être comptés. Ils montrent ce qui est possible, et ne disent rien d’une fréquence.
- Ce relevé ne juge pas la qualité du logiciel. Les autres pages de la rubrique Preuves en parlent, chacune avec ses sources.