Partie 7 — Automatiser avec les hooks
⏱️ TL;DR — Un hook est un script que le harness de Claude Code lance automatiquement sur un événement (avant/après un outil, à l’arrêt…). C’est la seule brique qui garantit un comportement « à chaque fois » — parce que ce n’est pas le modèle qui décide, c’est la machine. On s’en sert pour rendre mécanique ce qu’on répétait à la main : formater, linter, tester, et poser des garde-fous (bloquer une édition interdite, un commit sur
main). On équipe TaskFlow pour que « les tests passent » devienne une garantie, pas un espoir.
Le problème qu’on résout
Depuis le début, on a écrit des règles « lance les tests avant de conclure », « formate après édition », en sachant qu’un jour l’agent les oublierait (le CLAUDE.md est du texte, pas une garantie — 3.3). Les hooks ferment cette faille : ils transforment une intention en automatisme garanti. C’est la couche « imposer » du modèle en couches, portée par le harness.
Ce que vous saurez faire à la fin de cette partie
- Expliquer ce qu’est un hook, ses événements, et pourquoi il est déterministe.
- Écrire les hooks utiles du quotidien (format, lint, test).
- Poser des garde-fous qui bloquent les actions dangereuses.
- Équiper TaskFlow d’une chaîne de hooks qui garantit la qualité minimale.
Les chapitres
| # | Chapitre | En un mot |
|---|---|---|
| 7.1 | Anatomie d’un hook | Événements, matcher, commande, blocage. |
| 7.2 | Les hooks utiles | Format, lint, test : les recettes de base. |
| 7.3 | Garde-fous & sécurité | Bloquer l’interdit et le dangereux. |
| 7.4 | Atelier : les hooks de TaskFlow | La chaîne complète, en pratique. |
On commence : Anatomie d’un hook.