Il vous faut :

• Node.js 20 ou plus et git.
• Un agent compatible : Claude Code, Cursor, Copilot, Gemini CLI, Windsurf, tout ce qui lit AGENTS.md.

Dans votre projet, une seule commande :

npx runward init                       # assistant interactif
npx runward --yes init                 # non interactif (CI)
npx runward init --tools claude,cursor,copilot,gemini,windsurf

Le paquet est publié sur npm. Pour développer ou contribuer, installez depuis les sources :

git clone https://github.com/stranxik/runward.git
cd runward
npm install
npm run build
node dist/cli.js --version

init échafaude la structure de mission : le fichier AGENTS.md (la « loi » neutre que lit l'agent) et le dossier runward/.

votre-projet/
├── AGENTS.md                    # charte d'agent, neutre (le fichier « loi »)
├── runward/
│   ├── framing.md               # problème, valeur, critère de succès, plancher vs cible
│   ├── mission-contract.md      # contrat de pilotage : engagements, DoD, portes
│   ├── architecture.md          # frontières, ports, protocole, la stack reste ouverte
│   ├── decision-matrix.md       # 22 arbitrages : un défaut sobre + un déclencheur chacun
│   ├── floor.md                 # le plus petit système qui prouve la valeur sur trafic réel
│   ├── adr/                     # un ADR par décision structurante, avec déclencheur de revue
│   ├── rules/                   # 51 règles de craft que votre agent applique
│   ├── governance/              # modèle de menace, rubrique d'évaluation, observabilité
│   ├── contracts/               # contrats de port (versionnés, additifs)
│   ├── runbook.md               # runbook de reprise pour l'équipe qui hérite
│   └── workflows/               # la méthode, exécutable par votre agent
└── .claude/ | .cursor/          # profils d'outils (--tools)

Drapeaux globaux : --yes, --dry-run, --verbose, --no-color. Codes de sortie : 0 succès, 1 trous ou avertissements, 2 prérequis manquant.

Installez, lancez runward init, et remplissez runward/framing.md avec votre sponsor : une conversation, pas du code. Le jour un produit une note de cadrage et un contrat de mission. Le premier code que vous écrivez, c'est le plancher, des semaines plus tard, pas des mois.

Vérifiez l'écart à tout moment ; check est fait pour la CI et sort en code 1 tant qu'il reste des trous :

node ../runward/dist/cli.js check
echo $?        # 1 tant qu'un livrable de porte n'est pas rempli

Ouvrez le projet dans votre agent (Claude Code, Cursor, Copilot, Gemini CLI, Windsurf) et pointez-le sur AGENTS.md et runward/workflows/method.md. Votre agent exécute les workflows ; vous franchissez les portes. runward check à tout moment pour voir où vous en êtes.

Astuce : le bouton copier .md de chaque section copie ce bloc en markdown, collez-le directement à votre agent comme contexte.

Aucune porte ne se franchit sur déclaration, seulement sur preuve.

Chaque page étape détaille sa porte.