Premier repo map avec Claude Code : lire un code existant sans brûler le contexte

Dans un dépôt inconnu, l’erreur n’est pas seulement un mauvais code. L’erreur est de demander une implémentation avant de connaître les entrées, les commandes, les zones risquées et la preuve minimale.

Pourquoi ce modèle compte

Un repo map économise du contexte, mais il sert surtout de note d’exploitation. Vous, un reviewer et la prochaine personne pouvez parler du même dépôt sans refaire l’exploration. Pour un débutant, ce moment relie naturellement PDF gratuit, Setup Guide et consultation.

À lire aussi: À lire aussi 1, À lire aussi 2, À lire aussi 3.

Workflow pratique

Au premier prompt, interdisez les modifications. Faites lire README, package, routes, tests et déploiement. Avant d’exécuter quoi que ce soit, séparez commandes sûres et zones risquées. Choisissez ensuite une tâche courte, vérifiable, sans auth ni paiement.

Kit minimal à copier

Read this repository for orientation only.
Do not edit files yet.
Return:
1. the main app entry points
2. the commands that appear safe to run
3. the files that define content, routes, and tests
4. three small first tasks ranked by verification cost
5. one risk that should block a larger change

repo_map:
  entry_points:
    - package.json
    - src/main.ts
  safe_commands:
    - npm run build
    - npm test
  first_task_rule:
    max_files: 3
    proof_required: true
    avoid_auth_and_billing: true

export function rankFirstTask(task) {
  const risk = task.touchesAuth || task.touchesBilling ? 10 : 0;
  const scope = task.filesChanged * 2;
  const proof = task.hasFastProof ? -3 : 4;
  return risk + scope + proof;
}

Exemples réels

Pour un site Astro, cartographiez src/content, src/pages, BlogPostLayout et la commande de build.
Pour un SaaS, marquez auth, billing et migrations comme zones risquées, puis commencez par README ou tests.
En équipe, résumez le repo map dans CLAUDE.md pour éviter de repartir de zéro.

Checklist opérationnelle

Ce modèle sert pendant le vrai travail Claude Code, pas seulement à la lecture. Quand un article, une page produit ou une demande de consultation change, utilisez cette liste comme contrôle compact.

Écrire l’objectif en une phrase et nommer les fichiers ou fonctions hors scope.
Séparer les fichiers que Claude Code doit lire de ceux qu’il doit éviter.
Garder au moins une commande de preuve. Pour le contenu, voir l’URL publique en plus du build.
Vérifier que PDF gratuit, Gumroad et consultation restent cohérents dans le corps et la CTA finale.
Pour les langues, confirmer title, h1, début du corps et CTA dans la bonne langue.
Ne pas stage les fichiers sales hors sujet. Redécouper le diff avant commit si nécessaire.
Noter le risque restant et la prochaine métrique pour faciliter la session suivante.

Vers quelle offre orienter le lecteur

Si le lecteur manque encore d’aisance avec les commandes, la première sortie est le cheatsheet gratuit. Si le workflow se répète chaque semaine, Prompt Templates standardise review, debug et édition. Si le blocage concerne permissions, CLAUDE.md, hooks, MCP ou CI/CD, le Setup Guide est plus adapté. Si l’équipe doit concevoir ownership, vérification publique et revenu, la consultation devient la meilleure suite.

Ce qu’il faut laisser dans le handoff

Le travail Claude Code ne finit pas quand le patch semble prêt. Il devient utile quand la personne suivante comprend la décision sans rejouer toute la session. Le handoff doit contenir scope modifié, raison du scope, commandes de preuve, URL publique, destination des CTAs et risque restant. Pour le contenu, ajoutez heroImage, liens internes, liens externes, vérification de langue et présence du PDF gratuit, de Gumroad et de la consultation dans le corps. Pour une page proche produit, distinguez lecteur gratuit, acheteur de guide et personne qui doit demander de l’aide.

Chiffres à suivre ensuite

Les PV ne suffisent pas. Après publication, regardez indexation, pays, clics près de la CTA finale, clics Gumroad et visites du formulaire. Pour un article populaire existant, comparez rebond et page suivante avant et après. Si la prochaine session Claude Code reçoit ces chiffres d’abord, elle optimisera le chemin de revenus plutôt que d’écrire plus de texte.

Cas d’échec

Commencer par une feature laisse les changements se répandre avant de connaître les limites.
Sans commandes sûres, on ne sait pas quelle preuve valide le résultat.
Sans carte sauvegardée, la session suivante dépense du contexte pour retrouver la structure.

Chemin PDF gratuit, Gumroad et consultation

Commencez par le PDF gratuit pour stabiliser les commandes. Passez à Gumroad quand le workflow se répète, puis à la consultation si équipe, permissions ou revenus doivent être conçus.

Note de vérification

L’article relie les contenus sur codebase map, gestion du contexte et première tâche, puis ajoute les CTAs PDF gratuit, Gumroad et consultation.