Kaizen : les agent-skills d'Addy Osmani, tenus par des hooks

Un agent de code accélère tout, y compris les erreurs. Kaizen reprend la méthode d'agent-skills et fait vérifier ses règles critiques par du code dans Claude Code.

Kaizen : les agent-skills d'Addy Osmani, tenus par des hooks
Available in English

Un agent de code écrit vite. Il lui arrive aussi d'oublier les tests ou de pousser une branche que personne n'a relue. Le rapport DORA 2025 l'a mesuré : l'IA augmente le débit des équipes, et leur instabilité avec, sauf chez celles qui gardent des principes clairs, des petits lots et du feedback réel.

Kaizen est le plugin que j'ai écrit pour faire tenir ces disciplines dans Claude Code. Il n'a plus de méthode à lui. Il embarque celle d'Addy Osmani, agent-skills, et s'occupe du reste : ce que les skills demandent à l'agent, les hooks de Kaizen le vérifient.

Mise à jour du 17 novembre 2026. La première version de cet article décrivait Kaizen 3.2.1, qui allait jusqu'au déploiement et au monitoring avec sa propre méthode. Kaizen a depuis été reconstruit : la partie production a été retirée, et la version 1.0.0 du 11 novembre repart d'une base neuve autour d'agent-skills. L'article décrit maintenant la version 1.1.0.

L'essentiel

  • Quoi : Kaizen est un plugin Claude Code open source (MIT) qui embarque les agent-skills d'Addy Osmani et ajoute des contrôles appliqués par du code, une mémoire entre les cycles, le suivi de PR et des métriques.
  • Chiffres clés : version 1.1.0 du 11 novembre 2026, agent-skills 0.6.15 embarqué tel quel, 15 commandes /kaizen:, 4 skills propres, 8 hooks, une CLI Node.js sans dépendance npm.
  • Ce qui le distingue : Claude ne peut pas finir un tour sur des tests rouges, ni commiter un secret, ni pousser une branche sans revue enregistrée à moins que vous ne l'acceptiez.
  • Où il s'arrête : à la pull request prête à merger. Le merge et le déploiement restent à vous.
  • D'où il vient : la méthode d'agent-skills, la boucle d'apprentissage et le suivi de PR du Compound Engineering d'Every, les pratiques de DORA.

Pourquoi agent-skills

En avril, dans ma cartographie SDD, Compound Engineering et BMAD, je me demandais si l'on pouvait combiner la rigueur d'une spec et une boucle d'apprentissage. Les premières versions de Kaizen y répondaient avec leur propre méthode, du besoin jusqu'à la production. Elles faisaient beaucoup, et c'était justement le problème : une méthode de plus à apprendre.

agent-skills couvre déjà la boucle de développement avec peu de cérémonie. Ce sont des fichiers Markdown simples (SPEC.md, tasks/), une skill par sujet, et dans chacune un critère de sortie, une table des excuses à refuser et les preuves à montrer. Le projet tourne déjà dans de nombreux agents. Kaizen l'embarque sans le modifier, le synchronise par pull request et n'ajoute que ce qui manque.

Qui fait quoi

Sujetagent-skillsKaizen
Spec, plan, tâches/kaizen:spec, /kaizen:plan, SPEC.md, tasks/ramène les learnings utiles quand ces fichiers sont écrits
Code et tests/kaizen:build, /kaizen:test, test d'abordporte qualité : pas de fin de tour sur des checks rouges
Revue/kaizen:review sur cinq axes, persona code-reviewerl'enregistre seul et bloque le push d'une branche non relue
Secretsskill security-and-hardeningaucun commit qui contient une clé ou un jeton
Lancement/kaizen:ship, checklist go/no-gorien
PR ouverterien/kaizen:watch la suit jusqu'à « prête »
Mémoirerien/kaizen:learn, relue par les hooks
Mesurerien/kaizen:metrics : DORA approximé, réutilisation des learnings, friction, coût

Les neuf commandes d'agent-skills passent sous le préfixe /kaizen:. Six autres donnent accès à des skills d'agent-skills qui n'avaient pas de commande : ideate, debug, adr, security, doubt et migrate. Les quatre skills propres à Kaizen sont setup, learn, metrics et watch.

