Coding-Agent State Protocol

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

Les nouveaux modèles pilotent toute votre roadmap pendant des heures, voire des jours, sans perdre le fil. C'est précisément pour cela que la dérive d'état compte davantage, pas moins : plus un agent en fait entre vos points de contrôle, plus l'état qu'il a consigné peut cesser de correspondre à git, en silence. casp check est la barrière déterministe qui bloque le push dès que c'est le cas — avec Claude Code aujourd'hui, et chaque modèle qui sortira demain.

Check pré-vol + boîte noire pour vos sessions de code IA
$npm i -g @justethales/casp copier
Voir sur GitHub
casp check — validateur de dérive
01 / Le fil que vous perdez sans cesse

Un fichier d'état périmé rend votre agent confiant et faux.

Vous revenez sur un projet après une semaine — ou vous en jonglez cinq à la fois. L'agent lit un fichier d'état qui ne correspond plus à la réalité, se lance avec assurance dans un travail déjà livré, et vous brûlez un après-midi à le défaire.

Les tableaux, les cartes et les tableurs ne vous sauvent pas : reconstituer le contexte est manuel, et l'agent ne peut rien en lire. L'état doit être lisible par machine, natif git — et vrai de façon prouvable.

CASP donne à chaque projet un fil unique qui survit d'une session à l'autre — et ne peut pas dévier en silence.
state.json ● DRIFTED
{
  "phase": "13 — camera streaming",
  "next_prompt": "phases/14-camera.md",
                  // shipped in v13.4
  "last_commit": "a1f3c9",
                  // not in git history
  "migrations": ["0001""0007"],
                  // git stops at 0006
}
02 / La différence décisive

Tout le monde stocke le contexte. CASP le valide.

L'espace voisin — Mem0, Letta, Zep, les nouveaux projets de « mémoire » natifs git — stocke tout ce qui s'est passé. Presque aucun ne vérifie que l'état stocké correspond encore à la réalité de git. Cette vérification, c'est casp check — et elle est obligatoire avant chaque push.

dérive du next-prompt
détectée

Votre next_prompt pointe vers un fichier déjà livré — ou qui n'existe pas. CASP refuse de démarrer la mauvaise session.

vérité de git
imposée

last_commit absent de l'historique, liste des migrations désynchronisée, état non commité — confronté à git lui-même, pas à une estimation.

push, bloqué
déterministe

Aucun score de similarité approximatif. Une barrière pass/fail dure et répétable qui arrête le push tant que l'état ment.

03 / Aux côtés de votre stack existante

Git, les PR et la CI ignorent ce qui se livre ensuite.

CASP ne remplace rien dans votre workflow. Il comble la seule lacune que rien d'autre ne couvre — le présent validé d'un projet, sous une forme que votre agent peut lire et exploiter.

Jira · Linear
Intention
Ce que vous prévoyez de faire.
Dévie de la réalité, vit dans le cloud, votre agent ne peut pas le lire de façon fiable.
CASP
Présent validé
Où en est le projet à l'instant T — et le prochain pas exact, prouvé face à git.
Lisible par machine, dans le dépôt, déterministe. Le fil unique sur lequel les agents agissent.
git · PR · CI
Historique & vérification
Ce qui a changé · est-ce relu · est-ce que ça compile.
Un registre parfait du passé — et muet sur ce qui vient ensuite.
04 / Trois fichiers. Un seul fil.

Tout le protocole tient dans votre dépôt.

Pas de base de données. Pas de service. Pas de magasin vectoriel. Trois fichiers simples qu'un agent peut lire dès la première ligne de n'importe quelle session.

state.json
source de vérité

Lisible par machine, par projet : phase actuelle, phase suivante, le next-prompt exact à exécuter, les phases livrées, les migrations appliquées, le dernier commit, le dernier identifiant de session.

now.md
pour les humains

Le « où j'en suis à l'instant T » sur un seul écran. Ouvrez-le, retrouvez 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.

Les templates sont des barrières, pas des conseils.  Les templates canoniques session-prompt, session-log et audit-brief font que chaque session — humaine ou agent — produit des artefacts de même forme. La structure est imposée, pas suggérée.
05 / Conçu pour les grandes roadmaps

Un fil ordonné unique sur quarante phases — web et mobile.

Un vrai produit, ce n'est pas une seule fonctionnalité. C'est des dizaines de phases réparties entre l'API, le client web et le mobile, livrées sur des semaines par des sessions et des agents qui se relaient. CASP maintient un ordre validé unique sur l'ensemble — pour que n'importe quel agent sache quelle phase vient ensuite, et ne relivre jamais une phase déjà livrée.

Et la boucle se referme d'elle-même : à la fin de chaque session, l'agent écrit pour vous le prompt de la session suivante — vous ajustez une ligne, vous ne rédigez pas de zéro — ajoute un journal de session et incrémente l'état. Ouvrez la session suivante et elle reprend exactement là où la précédente s'est arrêtée. La roadmap s'exécute ; vous supervisez.

