Skip to content
← Retour au kit
Agent: Cloud agents Support: full

Adaptateur agents cloud

Les agents cloud et en arrière-plan — tâches distantes Claude Code, OpenAI Codex cloud, agents de classe Jules, et environnements d’exécution asynchrones similaires — sont éphémères par conception : une session démarre, s’exécute pendant un temps borné, puis se termine. DWP transforme cette contrainte en atout en faisant du plan l’artefact durable, non la session.

L’intuition centrale

Le répertoire .dwp/ du dépôt est la couche de spec et d’état durable. Les sessions cloud sont des exécuteurs éphémères. Le plan indique à l’exécuteur quoi faire ; state.json lui indique où reprendre. La session peut être n’importe quoi — un modèle différent, un fournisseur différent, un nouveau conteneur — et le plan continue exactement là où il s’était arrêté.

Niveau de support

Complet — tout agent cloud qui lit le dépôt, suit AGENTS.md et peut exécuter des commandes shell supporte DWP sans adaptateur spécifique à la plateforme.

La boucle réveil-reprise-yield

Chaque tour d’agent cloud suit ce schéma :

  1. Réveil — la session démarre (déclenchée par un calendrier cron, un événement CI ou une action utilisateur).
  2. Exécuter le Protocole de reprise DWP — lire le README du plan, localiser le point de reprise, réconcilier state.json contre le markdown, inspecter la jonction, exécuter un smoke test. Voir Spécification DWP.
  3. Vérifier l’état bloqué — si state.json.blocked est renseigné, signaler la raison et céder la main sans exécuter.
  4. Exécuter la prochaine tâche atomique — une tâche, en passant sa porte de validation complète.
  5. Mettre à jour la couche d’état — réécrire state.json de façon atomique avec le nouveau statut de tâche, les enregistrements de portes, l’enregistrement de résultat et le hash de commit.
  6. Yield — la session se termine proprement ; le tour suivant reprend depuis l’état mis à jour.

Prérequis

  • Le plan MUST porter la couche d’état lisible par machine (manifest.json + state.json). Sans elle, une session éphémère n’a aucun moyen fiable de déterminer la position de reprise. Voir État du plan.
  • Le plan MUST avoir été approuvé par un humain avant tout tour cloud sans surveillance. L’approbation du plan est le point de contrôle.
  • L’agent opère sous une autorité bornée : il MUST NOT étendre le périmètre, effectuer des actions destructrices que le plan n’autorise pas explicitement, ni improviser au-delà des instructions de la tâche en cours. Voir Protocole de l’agent.

Notes

Les sessions d’agents cloud sont le cas extrême du profil d’exécution sans surveillance : continuité de session nulle, durabilité du plan maximale. Le répertoire .dwp/ de DWP est spécifiquement conçu pour que cela fonctionne — tout l’état dont un agent a besoin pour commencer, continuer et terminer un ensemble de travail réside dans des fichiers markdown et JSON simples que toute session peut lire depuis un checkout frais.