Commencer
Installez le contrôle dans votre dépôt.
Une commande crée le dossier de l’équipe à côté du code. Une autre le relit à chaque livraison, et dit ce qui manque.
Pour voir d’abord
Essayer sur un exemple
Dans un dossier vide, avec git initialisé :
La commande écrit un exemple complet et lance le contrôle : tout est vert. Renommez ensuite la fonction qu’elle vous indique, lancez les tests (dans code/, après npm install) puis le contrôle : les tests passent, le contrôle refuse et nomme les deux lignes du dossier qui la citent. La scène, sur un dépôt public, montre le même geste.
Avant de commencer
Ce qu’il vous faut
- Node.js 22.12 ou plus récent, et git.
- Le dépôt d’une application.
- Si vous livrez avec un agent de code : la commande crée ses consignes, dans un fichier
AGENTS.md.
Étape 1
Installer
À la racine de votre dépôt :
La commande pose quelques questions, puis crée un fichier AGENTS.md, un dossier runward/ et un dossier .agents/skills/ pour vos agents. Elle n’écrase aucun fichier existant. Le dossier runward/ est celui de l’équipe : elle y fixe ce qu’elle exige avant la production, et ses agents y rédigent l’essentiel, avec ce qui le prouve.
| Les principaux fichiers | Ce qu’il contient |
|---|---|
runward/framing.md | Le problème, la valeur attendue, le critère de réussite. |
runward/architecture.md | Les frontières du système. |
runward/adr/ | Les décisions structurantes, écrites et datées. |
runward/floor.md | Les mesures de la première version. |
runward/governance/threat-model.md | L’analyse de sécurité. |
runward/runbook.md | La procédure de reprise. |
runward/handover.md | La note de passation. |
AGENTS.md | Les consignes de l’équipe pour vos agents de code. |
Étape 2
Lancer le contrôle
Le contrôle dit quelle pièce du dossier manque ou n’est pas remplie. Il se termine avec le code 1 tant qu’il reste un écart, et avec le code 0 quand rien ne bloque.
Avec --strict, il vérifie aussi que chaque preuve citée dans le dossier existe encore : un fichier, un test, une décision écrite. Quand il refuse, il nomme le fichier et la ligne.
Étape 3
Le brancher dans votre chaîne de livraison
Ajoutez la même commande à votre chaîne de livraison, avec la version que vous avez choisie :
Elle échoue tant qu’il reste un écart. C’est vous qui décidez si cet échec bloque la mise en production.
Avec un agent de code
Vos agents lisent le même dossier.
Codex, Cursor, Copilot et les autres outils qui lisent AGENTS.md y trouvent les consignes de l’équipe. Claude Code le lit aussi quand le dépôt n’a pas de CLAUDE.md. Pour Gemini CLI, ajoutez son profil : npx runward init --tools gemini. Demandez à vos agents de lancer runward check avant de dire qu’ils ont terminé : le contrôle leur répond comme à vous.
Sans rien installer dans votre dépôt
Voyez d’abord un refus, sur un dépôt public.
Cette commande relance le contrôle sur le commit de la scène de la page d’accueil. Il refuse, et dit quelles lignes.
Pour aller plus loin
La documentation
Essayez sur un exemple, en une commande.
Essayer sur un exemple