Quand alléger
Ce que Kwa coûte, et quand l'alléger
Issue, branche, preuve et PR pour chaque changement : c'est le bon réglage pour une équipe et un code qui part en production. Pour un essai, une retouche d'une ligne ou un dépôt personnel, c'est souvent trop. Le processus est un réglage de la politique, pas un dogme.
Ce que ça coûte
| Moment | Ce que Kwa ajoute | Mesure |
|---|---|---|
| Chaque session | Le rappel de routage, les règles communes et la reprise de mémoire, injectés au démarrage | Environ 5 700 caractères, soit de l'ordre de 1 500 à 2 000 jetons (estimation) |
| Chaque commande shell | Six gardes, que Claude Code lance en parallèle | Environ 0,12 s par garde (médiane) |
| Chaque écriture de fichier | Un garde avant, le formatage après (module verify) | Le temps du formateur du projet |
| Chaque fin de réponse | L'invitation à capitaliser (une fois par session) ; verify-stop s'il est activé | Le temps des vérifications du projet, si activé |
/kwa:agents | Par tâche : un implémenteur et deux relectures, puis une relecture finale de la branche | Le poste le plus coûteux en jetons : à réserver aux plans longs |
Mesuré le 13 octobre 2026 avec Kwa 0.2.2, sur un Mac de développement, dans un projet jetable préparé par kwa init. Les hooks d'un même événement tournent en parallèle (documentation des hooks). Le coût en jetons d'un premier pas complet n'est pas encore mesuré.
Alléger selon la situation
| Situation | Réglage |
|---|---|
| Un essai jetable, une exploration | Un dossier sans .claude/kwa.policy.json : les hooks du plugin n'y font rien |
Une exception ponctuelle sur main | Lancer la session avec KWA_ALLOW_MAIN=1 claude. La variable est lue dans l'environnement des hooks : un préfixe devant une commande de l'agent ne suffit pas |
| Une branche sans issue | kwa start <type> <slug> "<titre>" --no-issue, ou flow.auto_issue: false dans la politique |
| Un dépôt personnel, sans issues | flow.issue_required: false : guard-github n'exige plus « Closes #N » |
| Une PR sans preuve à joindre | flow.proof_required_for_merge: false |
GitLab, Bitbucket, pas de gh | Retirer le module issue-flow de modules dans la politique ; le reste fonctionne sans GitHub |
| Moins d'interruptions | KWA_MEMORY_NUDGE=0 (pas d'invitation à capitaliser), KWA_JOURNAL=0 (pas de journal de session) |
| Un petit plan | /kwa:execute dans la session plutôt que /kwa:agents et ses sous-agents |
Alléger le processus ne retire pas les gardes de sécurité (secrets, suppressions, force-push) : ils restent actifs tant que la politique existe. Voir Ce qui est imposé, ce qui est suggéré.