07 - 10 workflows quotidiens#

Dix recettes testees, avec le prompt exact a copier, pour ton travail de dev et de data.

Temps de lecture : 16 min | Niveau : Intermediaire

Ce que tu sauras faire apres#

• Comprendre un depot inconnu en trente minutes au lieu de trois jours.
• Corriger un bug avec une boucle de verification qui se ferme toute seule.
• Mener une grosse refonte sans exploser ton contexte.
• Reprendre une session interrompue et travailler sur plusieurs taches en parallele.
• Appliquer les astuces d'efficacite qui changent le plus de choses.

Le principe qui sous-tend tout#

Une seule contrainte explique presque toutes les bonnes pratiques : la fenetre de contexte se remplit vite, et la qualite baisse quand elle se remplit.

Ton contexte contient toute la conversation : chaque message, chaque fichier lu, chaque sortie de commande. Une seule session de debug peut consommer des dizaines de milliers de tokens. Quand ca se remplit, Claude commence a "oublier" tes premieres instructions.

Trois commandes gerent ca :

Workflow 1 : comprendre un depot inconnu#

Tu arrives sur un projet que tu ne connais pas. Ne lis pas le code au hasard : interroge-le.

Commence par le plan mode (Shift+Tab jusqu'a ⏸ plan mode on), pour etre sur de ne rien casser pendant l'exploration.

donne-moi un apercu de ce depot

explique les patterns d'architecture principaux utilises ici

quels sont les modeles de donnees cles ?

trace le chemin d'une donnee depuis la source brute jusqu'au dashboard

Pose les questions que tu poserais a un collegue senior :

• Comment fonctionne le logging ici ?
• Comment je cree un nouveau modele dbt dans ce projet ?
• Quels cas limites gere la fonction reconcile_paiements ?
• Pourquoi ce code appelle load_batch() et pas load_stream() ligne 143 ?

Template#

Je decouvre ce depot. Reponds dans cet ordre, sans modifier de fichier :
1. A quoi sert ce projet, en trois phrases, en langage metier.
2. Les 5 dossiers les plus importants et ce que chacun contient.
3. Le chemin complet d'une donnee, de [SOURCE] a [DESTINATION].
4. Les trois conventions non evidentes qu'un nouveau doit connaitre.
5. Les trois endroits ou le code semble fragile ou date.

Astuce : termine la session par /init pour figer ce que tu as appris dans un CLAUDE.md.

Workflow 2 : corriger un bug#

La regle d'or : donne a Claude un moyen de verifier son travail. Sans verification, "ca a l'air fini" est le seul signal disponible, et c'est toi qui deviens la boucle de verification.

Le prompt en trois temps#

Symptome : le DAG `dag_ventes` echoue a la tache `transform_commandes` depuis le
deploiement d'hier.

Reproduction : `make test-integration -- tests/integration/test_transform.py`

Erreur exacte :
[COLLER L'ERREUR ENTIERE, PAS UN RESUME]

Fais dans cet ordre :
1. Ecris un test qui reproduit le probleme et montre-moi qu'il echoue.
2. Trouve la cause racine. Ne masque pas l'erreur, corrige la cause.
3. Corrige, relance le test, montre-moi la sortie.

AVANT / APRES#

Pourquoi c'est mieux ? Dans la version APRES, Claude peut lire un resultat pass/fail et iterer tout seul. Dans la version AVANT, il s'arrete des que ca "a l'air bon".

Demande toujours la preuve plutot qu'une affirmation : la sortie du test, la commande lancee et son code retour.

Workflow 3 : ecrire des tests#

trouve les fonctions de src/transform/commandes.py qui ne sont couvertes par aucun test

ajoute des tests pour la fonction reconcile_paiements

ajoute des cas de test pour les conditions limites : montant nul, devise inconnue,
date de paiement anterieure a la date de commande

lance les nouveaux tests et corrige les echecs

Claude examine tes fichiers de test existants pour reprendre ton style, tes frameworks et tes patterns d'assertion. Sois precis sur le comportement a verifier.

Template#

Fichier a couvrir : [CHEMIN_DU_FICHIER]
Framework : [PYTEST / UNITTEST / DBT_TESTS]
Contraintes : [PAS_DE_MOCK / MOCKER_LES_APPELS_RESEAU / FIXTURES_DANS_conftest.py]

1. Liste les fonctions sans test.
2. Pour chacune, propose les cas nominaux ET les cas limites.
3. Ecris les tests en suivant le style de [FICHIER_DE_TEST_EXEMPLE].
4. Lance [COMMANDE_DE_TEST] et corrige jusqu'au vert.

Workflow 4 : faire une revue#

Trois niveaux, du plus rapide au plus complet.

a) La commande integree. Elle relit le diff courant dans un sous-agent frais et renvoie les constats dans ta session.

/code-review

Variantes : /code-review high, /code-review --fix pour appliquer les corrections, /code-review --comment pour poster en commentaires inline sur la PR.

Pour la securite specifiquement :

/security-review

b) Ta propre grille. Utilise une skill personnalisee, comme le /review-sql du fichier 04.

