kwa/ workflows
Kwa · Kit de Workflows Agentiques · v

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é

Terminal
$ 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é.
Les workflows

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 →

  1. /kwa:brainstormexplorer, comparer deux ou trois approches, écrire une spec courteSkill
  2. validationvous approuvez la specVous
  3. /kwa:plandécouper en tâches de quelques minutesSkill
  4. guard-writepas de code produit sur mainGarde
  5. /kwa:start-devissue, branche et worktreeSkill
  6. /kwa:agentsun implémenteur par tâcheSkill
  7. /kwa:tdddans chaque implémenteur : un test qui échoue, puis le codeSkill
  8. /kwa:verifyles vérifications du projet, sorties citéesSkill
  9. kwa:reviewerrelit en lecture seuleSous-agent
  10. /kwa:review-feedbacktrier les constats avant d'en appliquer unSkill
  11. pushvous autorisez la publication de la brancheVous
  12. /kwa:shipPR liée à son issue, avec la preuveSkill
  13. fusionvous donnez le feu vertVous
  14. /kwa:learnranger chaque leçon au bon endroitSkill
  15. /kwa:handoffun document de reprise pour la session suivanteRelais
  • Skill
  • Garde
  • Hook
  • Sous-agent
  • Vous
  • Relais
Pourquoi ce projet

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.

Arborescence

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.

Modules

stack-prisma et stack-scaleway n'ajoutent aucun fichier : ils règlent seulement la politique.

Survolez un module pour voir son rôle ; décochez-le pour voir ce qui disparaît.

AGENTS.mdSource unique des instructions de l'agent. Kwa ne gère que son bloc entre marqueurs, le reste est à vous.core
CLAUDE.mdUn simple pointeur vers AGENTS.md.core
.claude/
kwa/
bin/
kwa-hygieneContrôle d'hygiène avant une remise (secrets, noms, mesures datées).client-handoversource
local/
inbox.mdNotes d'apprentissage en attente de /kwa:learn. Local, jamais versionné.memory
journalUne entrée par session : faits git et huit lignes de récit au plus.memory
sessionsDébut et base git de chaque session.memory
signals.jsonlRefus de garde et corrections repérées. Local.memory
kwa.hygiene.allowExceptions datées au contrôle d'hygiène.client-handoversource
kwa.policy.jsonLa politique du projet : modules actifs, commandes interdites, environnements, vérifications. Propriété du projet.core
settings.jsonPropose le plugin Kwa à toute l'équipe (marketplace et plugin activé) ; vos réglages restent.core
.codex/
agents/
kwa-reviewer.tomlL'agent relecteur pour Codex, en bac à sable en lecture seule.craft
rules/
kwa.rulesCe que Codex fait confirmer lui-même : push, fusion, suppressions.core
hooks.jsonLes hooks de Kwa pour Codex, lancés par la commande kwa hook.core
.github/
ISSUE_TEMPLATE/
bug.mdGabarit d'issue : constat, décisions, critères de réussite.issue-flowsource
config.ymlGabarit d'issue : constat, décisions, critères de réussite.issue-flowsource
feature.mdGabarit d'issue : constat, décisions, critères de réussite.issue-flowsource
workflows/
kwa-hygiene.ymlJob CI du contrôle d'hygiène.client-handoversource
pull_request_template.mdGabarit de PR : contexte, changements, vérification, risque.issue-flowsource
  • Skill
  • Garde
  • Hook
  • Règle
  • Outil
  • Configuration
  • Document
  • Local
Démarrer

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.