Les règles critiques sont des hooks

Écrire « lance les tests avant de terminer » dans CLAUDE.md marche neuf fois sur dix. La dixième, la session est longue, le contexte compacté, et Claude annonce que tout va bien sur une suite rouge. Kaizen place donc ces règles dans des hooks, que Claude Code exécute sans qu'on les demande.

  • En fin de tour, dès que la session a modifié du code, les checks configurés (tests, lint) doivent passer. Au bout de trois blocages, Claude doit dire ce qui reste rouge.
  • Avant un push, une branche non relue est arrêtée. Claude propose d'abord la revue, et vous seul pouvez la laisser partir sans, dans l'invite de Claude Code.
  • Avant un commit, une trentaine de formats de clés et de jetons sont refusés, tout comme --no-verify.
  • Pendant l'écriture, quand SPEC.md ou tasks/ change, ou qu'un fichier visé par un learning est modifié, la leçon revient dans le contexte.

Ces hooks protègent contre l'oubli. Face à un agent malveillant, ils ne suffisent pas : un script intermédiaire permet de les contourner, et la doc du plugin le dit.

Une boucle qui apprend

Kaizen autour d'agent-skills : les commandes d'agent-skills en haut, les hooks de Kaizen en dessous, la PR suivie jusqu'à « prête », le merge laissé à vous, les learnings écrits dans la mémoire du projet et relus par la spec suivante

C'est l'apport du Compound Engineering. Une leçon par fichier dans docs/learnings/, écrite par /kaizen:learn. Pas besoin de penser à la relire : un hook la remet dans le contexte au bon moment. /kaizen:metrics mesure ensuite si la boucle tourne vraiment, avec des métriques DORA approximées depuis git et GitHub, la réutilisation des learnings, la friction et le coût en tokens de chaque fonctionnalité ou correctif.

Le cycle complet tient en quelques commandes : /kaizen:setup une fois par dépôt, puis spec, plan, build, review, ship et watch. Ensuite, vous mergez. Kaizen ne merge jamais.

L'essayer

/plugin marketplace add Lingelo/dojo
/plugin install kaizen@dojo

Il faut Node.js 18 ou plus, git, et gh pour les PR. Dans votre dépôt, /kaizen:setup écrit la configuration, déclare le plugin pour chaque clone et dit quelle commande lancer ensuite. Le code et la doc sont sur GitHub. Pour le fonctionnement des plugins, voir mon article sur les marketplaces Claude Code.

Questions fréquentes

Qu'est-ce que Kaizen pour Claude Code ?
Kaizen est un plugin Claude Code open source (licence MIT) qui embarque les agent-skills d'Addy Osmani et ajoute ce qu'elles ne font pas : des hooks qui bloquent, une mémoire des leçons apprises, le suivi des pull requests et des métriques. La version 1.1.0 date du 11 novembre 2026.
Quel lien entre Kaizen et agent-skills ?
agent-skills, le projet MIT d'Addy Osmani, fournit la méthode : spec, plan, build, test, review, ship, avec des critères de sortie. Kaizen l'embarque sans la modifier, sous le préfixe /kaizen:, et fait vérifier par des hooks ce qu'agent-skills demande à l'agent : tests verts, revue avant push, aucun secret commité.
Comment installer Kaizen ?
Dans Claude Code, ajouter la marketplace avec /plugin marketplace add Lingelo/dojo, puis installer le plugin avec /plugin install kaizen@dojo. Kaizen demande Node.js 18 ou plus et git, plus gh pour les pull requests. Dans un dépôt, on commence par /kaizen:setup.
Kaizen peut-il merger ou déployer en production ?
Non. Kaizen s'arrête à une pull request prête à merger. Le merge, le déploiement et la surveillance de la production restent à l'équipe et à ses propres outils.
Kaizen fonctionne-t-il avec d'autres agents que Claude Code ?
En partie. Les skills d'agent-skills et les learnings sont du Markdown lisible par n'importe quel agent, mais les contrôles de Kaizen (porte qualité, revue enregistrée, relecture des learnings) reposent sur les hooks de Claude Code.