c) La revue adversariale. Un sous-agent, avec un contexte neuf, ne voit que le diff et tes criteres. Il n'est pas biaise par le raisonnement qui a produit le changement.

Utilise un sous-agent pour relire le diff du modele fct_commandes par rapport a PLAN.md.
Verifie que chaque exigence est implementee, que les cas limites listes ont des tests,
et que rien hors perimetre n'a change. Signale les manques, pas les preferences de style.

Attention. Un relecteur a qui tu demandes de trouver des manques en trouvera toujours, meme quand le travail est sain. Poursuivre chaque remarque mene a la sur-ingenierie. Dis-lui de ne signaler que ce qui affecte la correction ou les exigences enoncees.

Workflow 5 : une grosse refonte#

Le piege : lancer "refactorise tout le pipeline" et regarder le contexte exploser.

La methode en quatre phases#

Phase 1 - Explorer, en plan mode.

lis dbt/models/marts/ et src/transform/. Explique-moi comment le calcul de marge est
fait aujourd'hui, et ou la logique est dupliquee.

Phase 2 - Faire ecrire la spec. Pour une grosse fonctionnalite, laisse Claude t'interviewer plutot que d'ecrire la spec toi-meme.

Je veux centraliser le calcul de marge dans une macro dbt unique.
Interviewe-moi en detail avec l'outil AskUserQuestion.

Pose des questions sur l'implementation technique, les cas limites, les risques et les
compromis. Ne pose pas de questions evidentes, creuse les points difficiles auxquels je
n'ai peut-etre pas pense.

Continue jusqu'a avoir tout couvert, puis ecris une spec complete dans SPEC.md.

Phase 3 - Repartir a neuf. Une fois SPEC.md ecrit, fais /clear ou ouvre une nouvelle session. Le contexte est propre et entierement consacre a l'implementation.

Implemente SPEC.md. Commence par la phase 1 de la spec uniquement. Lance
`make test-unit` apres chaque fichier modifie. Arrete-toi et montre-moi le diff avant de
passer a la phase 2.

Phase 4 - Verifier. Relance une revue adversariale (workflow 4).

Les meilleures specs sont autonomes : elles nomment les fichiers et interfaces concernes, disent ce qui est hors perimetre, et se terminent par une etape de verification de bout en bout qui prouve que ca marche.

Workflow 6 : reprendre une session#

Claude Code sauvegarde toutes tes conversations en local.

Nomme tes sessions#

C'est le detail qui change tout quand tu jongles entre trois taches.

Dans le selecteur, quelques raccourcis utiles : Space previsualise le contenu, Ctrl+W elargit a tous les worktrees du depot, Ctrl+A a tous les projets de la machine, Ctrl+B filtre sur la branche Git courante.

Brancher une conversation#

Pour essayer une autre approche sans perdre celle en cours :

