Carte d'un codebase existant avec Claude Code: lire, corriger et vérifier en 45 minutes

Pourquoi ce workflow compte

Claude Code est souvent plus utile sur un codebase existant que sur un projet vide, mais la première session est aussi plus risquée. Une demande de refonte globale produit un diff difficile à relire. Le meilleur départ est une carte: points d’entrée, zones sûres, zones risquées et petite correction vérifiable aujourd’hui.

Pour compléter le contexte, lisez aussi le guide de démarrage Claude Code, harness engineering, le guide des permissions.

Le workflow pratique

Le cycle de 45 minutes: état, carte des fichiers, correction limitée, commande de preuve et note de handoff. Pour un site de contenu, la carte doit aussi contenir PDF gratuit, produit Gumroad et CTA de consultation.

Kit minimal à copier-coller

git status --short
rg --files | Select-Object -First 80
rg "TODO|FIXME|console\.log|throw new Error" -n site src scripts
cd site
npm.cmd run build

# CLAUDE.md

## Existing-codebase map
- entry points: site/src/pages, site/src/layouts, site/src/lib
- safe first task: update one CTA or one article
- risky areas: auth, billing, deploy scripts, secrets

## Definition of done
- small diff
- one proof command
- public URL or local preview checked
- next step written down

Read this repository as an existing codebase.
Return:
1. the three most important entry points
2. the safest first patch under 45 minutes
3. files that should not be touched today
4. the proof command
5. the handoff note format

Trois cas d’usage réels

• Améliorer seulement le CTA de fin d’un article et vérifier le chemin du PDF gratuit.
• Ajouter commandes sûres, zones interdites et critères de fin dans CLAUDE.md.
• Ajouter un lien interne d’un article populaire vers les produits puis vérifier h1 et CTA sur l’URL publique.

Échecs fréquents et évitement

L’échec fréquent est de commencer par ‘refactorise tout le projet’. Claude Code peut proposer des changements plausibles, mais trop larges pour être fiables. Démarrez avec un fichier, un chemin et une commande de preuve.

Chemin PDF gratuit, Gumroad et consultation

Utilisez le cheatsheet gratuit tant que le workflow est nouveau. Passez au Setup Guide pour CLAUDE.md, hooks, permissions et règles d’équipe. Réservez une consultation si l’adoption ou le chemin de revenus demande une décision.

• Cheatsheet gratuit Claude Code
• Templates de prompts Claude Code
• Guide de configuration Claude Code
• Produits
• Consultation

Commencez par le cheatsheet gratuit, achetez le guide Gumroad quand le workflow devient répétable, puis réservez une consultation si le déploiement ou la conversion coûte cher à deviner.

Ce que j’ai vérifié pour cet article

J’ai séparé commandes PowerShell, fragment CLAUDE.md et checklist CTA afin que le workflow reste copiable dans un vrai dépôt.