The Claude Code guide for startups

À retenir

1. Règle 1, ce qu'elle dit exactement. « Tout le monde livre » ne signifie pas la disparition de la division du travail : le guide précise que les marketeurs continuent le marketing et les développeurs le développement, et que seul le premier pas — de l'idée au prototype fonctionnel — s'ouvre à tous. Heidi formule le gain comme la suppression du téléphone arabe : idée → PM → designer → ingénieur, où l'essence se perd et où le délai se compte en semaines. Crosby rapporte que ses juristes, étant les utilisateurs, portent les meilleures intuitions produit. Trois mécanismes sont donnés pour rendre ces contributions systémiques plutôt qu'accidentelles : brancher l'outil sur les sources de vérité (MCP, ou CLI matures — gh, kubectl, bq, psql — présentées comme plus économes en tokens), ritualiser la présentation des prototypes (revues trimestrielles chez Clay, canal Slack dédié chez Omni), et partager des skills.
2. La distinction CLAUDE.md / skills, énoncée noir sur blanc. CLAUDE.md par sous-répertoire pour les conventions qui s'appliquent à chaque fois, CLAUDE.md racine pour ce qui ne peut pas changer (architecture, limites de sécurité, non-négociables) ; les skills pour les workflows procéduraux à la demande. Emergent tient un dépôt GitHub de skills comme base de connaissance partagée, avec un arbitrage explicite : « it is ok to live with slightly outdated context files as long as the agent can quickly verify and course correct ».
3. Règle 2 : les agents prennent les 80 % mécaniques. Exemples repris tels quels : chez ClickHouse, presque chaque étape du cycle est devenue une boucle autonome, et deux agents à but unique — réparer les tests instables, trouver la couverture de tests manquante — sont les 2ᵉ et 3ᵉ contributeurs du dépôt. Chez Commure, un ingénieur a mené une initiative de ~13 tickets avec des sous-agents en parallèle, chacun propriétaire d'un ticket et de sa PR. Chez Anthropic, Claude Tag est depuis plusieurs mois le premier répondant d'astreinte sur les échecs CI/CD : compte de service dédié, accès à Datadog ou Grafana, instructions permanentes en markdown versionnées comme du code, et une première analyse publiée en général sous 15 minutes.
4. Règle 3, la boucle de Cainex, transposable hors du codage médical. Un lot est traité par un agent ; des auditeurs relisent dans une application interne où ils voient aussi le raisonnement et commentent les deux ; Claude Code relit ensuite prédictions, corrections et commentaires depuis la base, remonte à la partie des instructions qui a produit l'erreur et la révise contre un jeu d'instructions versionné ; un back-test combine appariement sémantique aux réponses acceptées et un juge posant « Is this a real error or just a different valid path », sur un golden set plus des échantillons aléatoires. La règle qui gouverne tout : corriger le principe, pas l'exemple — la première version encodait le cas particulier et accumulait des rustines, d'où un plafond posé sur le nombre de spécificités qu'un changement peut introduire.
5. Ce qui rend une boucle utilisable. une condition d'arrêt vérifiable par l'agent lui-même. L'exemple donné est l'agent de tests instables, qui relance le test jusqu'au vert. Pour ce qui doit être déterministe, le guide renvoie aux hooks — commandes déclenchées à des points fixes du cycle de vie, exécutées quoi que décide le modèle : bloquer une écriture qui échoue au lint, exiger un test passant avant commit, retirer les secrets avant sortie du bac à sable.
6. Règle 4 : la reconstruction comme régime, pas comme accident. Clay : on construit, on reconstruit, et à la quatrième fois on sait tout ce qu'il faut. Commure ajoute le critère de fin — une reconstruction n'est pas finie quand le nouveau chemin est livré, mais quand l'ancien a disparu — et donne le geste concret : une skill du type « pour chaque feature flag déjà déployé à tous, ouvre une PR qui le supprime avec le code associé », l'ingénieur relisant le résultat. Harvey décrit une re-architecture complète à chaque vague de capacités ; Cognition pose comme mode de vie que ce qui est construit aujourd'hui sera probablement jeté sous six à douze mois. Les git worktrees sont donnés comme ce qui rend cette pratique abordable : v2 à côté de v1, evals sur les deux, fusion seulement si la nouvelle gagne.
7. Règle 5, le volant. construire un agent interne avec Claude Code, l'utiliser en interne, puis le promouvoir en produit client via l'API, le SDK ou les Claude Managed Agents. Deux effets de bord rapportés : Omni dit s'être inspiré de l'approche fichier plutôt qu'embedding pour éviter la complexité d'un pipeline RAG dans son propre produit, et Emergent, dont le constructeur d'applications tourne sur les mêmes modèles, débogue localement pour distinguer un comportement de modèle d'un problème de harnais.
8. ⚠️ Nature du document : contenu d'éditeur, pas étude. Les quatre chiffres de tête sont déclarés par les entreprises interrogées, sans définition de périmètre, de période ni de contrefactuel ; la page ne décrit ni son échantillon ni sa méthode d'entretien, et l'échantillon est par construction constitué de clients satisfaits. La clôture est un appel à rejoindre le programme Claude for Startups. À relire avec [[anthropic-self-service-data-analytics-claude-agentic-stack-2026-06-03]] sur l'analytique en libre-service, citée ici comme le processus le plus fréquemment accéléré, et [[sfeir-code-review-anneau-contraintes-2026-07-30]] sur la revue de code automatisée.