Chargement

Le mode plan de Claude Code comme point de départ par défaut

Leçon 46 min

Les ingénieurs démarrent les sessions Claude Code en mode plan, donnent à Claude le fichier spec.md approuvé issu de l'Étape 2 : Conception, et le laissent les interroger, en itérant sur le plan jusqu'à ce qu'ils en soient satisfaits.

Ce qui change

TraditionnelFondé sur l'IA
Un ingénieur lit la conception et commence à écrire du code. La manière dont la modification sera effectuée, jusqu'aux fichiers et aux tests concernés, reste dans la tête de l'ingénieur ou, au mieux, dans un commentaire de ticket. Personne d'autre ne peut la relire. La première chose qu'un relecteur voit est le diff terminé, et à ce stade, les corrections sont lentes.Le travail commence par un plan écrit que Claude produit en mode plan, où il peut lire la base de code sans rien modifier. L'ingénieur corrige le plan avant que le code ne soit écrit, et la version approuvée est validée sous forme de plan.md, afin que les étapes suivantes puissent s'y référer.

Pour commencer

  • Prérequis : l'artéfact d'intention (intent.md ou spec.md) s'il en existe un, et le fichier CLAUDE.md est utile.
  • Infrastructure : Claude Code avec accès au dépôt.

Comment l'exécuter

  1. L'ingénieur démarre la session en mode plan avec Claude.
  2. L'ingénieur donne à Claude les fichiers intent.md et spec.md et demande un plan de mise en œuvre qui nomme les fichiers modifiés, l'ordre du travail, et les tests qui le prouvent.
  3. Interrogez le plan en demandant ce que la modification pourrait casser, quelle étape est la plus risquée, et quelles autres options Claude a choisi de ne pas retenir.
  4. Itérez jusqu'à ce qu'un ingénieur n'ayant jamais vu la conversation puisse mettre en œuvre la modification à partir du seul plan.
  5. Validez le plan approuvé sous forme de plan.md. Le plan rejoint la piste d'audit, et la pratique de revue de PR (Étape 5 : Déploiement) vérifie le diff final par rapport à celui-ci.
  6. Acceptez le plan et laissez Claude le mettre en œuvre. Avec un plan solide, la mise en œuvre se fait souvent en une seule passe.
  7. Lorsque la mise en œuvre s'écarte du plan, mettez à jour plan.md dans le même commit. Envisagez d'utiliser un hook pour imposer la synchronisation entre les deux.

À quoi cela ressemble

Le plan ci-dessous concerne une modification chez un assureur : un panneau dans le portail client qui affiche le statut d'une réclamation. Le panneau appelle le backend du portail, claims-api, qui lit les données de claims-core, un système interne plus ancien.

plan.md :

markdown
# Plan: claims status self-service (from intent.md and spec.md)

## Files that change

portal/src/claims/StatusPanel.tsx (new), claims-api/routes/status.py, claims-api/tests/test_status.py

## Order of work

1. Add the status endpoint behind existing auth (R1, R2, R3).
2. Panel against the endpoint, with the 60-second cache (R1, R4).
3. Wire into the portal nav.

## Risks

The claims-core API rate-limits at 50 rps; the panel must cache (spec concern 3).

## Proof

test_status.py covers the four claim states (R2) and fails on any extra field (R3); screenshot matches the approved mock.

R1 à R4 sont les exigences numérotées dans spec.md, et la préoccupation 3 est un risque signalé par spec.md. Comme le plan les cite, un relecteur peut vérifier le plan par rapport au spec ligne par ligne.

Considérations de gouvernance

La revue de conception a lieu avant la génération de tout code, lorsque changer de cap relève encore de la simple modification d'un document. Le mode plan impose cela de lui-même, puisque Claude ne peut pas modifier de fichiers tant que l'ingénieur n'a pas accepté le plan. Le plan et ses révisions sont consignés avec la mention de qui l'a accepté. Les modifications courantes sont approuvées par l'ingénieur, et tout ce que l'organisation classe comme étant à risque plus élevé est transmis à un responsable technique ou un architecte.

Comment le mesurer

  • Indicateur avancé : la part des modifications fusionnées dès la première passe de mise en œuvre, et le temps écoulé entre l'approbation du plan et la fusion de la PR, avec les données requises dans les métadonnées de la PR.
  • Indicateur retardé : le nombre de cycles de reprise par modification, là encore à partir des métadonnées de la PR, et la fréquence à laquelle le diff fusionné correspond encore au plan.md validé.

Claude Code en mode automatique

Claude Code peut également s'exécuter en mode automatique, où l'ingénieur itère sur le plan et l'approuve, puis Claude applique chaque modification sans invite à chaque édition. À mesure que les garde-fous issus des pratiques ultérieures arrivent à maturité (un CLAUDE.md bien ajusté, des Skills qui encodent les politiques, des hooks qui bloquent les actions dangereuses, et une suite de tests que Claude peut exécuter), le mode automatique devient la norme par défaut pour le travail courant : un spec.md précis, un rayon d'impact réduit, et du code déjà couvert par les tests.

Le changement s'opère désormais en s'éloignant de l'utilisateur qui observe l'agent effectuer les modifications et relit les actions, vers la relecture des artéfacts après des sessions autonomes plus longues. Le mode automatique permet en outre une parallélisation accrue entre les individus et l'équipe lorsqu'il est utilisé avec des worktrees, et il est fondamental pour exécuter le SDLC de manière autonome et boucler la boucle, comme décrit dans l'Étape 6 : Maintenance.

Systèmes existants et source de vérité

Les processus SDLC existants suivent probablement déjà les artéfacts, simplement pas dans des fichiers Markdown. Les éléments de travail peuvent se trouver dans Jira, les exigences dans un outil doté d'une traçabilité réglementaire intégrée, les conceptions dans Figma, et les approbations de modification auprès d'un comité de changement. Ces systèmes sont difficiles à remplacer car les auditeurs et les régulateurs les acceptent déjà, et d'autres équipes en dépendent, de sorte que le SDLC fondé sur l'IA doit s'intégrer à l'existant. Pour chaque artéfact que le processus produit, un système doit être désigné comme la source de vérité, les autres conservant une copie ou un lien.

Vous pouvez mettre en place les configurations ci-dessous pour disposer d'une seule source de vérité, le choix pouvant différer selon l'artéfact :

  • Le dépôt comme source de vérité. Les artéfacts Markdown constituent l'enregistrement faisant autorité, et le système existant référence les fichiers au sein des commits. Il peut s'agir de l'une des configurations les plus nettes pour les organisations pilotées par l'ingénierie, puisque tous les enregistrements résident dans un seul outil disposant d'une seule autorité d'horodatage.
  • Le système existant fait foi. Jira, ServiceNow, ou l'outil de gestion des exigences détient l'enregistrement faisant autorité, et les artéfacts Markdown sont des copies de travail. Claude lit l'enregistrement au début de la session et réécrit le résultat via un connecteur Model Context Protocol (MCP), au cours de la même session que celle qui a produit le spec ou le plan.
  • La liaison comme exigence minimale. Tous les artéfacts mentionnent l'identifiant de l'enregistrement, et tous les enregistrements existants contiennent le SHA du commit du fichier Markdown. L'option de liaison est un bon point de départ lors de la transition vers le SDLC fondé sur l'IA, puisqu'il existe alors deux sources de vérité.

Le système existant et le système fondé sur l'IA privilégiant le Markdown peuvent coexister, à condition qu'il existe un lien entre les deux ou que l'un soit déclaré source de vérité.