Glossaire

ADR

Une note courte qui consigne une décision d'architecture durable : le contexte, le choix, la raison.

Agent

Un modèle de langage qui reçoit un objectif et travaille en boucle : il réfléchit, utilise un outil (lire un fichier, lancer une commande), lit le résultat, puis continue ou s'arrête.

Dans Kwa : Claude Code et Codex sont des agents de code ; Kwa les encadre.

Bac à sable

Un environnement isolé où les commandes de l'agent ne peuvent pas tout toucher (fichiers, réseau).

Branche

Une ligne de travail parallèle dans git. On travaille sur une branche, jamais directement sur main.

Commit

Un enregistrement d'un changement dans l'historique git, avec son message.

Compaction

Quand la fenêtre se remplit, l'agent résume la conversation pour libérer de la place et continuer.

Context engineering

L'art de choisir ce qui entre dans la fenêtre de contexte : le plus petit ensemble d'informations utiles pour obtenir le bon résultat.

Conventional Commits

Une convention de message de commit : un type (feat, fix, docs…), une portée entre parenthèses, puis un sujet court. Exemple : fix(site): corriger le lien du glossaire.

Dev agentique

Développer en confiant une partie du travail à un agent de code, qui lit, modifie et exécute dans votre projet pendant que vous cadrez et vérifiez.

Fenêtre de contexte

Tout ce que le modèle peut voir à un instant : consignes, fichiers lus, historique, résultats d'outils. Il n'a pas d'autre mémoire.

Fichier d'instructions

Le fichier lu au début de chaque session (AGENTS.md, ou CLAUDE.md pour Claude Code) : ce que l'agent doit savoir du projet et ne peut pas deviner.

Voir la fiche : où ça vit, un exemple de fichier

Fusion

Intégrer une branche dans une autre, en général une pull request dans main. Décision humaine chez Kwa.

Gabarit seed