/branch essai-avec-vues-materialisees

La conversation est copiee, tu bascules dedans, et l'originale reste intacte dans le selecteur.

Revenir en arriere#

Esc Esc ou /rewind ouvre le menu de rewind. Tu peux restaurer la conversation seule, le code seul, ou les deux.

Limite importante. Les points de sauvegarde ne suivent que les changements faits par les outils d'edition de Claude. Les modifications faites par une commande Bash ou un processus externe ne sont pas capturees. Ce n'est pas un remplacement de Git.

Workflow 7 : utiliser des images et des captures#

Trois facons d'ajouter une image :

1. Glisser-deposer dans la fenetre de Claude Code.
2. Copier l'image puis Ctrl+V, ou Alt+V sur Windows et WSL.
3. Donner le chemin : "Analyse cette image : C:\captures\erreur.png".

Cas d'usage concrets en data :

Voici une capture du dashboard Looker. Le chiffre de marge affiche 14,2 % alors que ma
requete SQL donne 11,8 %. Regarde la definition de la mesure dans
looker/views/commandes.view.lkml et dis-moi d'ou vient l'ecart.

Voici le schema de notre modele en etoile actuel. Comment le modifier pour gerer les
commandes multi-devises ?

Voici la capture de la trace d'erreur Airflow. Quelle en est la cause ?

Quand Claude reference une image (par exemple [Image #1]), fais Ctrl+Clic sur le lien sous Windows pour l'ouvrir dans ta visionneuse.

Workflow 8 : le travail en parallele#

Trois approches, selon le degre de coordination que tu veux gerer toi-meme.

a) Les worktrees Git#

Un worktree, c'est un repertoire de travail separe, avec ses propres fichiers et sa propre branche, qui partage l'historique du depot. Chaque session Claude Code dans son worktree : les editions de l'une ne touchent jamais les fichiers de l'autre.

claude --worktree feature-marge

Par defaut, le worktree est cree sous .claude/worktrees/<nom>/ a la racine du depot, sur une nouvelle branche worktree-<nom>. Relance la commande avec un autre nom dans un second terminal pour une deuxieme session isolee.

Le depot doit avoir au moins un commit : un worktree part d'un commit existant. Sur un depot vide, la commande echoue avec Failed to resolve base branch "HEAD": git rev-parse failed. Ajoute aussi .claude/worktrees/ a ton .gitignore.

Un worktree est un checkout neuf : tes fichiers non suivis comme .env n'y sont pas. Pour les copier automatiquement, cree un fichier .worktreeinclude a la racine du projet, en syntaxe .gitignore :

.env
.env.local
dbt/profiles.yml

Un fichier n'est copie que s'il remplit les deux conditions : il correspond a un motif du fichier, et il est deja ignore par Git. Les fichiers suivis par Git ne sont donc jamais dupliques.

b) Les sous-agents#

Pour de l'exploration, delegue a un sous-agent. Il lit les fichiers dans sa propre fenetre de contexte et ne te renvoie qu'un resume.

Utilise des sous-agents pour investiguer comment notre systeme d'authentification gere
le rafraichissement de token, et si des utilitaires OAuth existent deja que je devrais
reutiliser.

c) Le pattern redacteur / relecteur#

Un contexte neuf ameliore la revue, parce que Claude n'est pas biaise en faveur du code qu'il vient d'ecrire.

Workflow 9 : automatiser en mode non interactif#

claude -p "Explique ce que fait ce projet"

claude -p "Liste tous les endpoints de l'API" --output-format json

Le format json renvoie un seul objet JSON avec un champ result. Le format stream-json imprime un objet JSON par ligne.

Fan-out sur beaucoup de fichiers#

Pour une migration massive, trois etapes :

1. Fais produire la liste des cibles.

liste tous les modeles dbt qui utilisent encore la macro obsolete `old_margin()`
et sauvegarde la liste dans fichiers.txt

2. Boucle avec un script.

