7 fichiers pour construire un produit avec une IA de code (Claude Code, Codex, Gemini CLI) sans qu’elle perde le fil. Tu les remplis en conversation avec ton agent. Ensuite, il les relit à chaque session et les tient à jour.
Gratuit · Licence CC BY 4.0 · v1.0
D’une session à l’autre, ton agent repart de zéro. Il ne sait que ce qui est écrit dans le dossier du projet.
Le même piège revient sur chaque produit que je construis avec une IA de code : un PRD unique, écrit au départ, qui ne bouge plus pendant que le code avance. L’agent finit par coder d’après une version périmée, sans que rien ne le signale ni à lui ni à toi.
La parade tient en une règle : éclater ce document en fichiers vivants, un rôle par fichier.
Un fait, une seule maison.
Chaque fichier commence par son mode d’emploi : à quoi il sert, quand le remplir, comment, quand le mettre à jour. Des exemples tirés de Premier Envol montrent le niveau de détail attendu.
La discovery
Ce qu’il contient
Le problème, la cible, les hypothèses, la métrique d’activation.
Comment tu le remplis
Ton agent t’interviewe.
Le produit
Ce qu’il contient
Pour qui, la personnalité, la voix.
Comment tu le remplis
Interview, ou /impeccable init.
Le design
Ce qu’il contient
Couleurs, polices, composants.
Comment tu le remplis
Interview, ou impeccable.
Le parcours
Ce qu’il contient
Les étapes et le ton, avant le code.
Comment tu le remplis
Interview, puis un challenge.
La carte
Ce qu’il contient
Stack, règles, où est quoi.
Comment tu le remplis
À partir des fichiers 1 à 4, complétée après le premier code.
Le backlog
Ce qu’il contient
Le seul backlog.
Comment tu le remplis
Ton agent le tient à jour.
Les décisions
Ce qu’il contient
Ce qui est tranché, et pourquoi.
Comment tu le remplis
Une entrée à chaque arbitrage.
Télécharge le zip, ou clique sur « Use this template » sur GitHub pour en faire ton propre dépôt.
Claude Code, Codex, Gemini CLI ou Cursor.
Lis DEMARRER.md et lance-toi.Ton agent t’interviewe et remplit les 7 fichiers avec toi, un par un. Prévois une soirée, ou avance en plusieurs fois : tout ce qui est validé reste dans les fichiers. Si tu es pressé, ajoute « en mode express » à la phrase.
Claude.ai, ChatGPT, Gemini
Joins les fichiers du pack à la conversation et écris la même phrase. L’assistant te rend chaque fichier rempli, que tu recopies dans ton dossier. Le jour où tu passes à un agent de code, tout est déjà prêt.
Ton dépôt actuel
Copie les fichiers dans ton dépôt sans écraser un AGENTS.md ou un CLAUDE.md existant : fusionne-les plutôt. Puis écris :
Lis DEMARRER.md. Le projet existe déjà : pars du code et des docs, puis interviewe-moi sur ce qui manque.AGENTS.md est la carte du projet, au format standard que lisent Codex, Cursor et la plupart des agents. CLAUDE.md et GEMINI.md tiennent en une ligne qui l’importe : tu modifies la carte à un endroit, tous tes outils la voient.
Dans le webinar du 6 octobre, la carte s’appelait CLAUDE.md. Dans le pack, elle s’appelle AGENTS.md, et CLAUDE.md l’importe.
AGENTS.mdCLAUDE.md, qui importe AGENTS.mdGEMINI.md, qui importe AGENTS.mdAGENTS.mdEn fin de session, l’agent met à jour le bon fichier : la table « Contrat de maintenance » d’AGENTS.md lui dit lequel. Si rien n’a bougé, il ne touche à rien.
docs/now.mddocs/decisions.md, une entrée DEC-xxdocs/parcours.mdPRODUCT.md, et docs/discovery.md si la cible ou le problème bougentDESIGN.mdAGENTS.mdUn hook rappelle à l’agent de mettre la doc à jour s’il a modifié du code sans y toucher (.claude/hooks/doc-reminder.sh, il a besoin de git). Les versions pour Gemini CLI et Codex arrivent dans la prochaine mise à jour du pack.
Ta part : relire docs/now.md une fois par semaine, et docs/decisions.md quand un agent propose de revenir sur un choix.
Premier Envol est un guide web gratuit qui aide les futurs parents à faire garder leur enfant. Un side-project que j’ai construit avec Claude Code et lancé en juin 2026.
Le pack rassemble la méthode qui a tenu, dans l’ordre où je la reprendrais si je repartais de zéro.
pour faire tourner la V1, une fois le parcours écrit
visiteurs de juin à septembre 2026
personnes ont validé au moins une étape du guide sur la même période
Le retour d’expérience complet, en webinar
Webinar Maestro · 6 octobre 2026Product Builder x IA : construire et lancer un produit de A à Z en soloVoir le replay (nouvel onglet)Tip 1
Pour Premier Envol, un spike d’une journée a montré que la donnée au cœur de l’idée de départ n’existait nulle part. Le produit a changé de cap avant la première ligne de code.
Tip 2
PRODUCT.md, DESIGN.md, et le skill impeccable pour critiquer chaque écran important. Ça évite le design « fait par une IA » qui se repère en deux secondes : la police Inter partout, des dégradés violets.
Tip 3
Branche ta métrique d’activation dès le jour 1, puis lis-la canal par canal : tu sauras où mettre ton temps.
Et après : le niveau 2
Quand le produit vit, certains fichiers se dédoublent. discovery.md devient strategy.md, le pourquoi qui change rarement. Chaque grosse feature reçoit sa spec. Des règles par zone (SEO, mesure, paiement) ne se chargent que quand l’agent touche les fichiers concernés, et un CHANGELOG se génère depuis les commits.
Ce sera la v2 du pack.
15 ans de Product, ex Head of Product chez Smallable, fondateur de Track Record : des Product Managers, Builders et Ops freelance choisis sur leur palmarès.
Suivre sur LinkedIn (nouvel onglet)PM et Product Builders freelance
Chez Track Record, chaque candidat traite un cas réel devant moi, y compris ce qu’il confie à l’IA. Ceux qui vont au bout deviennent des finishers, moins de 10 % des candidatures. Si ce pack ressemble à ta façon de travailler, écris-moi.
Heads of Product
Track Record place des Product Managers, Builders et Ops freelance seniors, évalués sur un cas réel par un PM. Tu reçois 2 à 3 profils sous 72 h.
Récupère le pack, ouvre le dossier dans ton outil et écris : « Lis DEMARRER.md et lance-toi. »
Contact : florian@trackrecord.pm