Un fichier modèle copié une seule fois dans le projet (par exemple un modèle d'issue), puis laissé au projet : Kwa ne le réécrit plus.

Garde (garde-fou)

Un hook lancé avant les outils qu'il surveille (commandes shell, écriture, lecture de fichiers), qui répond : refuser, demander confirmation ou laisser passer. Un filet contre l'erreur, pas une barrière de sécurité.

Dans Kwa : Exemples : pas de commit sur main, pas de lecture d'un fichier de secrets.

Voir la fiche : où ça vit, un exemple de fichier

Hallucination

Une affirmation fausse produite par le modèle avec le même ton qu'une vraie : une API qui n'existe pas, une source inventée.

Handoff (passage de relais)

Un court document de reprise (objectif, fait, décisions, reste à faire, pièges) pour qu'une autre session ou un autre agent continue sans relire toute la conversation.

Dans Kwa : /kwa:handoff l'écrit.

Harness (harnais)

Tout ce qui entoure le modèle pour qu'il travaille dans votre processus : consignes, garde-fous, procédures, mémoire, vérifications. Le mot vient du harnais d'un cheval.

Dans Kwa : Kwa est un harness : il ajoute ce cadre à Claude Code et à Codex.

Hook (crochet)

Un script que l'outil (Claude Code, Codex) exécute à un moment précis : avant une commande, après une modification, au démarrage, à la fin d'une réponse. Le modèle ne le lance pas et ne peut pas le sauter. Mais il juge un texte : une commande formulée autrement peut lui échapper. Un filet contre l'erreur, pas une barrière.

Dans Kwa : Certains hooks de Kwa refusent (les gardes), d'autres automatisent (formatage, journal, rappel des skills).

Voir la fiche : où ça vit, un exemple de fichier

Injection de prompt

Un texte lu par l'agent (page web, ticket, fichier) qui contient des instructions cachées pour détourner son comportement.

Intégration continue (CI)

Les vérifications (tests, build) lancées automatiquement à chaque changement poussé.

Issue (ticket)

Un ticket sur GitHub qui décrit un besoin ou un bug. Chaque issue et chaque PR d'un dépôt reçoit un numéro à la suite (#12, #13…). Une pull request s'y rattache en écrivant « Closes #12 » dans sa description : GitHub ferme l'issue à la fusion.

Jeton

Le morceau de texte que le modèle lit et écrit (souvent un bout de mot). Tout se compte en jetons : la taille de la fenêtre, les limites, le coût.

Marketplace (catalogue)

Un dépôt qui liste des plugins installables. On l'ajoute une fois (/plugin marketplace add), puis on installe le plugin voulu.

Dans Kwa : Le dépôt nesyouyou/kwa est à la fois la marketplace et le plugin.

Voir la fiche : où ça vit, un exemple de fichier

MCP

Un protocole commun pour brancher à l'agent des outils externes : documentation, navigateur, base de données, tracker.

Dans Kwa : Exemples : Context7 (documentation à jour), Playwright (navigateur).

Voir la fiche : où ça vit, un exemple de fichier

Mode plan

Un mode où l'agent lit et propose un plan sans rien modifier, avant de passer à l'implémentation.

Opt-in (à activer)

Désactivé par défaut : il faut l'activer soi-même.

Dans Kwa : Exemple : verify-stop, activé par KWA_STOP_VERIFY=1.

Permission

Une règle de settings.json qui autorise, fait confirmer ou refuse un outil. Claude Code l'applique avant l'outil, sans demander au modèle.

Voir la fiche : où ça vit, un exemple de fichier

Plugin

Un paquet que l'agent de code installe une fois par machine : skills, agents, hooks, commandes. Il se met à jour sans toucher aux projets.

Dans Kwa : Kwa est un plugin ; le projet ne reçoit que sa configuration (kwa init).

Voir la fiche : où ça vit, un exemple de fichier

Politique du projet

Le fichier .claude/kwa.policy.json : ce qui change d'un projet à l'autre (commandes interdites ou à confirmer, vérifications, environnements).

Voir la fiche : où ça vit, un exemple de fichier

Preuve

Ce qui montre qu'un changement marche, sans croire l'agent sur parole : une capture d'écran de l'interface après le changement, la sortie d'un test rouge puis vert, une requête et sa réponse.

Dans Kwa : guard-github refuse un gh pr merge lancé par l'agent si ni la PR ni ses issues ne portent une image ou une section « Preuve » non vide. Il vérifie que la preuve existe, pas qu'elle est juste : la relecture humaine et la CI obligatoire restent la vraie porte de fusion.

Prompt (consigne)

Le texte que l'on donne au modèle pour lui demander quelque chose : la demande, son contexte, le format attendu.

Pré-vol

La liste des contrôles à passer juste avant un déploiement : branche à jour, tests verts, migrations prêtes, environnement visé.

Dans Kwa : /kwa:deploy lit les pré-vols de chaque environnement dans la politique.

Pull request (PR)

Une demande de fusion d'une branche dans la branche principale, avec sa description, sa relecture et ses vérifications.

Push (publier)

Envoyer ses commits vers le dépôt distant (GitHub). Chez Kwa, publier une branche demande confirmation.

Règle

Le mot a quatre sens. Une règle d'instructions (.claude/rules/*.md) : du texte que le modèle lit, sans contrainte. Une règle de permission de Claude Code (permissions.allow, ask, deny) : l'outil l'applique avant d'utiliser un outil. Une règle de commandes de Codex (.codex/rules) : Codex l'applique. Une règle de la politique de Kwa (bash.deny, write.deny) : les gardes l'appliquent.

Dans Kwa : Seules les trois dernières contraignent. Voir la page Imposé ou suggéré.

Voir la fiche : où ça vit, un exemple de fichier

Simulation

Exécuter une commande pour voir ce qu'elle ferait, sans rien modifier.

Dans Kwa : kwa init --dry-run.

Skill (savoir-faire)

Une procédure écrite dans un fichier SKILL.md : un en-tête qui dit quand s'en servir, un corps qui dit comment. L'agent la suit quand la situation correspond, ou vous la lancez.

Dans Kwa : /kwa:commit sous Claude Code, $kwa:commit sous Codex.

Voir la fiche : où ça vit, un exemple de fichier

Sous-agent

Un agent lancé par l'agent principal, avec sa propre fenêtre de contexte : il fait une tâche et ne renvoie qu'un résumé.

Dans Kwa : Kwa installe kwa:reviewer, un sous-agent en lecture seule.

Voir la fiche : où ça vit, un exemple de fichier

superpowers

Un plugin tiers de méthode pour Claude Code (licence MIT) : cadrer, planifier, tester d'abord, vérifier. Kwa en reprend les principes, réécrits en français.

Dans Kwa : Inutile de le connaître pour utiliser Kwa : la page Méthode montre ce qui est repris.

TDD (test d'abord)

Écrire d'abord un test qui échoue, puis le code qui le fait passer, puis nettoyer.

Workflow

Une suite d'étapes pour mener un travail du début à la fin, par exemple de la demande à la pull request. Au sens strict (Anthropic), le chemin est écrit d'avance dans du code ; dans un agent, c'est le modèle qui décide.

Dans Kwa : Les workflows de Kwa sont agentiques : l'enchaînement est proposé à l'agent, qui 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). Cinq : développer, corriger un bug, relire, livrer, capitaliser.

Worktree

Un second dossier de travail lié au même dépôt git, sur une autre branche : on travaille sur deux sujets sans se gêner.

YAML (en-tête)

Le format des en-têtes placés entre deux lignes « --- » en haut d'un fichier Markdown : des paires « clé: valeur » que l'outil lit (name, description, paths, tools).

Voir la fiche : où ça vit, un exemple de fichier