Coding-Agent State Protocol

Le modèle garde le contexte. CASP prouve que l'état est vrai — face à git.

Les nouveaux modèles déroulent toute votre feuille de route pendant des heures, voire des jours, sans perdre le fil. C'est justement pour ça que la dérive d'état compte davantage, pas moins : plus l'agent en fait entre vos points de contrôle, plus son état enregistré peut cesser silencieusement de correspondre à git. casp check est le garde-fou déterministe qui bloque le push dès que c'est le cas — avec Claude Code aujourd'hui, et tout modèle qui sortira ensuite.

Un contrôle pré-vol et une boîte noire pour vos sessions de code IA. MIT, local uniquement, zéro télémétrie.

3
Fichiers, un seul fil
5
Verbes CLI
2
Produits en production
0
Télémétrie
casp check — validateur de dérive
$ casp check

✗ next_prompt → phases/14-camera.md (livré en v13.4)
✗ last_commit a1f3c9 absent de l'historique git
✗ migrations : l'état a 0007, git s'arrête à 0006
✗ modifications non commitées dans state.json

DÉRIVE DÉTECTÉE — push bloqué

$ casp check (après réconciliation)

✓ next_prompt pointe vers une phase non démarrée
✓ last_commit présent dans l'historique
✓ migrations alignées sur git
✓ state.json propre

ÉTAT SYNCHRONISÉ — prêt pour le push

Le problème

  • -Un fichier d'état périmé rend votre agent sûr de lui mais à côté de la plaque — il relance un travail déjà livré
  • -Revenez après une semaine, ou jonglez entre cinq projets, et reconstruire le contexte se fait à la main
  • -Tableaux, cartes et tableurs vivent dans le cloud et votre agent ne peut pas les lire de façon fiable
  • -Git, PR et CI sont un parfait registre du passé — et muets sur ce qui se livre ensuite
  • -Les couches de mémoire stockent ce qui s'est passé, mais presque aucune ne vérifie que cela correspond encore à git

La solution CASP

  • +Un fil unique et lisible par la machine par projet, qui survit aux sessions et ne peut pas dériver en silence
  • +Tout le monde stocke le contexte — CASP le valide contre git, avant chaque push
  • +L'agent rédige lui-même le prompt de la session suivante, journalise la session et met à jour l'état
  • +Une barrière déterministe, réussite ou échec — pas de score de similarité approximatif
  • +Natif git, local uniquement, zéro télémétrie — rien à auditer, rien à exfiltrer

Trois fichiers. Un seul fil.

Aucune base de données. Aucun service. Aucun vector store. Trois fichiers simples qu'un agent peut lire dès la première ligne de chaque session.

state.json

Source de vérité

Lisible par la machine, par projet : phase actuelle, phase suivante, le prompt exact à exécuter, phases livrées, migrations appliquées, dernier commit, identifiant de la dernière session.

now.md

Pour les humains

Le « où en suis-je maintenant » qui tient sur un écran. Ouvrez-le, récupérez le fil en cinq secondes — sans archéologie.

roadmap.md

Ce qui se livre ensuite

Les 3 prochaines à livrer plus un tableau de bord des phases. L'agent connaît toujours l'ordre du travail — et ne relivre jamais une phase déjà livrée.

Les modèles sont des barrières, pas des suggestions. Des modèles canoniques de session-prompt, session-log et audit-brief garantissent que chaque session — humaine ou agent — produit des artefacts de la même forme. La structure est imposée, pas suggérée.

De l'état, pas de la mémoire

Les outils de mémoire se souviennent de qui vous êtes. CASP suit où en est votre projet — et le prouve. Artefact différent, opération différente, échec différent évité.

CASP
Couches mémoire (Mem0 / Letta)
Ce qu'il contient
L'état d'exécution du projet
Faits et préférences utilisateur
Opération centrale
Valide contre git
Stocke et rappelle
En cas de conflit
Contrôle déterministe contre la vérité terrain
Estimation par similarité
Quand il s'exécute
Barrière synchrone — bloque le push
Rappel asynchrone / éventuel
Quitte votre machine
Jamais · zéro télémétrie
Variable / cloud

Cinq verbes. Faciles à taper.

Une syllabe, aucun homographe, identiques en anglais, en français ou en espagnol.

casp initInstaller la couche de continuité dans n'importe quel dépôt.
casp statusAperçu sur un écran : phase, suivante, ce qui est livré.
casp checkLe validateur de dérive. Obligatoire avant chaque push.
casp nextDémarrer automatiquement la session suivante depuis state.next_prompt.
casp new promptGénérer un prompt de session encadré à partir du modèle canonique.
casp new logOuvrir un journal de session dans la forme partagée par toutes.

Des commandes slash natives aussi : /casp et /next — compatible avec Claude Code, Cursor, Aider, Continue.

Pas une démo. Deux produits en production tournent sur CASP aujourd'hui.

Chaque chiffre ci-dessous est lu directement dans le state.json de chaque projet — le fichier même que l'agent lit, validé contre git au dernier push. Aucun calcul marketing.

EN LIGNE

Un ERP de gestion de flotte destiné aux clients d'une entreprise de transport en Côte d'Ivoire — web + mobile, multi-module, multi-rôle : chauffeurs, véhicules, conformité, caisse, garage, contentieux, comptabilité.

13
Phases livrées
12
Migrations suivies
6
Sessions en un jour

Chaque module est une phase validée. L'agent lit le cockpit, exécute la phase suivante, et n'a jamais relivré un module déjà livré — même lors d'une journée de six sessions.

EN LIGNE

La plateforme interne d'ops et d'orchestration de lancement de ZeroSuite — une feuille de route de plusieurs mois travaillée par une vraie équipe, avec un mode lancement encadré et un backlog post-lancement suivi.

41
Phases livrées
17
Migrations
3
Opérateurs

Un seul fil validé sur plus de 40 phases et trois personnes — plus 58 éléments explicitement reportés après le lancement, aucun perdu. Le cas du « grand projet multi-utilisateur » pour lequel CASP a été conçu.

Quand les agents tournent sans surveillance, la dérive devient un problème de flotte.

Un agent qui fait fausse route coûte un après-midi. Cent agents qui le font sur cent dépôts coûtent un trimestre. CASP est le garde-fou déterministe que vous insérez dans la boucle d'automatisation.

Contrôle CI requis

casp check occupe la même place que le lint et les tests. Un état qui ment ne peut pas être fusionné.

Garde-fou pour les flottes

Chaque agent reçoit le même fil validé à lire et la même barrière stricte avant de pousser.

Piste d'audit, gratuite

Chaque transition d'état est un commit git. git log est votre piste de conformité.

Validé par l'infosec

Local uniquement, zéro télémétrie, pas de cloud, pas de compte. La revue de sécurité tient en une ligne : rien ne quitte la machine.

Donnez à chaque projet un fil que votre agent ne peut pas perdre.

Installez, initialisez, et votre agent lit la vérité dès sa première ligne. Opérationnel en deux minutes.