Premier pas en 30 minutes

Un exercice complet sur un petit projet jetable : préparer Kwa, le voir refuser, corriger un vrai bug de bout en bout, livrer. Il vous faut un agent de code avec le plugin Kwa (Avant de commencer), et la GitHub CLI connectée.

1. Créer votre copie du projet

   Le dépôt d'exercice est un modèle : chacun travaille sur sa propre copie, où Kwa ouvrira ses issues et ses pull requests.

   $ gh repo create kwa-demo --template nesyouyou/kwa-demo --private --clone

   $ cd kwa-demo && python3 -m unittest

   Quatre tests passent. Pourtant, avec le code PROMO10, un article à 20 € et un à 10 € coûtent 28 € au lieu de 27 €.

2. Préparer le projet pour Kwa

   Lancez claude dans le projet, puis :

   /kwa:init

   La skill montre ce que Kwa détecte : un projet Python avec du code dans src/, qu'il protège sur main. Acceptez le module verify quand elle le propose. Elle simule, puis n'écrit que de la configuration : aucun script n'est copié, les garde-fous viennent du plugin. Pour la commande de test, elle doit vous proposer d'écrire dans .claude/kwa.policy.json :

   "verify": { "commands": ["python3 -m unittest"] }

   Elle termine par kwa doctor ., qui doit répondre « cible conforme ».

   Committez ensuite cette configuration par une branche, comme tout changement, pour que l'équipe la reçoive. Dans un terminal :

   $ git switch -c chore/kwa && git add -A && git commit -m 'chore: préparer Kwa'

   $ git push -u origin chore/kwa && gh pr create --fill && gh pr merge --merge

   $ git switch main && git pull

3. Voir un garde refuser

   De retour dans la session (ou sous codex, après /hooks), demandez :

   Corrige directement src/panier.py sur main, sans branche.

   L'agent essaie, et le garde l'arrête :

   Kwa — Pas de code sur main : ouvrir d'abord l'issue et sa branche (/kwa:start-dev), puis travailler dans le worktree créé.

   Même chose pour un git commit sur main : « git commit sur main refusé : travailler sur une branche dédiée et ouvrir une PR ». C'est voulu : chaque changement passe par une issue et une branche.

4. Corriger le bug, de bout en bout

   Décrivez le symptôme, pas la solution (sous Codex, une skill s'appelle avec $ au lieu de /) :

   /kwa:debug Avec PROMO10, un article à 20 € et un à 10 € coûtent 28 € au lieu de 27 €.

   Ce que vous devez voir, dans cet ordre :

   • l'agent reproduit le bug et nomme la cause avant de toucher au code ;
   • il ouvre une issue sur votre copie et travaille dans un worktree, sur sa branche (/kwa:start-dev) ;
   • il écrit d'abord un test qui échoue, puis le correctif le plus petit (/kwa:tdd) ;
   • il lance python3 -m unittest et cite le résultat avant de dire « fait » (/kwa:verify).

   S'il saute une étape, demandez-la par son nom (« passe par /kwa:start-dev ») ; dites-le-lui aussi : c'est aussi ce que la mémoire de Kwa retiendra.

5. Livrer

   /kwa:ship

   L'agent vous demande de confirmer le push de la branche, puis ouvre une PR qui commence par Closes # et le numéro de l'issue, avec la sortie des tests comme preuve. La fusion reste votre décision : relisez le diff, puis fusionnez sur GitHub.

6. Capitaliser

   /kwa:learn

   L'agent propose ce qui mérite d'être retenu de la session (un piège, une décision) et l'endroit où l'écrire. Rien n'est écrit sans votre accord.

Pour aller plus loin, le parcours 3 démonte chaque pièce : gardes, hooks, politique et mémoire.