roadmap.md — tableau de bord des phases 13 livrées 22 au total
10apiMoteur de synchronisation temps réellivrée
11mobileNotifications pushlivrée
12mobileCache offline-firstlivrée
13webPermissions d'équipelivrée
15apiFacturation au siègeen file
16mobileConnexion biométriqueen file
/ En production

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 même fichier que l'agent lit, validé face à git au dernier push. Aucun calcul marketing.

LIVE

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é.

25+
phases livrées
20+
migrations suivies
6
sessions en un jour

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

LIVE

La plateforme interne d'ops & d'orchestration des lancements de ZeroSuite — une roadmap sur plusieurs mois menée par une vraie équipe, avec gating en mode lancement et un backlog post-lancement suivi.

41
phases livrées
17
migrations
3
opérateurs

Un fil validé unique sur 40+ phases et trois personnes — plus 58 éléments explicitement reportés après le lancement, aucun perdu. C'est le cas du « gros projet multi-utilisateurs » pour lequel CASP a été conçu.

Même protocole, deux produits très différents. Le cockpit est la seule chose qu'ils partagent.

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

CASP n'est pas une couche de mémoire pour IA.

Les outils de mémoire retiennent qui vous êtes. CASP suit où en est votre projet — et le prouve. Artefact différent, opération différente, défaillance différente qu'il prévient.

CASP
Couches de mémoire · Mem0 / Letta / « soul » natif git
Ce qu'il porte
L'état d'exécution du projet
Faits & préférences de l'utilisateur
Opération centrale
Valide face à git
Stocke & rappelle
En cas de conflit
Contrôle déterministe face à la vérité de référence
Estimation de similarité approximative
Quand il s'exécute
Barrière synchrone — bloque le push
Rappel asynchrone / à terme
Quitte votre machine
Jamais · zéro télémétrie
Variable / cloud
07 / Le poste de commande

Cinq verbes. Saisis sans effort.

Une syllabe, aucun homographe, les mêmes en anglais, en français ou en espagnol.

casp initInstalle la couche de continuité dans n'importe quel dépôt.
casp statusInstantané sur un écran : phase, suivante, ce qui est livré.
casp checkLe validateur de dérive. Obligatoire avant chaque push.
casp nextDémarre automatiquement la session suivante depuis state.next_prompt.
casp new promptGénère un session-prompt sous barrière à partir du template canonique.
casp new logOuvre un session-log dans la forme que partage chaque session.
08 / Dans votre éditeur

Des slash-commands natives pour votre agent.

CASP fournit des slash-commands Claude Code pour que l'état vive là où vous travaillez déjà.

/casp

Statut en lecture seule — l'agent lit le fil actuel avant d'écrire la moindre ligne.

/next

Démarre automatiquement la session suivante directement depuis state.next_prompt. Aucun copier-coller, aucune supposition.

Compatible avec Claude Code · Cursor · Aider · Continue — tout ce qui lit des fichiers.

09 / Pour les organisations d'ingénierie

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

Un agent qui fait la mauvaise chose 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 — la même forme dans chaque projet.

Un contrôle de statut CI obligatoire

casp check occupe le même emplacement que le lint et les tests. Un état qui ment ne peut pas être mergé — la dérive est bloquée au niveau de l'organisation, pas laissée à la discipline de chacun.

Un garde-fou pour les flottes d'agents

Les agents autonomes multiplient les erreurs. CASP remet à chacun d'eux le même fil validé à lire et la même barrière dure avant qu'il ne pousse. L'automatisation sans la taxe du travail en double.

Une piste d'audit, gratuitement

Chaque transition d'état est un commit git. Un registre complet, comparable et réversible de la façon dont chaque projet a avancé — git log est votre piste de conformité.

Conforme à l'infosec par conception

100 % local, zéro télémétrie, pas de cloud, pas de compte. Rien à auditer, rien à exfiltrer. La revue de sécurité tient en une ligne : il ne quitte jamais la machine.

.github/workflows/ci.yml
jobs:
  state-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }   # casp checks against full git history
      - run: npx @justethales/casp check       # ✗ fails the build the moment state drifts

Un protocole, tous les dépôts. La même forme validée, à l'échelle de l'organisation.

10 / Le contrat

Tranché à dessein.

Un protocole gagne son adoption en étant prévisible. Ces règles ne plient pas.

P01

Valider l'état, pas l'intention

CASP contrôle ce que votre dépôt est, jamais ce que vous comptiez faire. Les faits face à git, à chaque fois.

P02

Les templates sont des barrières

Les artefacts canoniques sont imposés, pas suggérés. Chaque session ressort avec la même forme.

P03

check avant chaque push

Le validateur n'est pas optionnel. Un état qui ment n'atteint jamais votre remote.

P04

Rien ne quitte votre machine

Déterministe, natif git, 100 % local. Zéro télémétrie. Pas de cloud, pas de compte, pas de facture.

En production en deux minutes

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.

  terminal
$ npm i -g @justethales/casp
$ casp init          # scaffold the layer
$ casp status        # where am I right now
$ casp check         # prove the state is true