Aller au contenu
runward
runward
Produit
Pour qui
Confiance
Documentation
Nouveautés
Essayer sur un exemple Échanger avec nous

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.

  1. 01Installer
  2. 02Lancer le contrôle
  3. 03Le brancher dans votre chaîne de livraison

Pour voir d’abord

Essayer sur un exemple

Dans un dossier vide, avec git initialisé :

Terminal
npx --yes runward@0.47.0 init --example

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 :

Terminal
npx --yes runward@0.47.0 init

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 fichiersCe qu’il contient
runward/framing.mdLe problème, la valeur attendue, le critère de réussite.
runward/architecture.mdLes frontières du système.
runward/adr/Les décisions structurantes, écrites et datées.
runward/floor.mdLes mesures de la première version.
runward/governance/threat-model.mdL’analyse de sécurité.
runward/runbook.mdLa procédure de reprise.
runward/handover.mdLa note de passation.
AGENTS.mdLes consignes de l’équipe pour vos agents de code.

Les six étapes, et ce que le dossier contient à chacune

Étape 2

Lancer le contrôle

Terminal
npx runward check

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.

Terminal
npx runward check --strict

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 :

Chaîne de livraison
npx --yes runward@0.47.0 check --strict

Elle échoue tant qu’il reste un écart. C’est vous qui décidez si cet échec bloque la mise en production.

Le branchement, dans la documentation

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.

Utiliser runward depuis un agent, dans la documentation

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.

Terminal
git clone https://github.com/stranxik/runward-demo-renaming && git -C runward-demo-renaming checkout 97fce96d901d0d07cad8a230950d391b223736af && npx --yes runward@0.47.0 check --strict --path runward-demo-renaming

Vérifier par vous-même

Essayez sur un exemple, en une commande.

Essayer sur un exemple

Échanger avec nous

Dites-nous qui vous êtes : nous revenons vers vous.

Vos coordonnées sont enregistrées par Another Framework, éditeur de runward, pour vous recontacter. Elles ne sont ni vendues ni partagées, et sont effacées trois ans après notre dernier échange. Pour les consulter ou les effacer : contact@runward.dev.