Un kit de workflows agentiques pour le développement
Un socle de process de développement pour travailler avec des agents de code : règles, garde-fous, skills, mémoire et workflow, les mêmes sur chaque projet. Ce qui change d'un projet à l'autre tient dans un fichier de politique.
Workflow agentique : un enchaînement d'étapes proposé à l'agent. Il choisit comment avancer, mais les gardes imposent les points de passage : pas de code sur main, pas de PR sans issue, pas de fusion sans preuve. Ce qui est imposé, ce qui est suggéré
$ kwa init ./mon-projet --dry-run modules : core, craft, memory, issue-flow, verify, stack-prisma, stack-expo politique : créée à partir de la détection git : rien n'a été ajouté, commité ni poussé.
Cinq workflows agentiques
Chacun enchaîne des skills, des gardes, des hooks et des agents, et garde vos décisions aux bons endroits. Choisissez un workflow pour voir ses étapes.
De l'idée floue à une PR prouvée. Voir en détail →
- /kwa:brainstormexplorer, comparer deux ou trois approches, écrire une spec courteSkill
- validationvous approuvez la specVous
- /kwa:plandécouper en tâches de quelques minutesSkill
- guard-writepas de code produit sur mainGarde
- /kwa:start-devissue, branche et worktreeSkill
- /kwa:agentsun implémenteur par tâcheSkill
- /kwa:tdddans chaque implémenteur : un test qui échoue, puis le codeSkill
- /kwa:verifyles vérifications du projet, sorties citéesSkill
- kwa:reviewerrelit en lecture seuleSous-agent
- /kwa:review-feedbacktrier les constats avant d'en appliquer unSkill
- pushvous autorisez la publication de la brancheVous
- /kwa:shipPR liée à son issue, avec la preuveSkill
- fusionvous donnez le feu vertVous
- /kwa:learnranger chaque leçon au bon endroitSkill
- /kwa:handoffun document de reprise pour la session suivanteRelais
Pas de correctif avant la cause. Voir en détail →
- /kwa:debugreproduire, remonter à la cause racineSkill
- causevous validez la cause avant tout correctifVous
- /kwa:start-devissue du bug et branche dédiéeSkill
- /kwa:tddun test rouge qui montre le bugSkill
- /kwa:simplele correctif le plus petit possibleSkill
- verify-stoprefuse de rendre la main sur du rouge, s'il est activé (KWA_STOP_VERIFY=1)Hook
- /kwa:verifyle test repasse au rouge sans le correctifSkill
- /kwa:commitun commit qui dit pourquoiSkill
- guard-githubune PR se rattache à son issueGarde
- /kwa:shipla PR, avec la preuveSkill
- /kwa:learnle piège rangé pour la suiteSkill
Un regard neuf qui ne peut rien modifier. Voir en détail →
- /kwa:reviewrassembler le diff, la demande et ses critèresSkill
- kwa:reviewerun regard neuf, en lecture seuleSous-agent
- readonly-bashle relecteur ne peut rien modifierHook
- /kwa:review-feedbacktrier les constats avant d'en appliquer unSkill
- /kwa:tddcorriger les constats retenus, test d'abordSkill
- /kwa:verifyles vérifications repassentSkill
- décisionvous jugez que c'est prêtVous
Chaque publication est une décision. Voir en détail →
- /kwa:verifyvérifications du projet, sorties citéesSkill
- /kwa:commitun commit par changement logiqueSkill
- guard-gitpas de push sur mainGarde
- pushvous autorisez la publication de la brancheVous
- guard-githubpas de fusion sans preuveGarde
- fusionvous donnez le feu vertVous
- /kwa:deploypré-vol, déploiement, vérificationSkill
- /kwa:learnce que le déploiement a apprisSkill
Chaque session enrichit la suivante. Voir en détail →
- memory-contextau démarrage, la reprise de la session précédenteHook
- signal-promptnote vos corrections et vos « retiens : »Hook
- guard-writeun refus devient un signal d'apprentissageGarde
- memory-nudgepropose de faire le point, une fois par sessionHook
- /kwa:learnrange chaque leçon au bon endroitSkill
- accordrien n'est écrit sans vousVous
- /kwa:handoffun document de reprise pour la session suivanteRelais
- Skill
- Garde
- Hook
- Sous-agent
- Vous
- Relais
Un support pédagogique, en français
Kwa montre, avec de vrais fichiers qui tournent, comment encadrer un agent de code. Il est fait pour apprendre et pour partager, avant d'être fait pour être installé.
Apprendre
Chaque pièce est lisible, testée et expliquée : règles, garde-fous, skills, mémoire. Trois parcours de formation vont de la culture de l'IA générative au harness.
En français
Presque tout ce qui existe sur le sujet est en anglais. Les skills, les règles et la documentation sont ici en français, pour celles et ceux que l'anglais freine.
Partager
Des bonnes pratiques issues de l'usage et d'idées reprises à d'autres projets, toujours créditées. Les retours et les corrections sont bienvenus.
Ce que Kwa ajoute, et où
Votre projet ne reçoit que de la configuration ; skills, gardes et hooks vivent dans le plugin, installé une fois par machine. Ouvrez un dossier pour voir ce qu'il contient. Chaque ligne renvoie à son code source ; les skills et les gardes renvoient aussi à la carte. Décochez un module pour voir ce qui disparaît.
Survolez un module pour voir son rôle ; décochez-le pour voir ce qui disparaît.
.claude/
kwa/
bin/
local/
.codex/
agents/
rules/
.github/
ISSUE_TEMPLATE/
workflows/
skills/
agents/
agent-docs/
architecture/
audit/
brainstorm/
commit/
conflicts/
debug/
deploy/
domain/
execute/
handoff/
humanize/
init/
interview/
learn/
parallel/
plan/
prototype/
questionnaire/
rephrase/
research/
review/
ship/
simple/
start-dev/
tdd/
teach/
testflight/
tickets/
agents/
core/
bin/
hooks/
rules/
templates/
- Skill
- Garde
- Hook
- Règle
- Outil
- Configuration
- Document
- Local
Trois étapes
Le plugin s'installe une fois par machine ; le projet ne reçoit que sa configuration, que vous committez comme tout changement. Pas encore d'agent de code, ou besoin du détail : Avant de commencer.