Carte d’onboarding de dépôt pour Claude Code: choisir la première tâche sûre

Le premier jour dans un dépôt existant détermine si Claude Code aide vraiment ou ajoute du bruit. Dire “regarde tout et améliore” paraît efficace, mais cache le périmètre, le risque et la définition de fini.

Ce guide transforme les 30 premières minutes en carte d’onboarding. Ce n’est pas une grosse architecture, mais la carte minimale pour choisir une première tâche utile et sûre.

À lire aussi: claude-code-getting-started-complete, claude-code-existing-codebase-map, claude-code-first-30-minutes-checklist. La base d’installation officielle est Anthropic Claude Code getting started.

Pourquoi le faire avant la première commande

Le centre de ce sujet est ordre de lecture, zones protégées, première modification et preuves. Claude Code peut avancer vite, mais si la première entrée est trop large, les petits diffs, les anciennes hypothèses et le formatage sans impact revenu peuvent peser autant que le vrai travail.

Pour développeurs débutants à intermédiaires entrant dans un code existant, l’objectif n’est pas de grossir la tâche. Il faut dire quoi lire, quoi ne pas toucher, quoi essayer d’abord et où revenir si cela échoue. Cela vaut pour les opérations contenu comme pour le produit.

Workflow pratique

1. Lire seulement README, package.json et une route principale
2. Écrire les zones protégées avant toute proposition
3. Choisir une tâche réversible comme texte, CTA ou nom de test
4. Définir la preuve avec build, diff et URL publique

Cet ordre transforme la demande de “réfléchis librement” en “travaille dans cette limite et laisse une preuve”. Claude Code garde de la marge pour raisonner, mais les zones dangereuses sont fermées avant la première modification.

Situation	Action sûre	Preuve à garder
Site de contenu	Améliorer seulement le CTA final d’un article populaire et vérifier Gumroad	build, diff, URL
SaaS	Clarifier le texte des réglages sans toucher à la facturation	build, diff, URL
Outil interne	Renommer une colonne CSV et tester avec des données exemple	build, diff, URL

Avec cette preuve, Claude Code est jugé sur un résultat visible et non sur une phrase confiante.

Prompt et code à copier

Fais l’onboarding de ce dépôt pour une première tâche Claude Code. Lis seulement README, package.json et les routes principales. Retourne les zones protégées, la plus petite tâche utile et les commandes de preuve. Ne modifie rien encore.

const repoMap = {
  goal: "find one safe first task",
  readFirst: ["README.md", "package.json", "src/routes/"],
  protectedAreas: [".env", "billing/", "migrations/", "wrangler.toml"],
  firstTask: "improve one article CTA without touching payment code",
  proofCommands: ["npm.cmd run build", "git diff --stat"],
};

function readyForClaudeCode(map) {
  return map.readFirst.length >= 2 &&
    map.protectedAreas.length > 0 &&
    map.proofCommands.some((command) => command.includes("build"));
}

console.log({ ready: readyForClaudeCode(repoMap), firstTask: repoMap.firstTask });

Le code est une petite vérification. Dans un vrai projet, collez la sortie dans CLAUDE.md, une issue ou une note de handoff pour réutiliser le même jugement à la session suivante.

Exemples réels et échecs

Situation	Action sûre	Preuve à garder
Site de contenu	Améliorer seulement le CTA final d’un article populaire et vérifier Gumroad	build, diff, URL
SaaS	Clarifier le texte des réglages sans toucher à la facturation	build, diff, URL
Outil interne	Renommer une colonne CSV et tester avec des données exemple	build, diff, URL

• Lire tout le dépôt au départ gaspille du temps sur du formatage faible.
• Sans zones protégées, paiement, auth et déploiement semblent éditables.
• Sans preuve, l’humain doit deviner si la note de fin est vraie.

Le point commun des échecs n’est pas le manque de capacité de Claude Code. La frontière d’entrée était trop fine. Quand la frontière est fine, l’assistant élargit la tâche pour aider. Pour un article monétisé, choisir entre PDF gratuit, Gumroad et consultation fait partie de cette frontière.

Relier le lecteur au PDF, à Gumroad et à la consultation

Si les commandes de base restent floues, commencez par le cheatsheet gratuit. Si le blocage concerne setup, permissions, CLAUDE.md, MCP ou CI, le prochain achat logique est le Setup Guide. Pour des prompts de review, debug ou refactor répétés, utilisez 50 Prompt Templates. Pour un déploiement d’équipe ou un chemin de revenus, passez à la consultation. La comparaison des produits commence sur products.

Un CTA ne doit pas apparaître seulement à la fin. Près de l’introduction, le PDF gratuit réduit la friction. Après des exemples, Gumroad est logique. Quand le sujet touche équipe ou production, la consultation devient l’étape naturelle.

Chiffres à suivre après publication

Ensuite, suivre les clics PDF gratuit, Setup Guide et les visites /en/training/ depuis ce slug.

Après publication, séparez PV, lecture du début, clics internes, inscriptions PDF gratuit, clics Gumroad et visites consultation. HTTP 200 ne suffit pas. h1, canonical, heroImage, CTA et corps localisé doivent mener à la même action.