Depuis un agent IA.

L'affirmation phare, à savoir qu'un agent peut « découvrir, installer et exploiter runward sans humain au clavier », est vraie, avec une exception délibérée que cette page explique en détail : runward ne câble jamais la garde dans votre dépôt de lui-même. L'agent peut réaliser ce câblage, mais uniquement sur accord explicite de l'opérateur. C'est une fonctionnalité, pas une lacune.

La boucle que pilote un agent est la même partout : construire, lancer le check, et sur trous reboucler ; au vert, franchir la porte.

Le modèle mental : l'agent pilote, runward encadre

Ce qu'est runward

runward ne génère pas de code et n'est pas un runtime. C'est un cadre déterministe autour de la livraison produite par l'agent : l'agent construit, et runward check audite si les livrables requis existent et si chaque règle d'artisanat CRITICAL/HIGH a été prise en compte avec une preuve qui se résout. L'audit est documentaire : « runward n'a pas exécuté votre code, ce n'est pas un runtime ». Le LLM vit dans le harnais qui pilote runward, jamais dans la garde.

La boucle d'exploitation

Toute la boucle d'exploitation pour un agent est la suivante :

1. runward init : mettre en place la mission.
2. Construire, en consultant la charte et les skills de phase.
3. runward check / runward check --strict --json : lire le verdict.
4. Optionnellement runward wire : identifier le canal de déclenchement automatique et, sur approbation, le câbler.
5. Franchir les gardes sur preuve.

Les codes de sortie sont le signal primaire tout du long :

• 0 garde courante propre
• 1 manques
• 2 aucune mission trouvée

Étape 1 : init écrit une base strictement neutre vis-à-vis des fournisseurs

runward init échafaude la mission. Sans --tools explicite, il n'écrit que le cœur neutre et ne privilégie aucun harnais (ADR-0030).

Deux surfaces toujours écrites

Deux surfaces sont toujours écrites, inconditionnellement, avant tout profil d'outil :

• AGENTS.md à la racine du projet : la charte de l'agent. C'est le standard ouvert lu par Codex, Cursor, Copilot, Windsurf, Cline, Zed, Amp, opencode, goose, Junie, Warp et une longue liste d'agents.
• .agents/skills/runward-<phase>/SKILL.md : les skills de phase neutres, le format SKILL.md convergé lu par plus de 14 harnais, sans agent privilégié.

Les profils sont optionnels

Sous --yes (ou toute exécution non interactive), la liste des profils d'outils est vide et l'assistant ne pré-coche rien. Un profil par harnais (.claude/, .cursor/, GEMINI.md, etc.) est une option que l'opérateur ou l'agent ajoute ensuite, jamais un défaut. Cela corrige un défaut antérieur où init basculait silencieusement sur le profil claude (ADR-0030).

Pourquoi neutre par défaut

Détecter le harnais et sélectionner automatiquement son profil n'est fiable que pour deux ou trois harnais et aveugle pour le reste, si bien qu'un init orienté détection « habillerait une capacité partielle en capacité générale et privilégierait Claude/Gemini par accident ». La base porte déjà l'opérabilité complète : dès la fin d'init, runward check s'exécute dans n'importe quel harnais sans rien d'autre à câbler.

Recette pour l'agent (entièrement non interactive)

runward init --yes                 # neutral baseline, greenfield, floor tier
runward init --yes --tools cursor  # add one profile explicitly, on the operator's request
runward init --example             # a filled reference mission, every gate green out of the box

Ids --tools pris en charge : claude, cursor, copilot, gemini, windsurf, continue, junie, trae, kiro (les ids inconnus produisent un avertissement mais n'échouent pas).

Étape 2 : construire face à la charte et aux skills de phase

La charte

AGENTS.md énonce cinq frontières non négociables :

• l'architecture contraint le modèle
• les frontières avant la stack
• la complexité différée jusqu'à un déclencheur
• frontière déterministe
• sécurité sur les actions et non sur l'affichage

et la boucle de travail :

• appliquer les règles d'artisanat au point d'action
• exécuter la boucle de décision avant toute décision structurelle
• un ADR par décision
• ne jamais marquer une phase comme faite sans sa Definition of Done

Les skills de phase

Les skills de phase s'activent d'eux-mêmes selon la pertinence : chacun porte un déclencheur description sur lequel un agent fait correspondance, et oriente l'agent vers les règles CRITICAL/HIGH de cette phase et vers runward manifest --sync pour échafauder les lignes de conformité qu'il doit remplir. Le skill aide à appliquer les règles ; il ne les impose pas : « runward check --strict est la seule autorité ».

La suite de cette section

• Le contrat machine : check --json et wire
• La frontière : runward ne se câble jamais tout seul