for f in $(cat fichiers.txt); do
  claude -p "Dans $f, remplace old_margin() par la nouvelle macro margin(). Reponds OK ou FAIL." \
    --allowedTools "Edit,Bash(dbt compile *)"
done

3. Teste sur deux ou trois fichiers, affine le prompt, puis lance sur tout le lot.

Le drapeau --allowedTools restreint ce que Claude peut faire. C'est essentiel quand tu tournes sans surveillance.

Il existe aussi une commande livree avec Claude Code pour repartir un changement sur plusieurs sous-agents :

/batch remplace old_margin() par margin() dans tous les modeles concernes

/batch decoupe le travail en 5 a 30 unites independantes, te montre le plan, puis lance un sous-agent par unite, chacun dans son propre worktree. Il te faut donc un depot Git.

Workflow 10 : le pipeline Unix#

Claude Code est composable. Branche-le sur tes outils existants.

git log --oneline -20 | claude -p "resume ces 20 derniers commits pour une note de version"

git diff main --name-only | claude -p "relis ces fichiers modifies pour des problemes de securite"

tail -200 airflow/logs/dag_ventes/latest.log | claude -p "identifie la cause de l'echec"

bq query --format=prettyjson "SELECT * FROM dataset.stats LIMIT 50" | claude -p "resume ces chiffres pour un comite de direction"

claude -p "<ton prompt>" --output-format json | ta_commande_suivante

Astuces d'efficacite#

Les cinq pieges les plus courants#

Les gestes qui font gagner du temps#

• Esc des que ca part de travers. Le contexte est preserve, tu rediriges.
• @ pour referencer un fichier plutot que de decrire ou il se trouve. Tape @, puis Tab pour accepter le chemin.
• Utilise les CLI que tu as deja. gh, bq, gcloud, dbt, aws : c'est la facon la plus econome en contexte d'interagir avec un service externe. Claude sait aussi apprendre un outil : "Utilise foo-cli --help pour apprendre cet outil, puis resous A, B, C."
• Pose tes questions de cote avec /btw. La reponse n'entre pas dans l'historique de la conversation, donc ton contexte ne gonfle pas.
• Oriente la compaction. /compact Concentre-toi sur les changements du modele dbt plutot qu'une compaction aveugle.
• Demande la preuve. "Montre-moi la sortie du test" plutot que "est-ce que ca marche ?".

Le meta-prompt a garder sous la main#

TACHE : [CE_QUE_TU_VEUX]
FICHIERS CONCERNES : [CHEMINS, avec @ devant]
EXEMPLE A SUIVRE : [FICHIER_QUI_MONTRE_LE_BON_PATTERN]
CONTRAINTES : [CE_QU_IL_NE_FAUT_PAS_FAIRE]
VERIFICATION : lance [COMMANDE] et montre-moi la sortie
SI CA ECHOUE : corrige et relance, jusqu'a 3 fois, puis arrete-toi et explique

A retenir#

• Le contexte est ta ressource la plus rare : /clear entre les taches, /context pour voir, /compact pour resumer.
• Donne toujours a Claude un moyen de verifier : test, build, capture d'ecran.
• Explorer d'abord, planifier ensuite, coder apres : le plan mode separe les trois.
• Pour une grosse tache : fais ecrire une spec, puis repars dans une session neuve.
• Nomme tes sessions (/rename) et utilise --worktree pour travailler en parallele.
• Alt+V colle une image sous Windows ; les captures d'erreur et de dashboard marchent tres bien.
• Apres deux corrections ratees, /clear et un meilleur prompt battent une longue session polluee.

Sources#

• Claude Code - Common workflows
• Claude Code - Best practices
• Claude Code - Manage sessions
• Claude Code - Run parallel sessions with worktrees
• Claude Code - Choose a permission mode
• Claude Code - Interactive mode
• Claude Code - Commands
• Claude Code - CLI reference
• Claude Code - Checkpointing

Liens verifies le 26 septembre 2026.