Coding-Agent State Protocol

Das Modell hält den Kontext. CASP beweist, dass der Zustand wahr ist — gegen git.

Die neuen Modelle arbeiten deine komplette Roadmap stundenlang, sogar tagelang ab, ohne den Faden zu verlieren. Genau deshalb wiegt Zustandsabweichung schwerer, nicht leichter: Je mehr ein Agent zwischen deinen Checkpoints erledigt, desto eher hört sein protokollierter Zustand still und leise auf, mit git übereinzustimmen. casp check ist das deterministische Gate, das den Push blockiert, sobald das passiert — heute mit Claude Code, und mit jedem Modell, das als Nächstes kommt.

Pre-flight-Check + Blackbox für KI-Coding-Sitzungen
$npm i -g @justethales/casp kopieren
Auf GitHub ansehen
casp check — drift validator
01 / Der Faden, den du ständig verlierst

Eine veraltete Zustandsdatei macht deinen Agenten selbstbewusst falsch.

Du kommst nach einer Woche zu einem Projekt zurück — oder jonglierst fünf gleichzeitig. Der Agent liest eine Zustandsdatei, die nicht mehr der Realität entspricht, beginnt selbstbewusst Arbeit, die längst ausgeliefert ist, und du verbrennst einen Nachmittag damit, das wieder rückgängig zu machen.

Boards, Karten und Tabellen retten dich nicht: Den Kontext zu rekonstruieren ist Handarbeit, und der Agent kann nichts davon lesen. Der Zustand muss maschinenlesbar sein, git-nativ — und nachweislich wahr.

CASP gibt jedem Projekt einen Faden, der über Sitzungen hinweg fortbesteht — und nicht still abweichen kann.
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 / Der Hebel

Alle speichern Kontext. CASP validiert ihn.

Der angrenzende Bereich — Mem0, Letta, Zep, die neuen git-nativen „memory“-Projekte — alle speichern, was passiert ist. Fast keines prüft, ob der gespeicherte Zustand noch der git-Realität entspricht. Diese Prüfung ist casp check — und sie ist vor jedem Push verpflichtend.

next-prompt drift
erkannt

Dein next_prompt zeigt auf eine Datei, die bereits ausgeliefert ist — oder nicht existiert. CASP weigert sich, die falsche Sitzung zu starten.

git ground-truth
erzwungen

last_commit nicht in der Historie, Migrationsliste nicht synchron, nicht committeter Zustand — geprüft gegen git selbst, nicht geraten.

push, blocked
deterministisch

Keine unscharfen Ähnlichkeitswerte. Ein hartes, wiederholbares Bestanden/Durchgefallen-Gate, das den Push stoppt, solange der Zustand lügt.

03 / Neben deiner bestehenden Umgebung

Git, PRs und CI wissen nicht, was als Nächstes ausgeliefert wird.

CASP ersetzt nichts in deinem Workflow. Es füllt die eine Lücke, die nichts anderes abdeckt — die validierte Gegenwart eines Projekts, in einer Form, die dein Agent lesen und auf die er handeln kann.

Jira · Linear
Absicht
Was du zu tun planst.
Weicht von der Realität ab, lebt in der Cloud, dein Agent kann es nicht zuverlässig lesen.
CASP
Validierte Gegenwart
Wo das Projekt gerade steht — und der exakte nächste Schritt, gegen git bewiesen.
Maschinenlesbar, im Repo, deterministisch. Der eine Faden, auf den Agenten handeln.
git · PR · CI
Historie & Verifikation
Was sich geändert hat · ist es reviewt · baut es.
Eine perfekte Aufzeichnung der Vergangenheit — und stumm darüber, was als Nächstes kommt.
04 / Drei Dateien. Ein Faden.

Das gesamte Protokoll passt in dein Repo.

Keine Datenbank. Kein Service. Kein Vektorspeicher. Drei einfache Dateien, die ein Agent in der ersten Zeile jeder Sitzung lesen kann.

state.json
source of truth

Maschinenlesbar, pro Projekt: aktuelle Phase, nächste Phase, der exakte auszuführende next-prompt, ausgelieferte Phasen, angewandte Migrationen, letzter Commit, letzte Session-ID.

now.md
für Menschen

Das „wo stehe ich gerade“ auf einem Bildschirm. Öffne es, hol dir den Faden in fünf Sekunden zurück — keine Archäologie.

roadmap.md
was als Nächstes ausgeliefert wird

Die Next-3 zum Ausliefern plus eine Phasen-Anzeigetafel. Der Agent kennt immer die Reihenfolge der Arbeit.

Templates sind Gates, keine Empfehlungen.  Kanonische session-prompt-, session-log- und audit-brief-Templates sorgen dafür, dass jede Sitzung — Mensch oder Agent — gleich geformte Artefakte erzeugt. Struktur wird erzwungen, nicht vorgeschlagen.
05 / Gebaut für große Roadmaps

Ein geordneter Faden über vierzig Phasen — Web und Mobile.

Ein echtes Produkt ist nicht ein Feature. Es sind Dutzende Phasen über API, Web-Client und Mobile, über Wochen ausgeliefert von rotierenden Sitzungen und Agenten. CASP hält eine einzige validierte Reihenfolge über das Ganze — sodass jeder Agent weiß, welche Phase als Nächstes kommt, und nie eine ausgelieferte erneut ausliefert.

Und die Schleife schließt sich selbst: Am Ende jeder Sitzung schreibt der Agent den Prompt der nächsten Sitzung für dich — du feilst an einer Zeile, du verfasst nicht von Grund auf — hängt ein Sitzungsprotokoll an und aktualisiert den Zustand. Öffne die nächste Sitzung, und sie macht genau dort weiter, wo die letzte aufgehört hat. Die Roadmap führt sich aus; du überwachst.

roadmap.md — Phasen-Anzeigetafel 13 ausgeliefert 22 gesamt
10apiEchtzeit-Sync-Engineausgeliefert
11mobilePush-Benachrichtigungenausgeliefert
12mobileOffline-First-Cacheausgeliefert
13webTeam-Berechtigungenausgeliefert
15apiAbrechnung pro Platzin Warteschlange
16mobileBiometrischer Loginin Warteschlange
/ In Produktion

Keine Demo. Zwei Live-Produkte laufen heute auf CASP.

Jede Zahl unten wird direkt aus der state.json jedes Projekts gelesen — dieselbe Datei, die der Agent liest, beim letzten Push gegen git validiert. Keine Marketing-Rechnerei.

LIVE

Ein kundenseitiges Flottenmanagement-ERP für ein Transportunternehmen in der Côte d'Ivoire — Web + Mobile, multi-modul, multi-rolle: Fahrer, Fahrzeuge, Compliance, Kasse, Werkstatt, Rechtsstreitigkeiten, Buchhaltung.

25+
ausgelieferte Phasen
20+
verfolgte Migrationen
6
Sitzungen an einem Tag

Jedes Modul ist eine validierte Phase. Der Agent liest das Cockpit, führt die nächste Phase aus next_prompt aus und hat nie ein ausgeliefertes Modul erneut ausgeliefert — selbst an einem Tag mit sechs Sitzungen.

LIVE

Die interne Ops- & Launch-Orchestrierungsplattform für ZeroSuite — eine mehrmonatige Roadmap, bearbeitet von einem echten Team, mit Launch-Modus-Gating und einem verfolgten Post-Launch-Backlog.

41
ausgelieferte Phasen
17
Migrationen
3
Operatoren

Ein validierter Faden über 40+ Phasen und drei Personen — plus 58 Elemente, explizit auf nach dem Launch verschoben, keines davon verloren. Das ist der „große Mehrbenutzer-Projekt“-Fall, für den CASP gebaut wurde.

Dasselbe Protokoll, zwei sehr unterschiedliche Produkte. Das Cockpit ist das Einzige, was sie teilen.

06 / Zustand, kein Gedächtnis

CASP ist keine Gedächtnis-Schicht für KI.

Gedächtnis-Tools merken sich, wer du bist. CASP verfolgt, wo dein Projekt steht — und beweist es. Anderes Artefakt, andere Operation, anderes Versagen, das es verhindert.

CASP
Gedächtnis-Schichten · Mem0 / Letta / git-native „soul“
Was es hält
Projekt-Ausführungszustand
Nutzerfakten & Vorlieben
Kernoperation
Validiert gegen git
Speichert & ruft ab
Bei Konflikt
Deterministische Prüfung gegen Ground-Truth
Unscharfe Ähnlichkeitsschätzung
Wann es läuft
Synchrones Gate — blockiert den Push
Asynchroner / eventueller Abruf
Verlässt deine Maschine
Nie · keine Telemetrie
Variiert / Cloud
07 / Das Kommandodeck

Fünf Verben. Trivial getippt.

Eine Silbe, keine Homographen, dieselben in Englisch, Französisch oder Spanisch.

casp initDie Kontinuitätsschicht in jedes Repo gerüstet.
casp statusMomentaufnahme auf einem Bildschirm: Phase, next, was ausgeliefert ist.
casp checkDer Drift-Validator. Vor jedem Push verpflichtend.
casp nextStartet die nächste Sitzung automatisch aus state.next_prompt.
casp new promptErzeugt einen gegateten session-prompt aus dem kanonischen Template.
casp new logÖffnet ein session-log in der Form, die jede Sitzung teilt.
08 / In deinem Editor

Native Slash-Befehle für deinen Agenten.

CASP liefert Claude-Code-Slash-Befehle, sodass der Zustand dort lebt, wo du bereits arbeitest.

/casp

Nur-Lese-Status — der Agent liest den aktuellen Faden, bevor er eine einzige Zeile schreibt.

/next

Startet die nächste Sitzung automatisch direkt aus state.next_prompt. Kein Copy-Paste, kein Raten.

Funktioniert mit Claude Code · Cursor · Aider · Continue — allem, was Dateien liest.

09 / Für Engineering-Organisationen

Wenn Agenten unbeaufsichtigt laufen, wird Drift zum Flottenproblem.

Ein Agent, der das Falsche tut, kostet einen Nachmittag. Hundert Agenten, die es über hundert Repos tun, kosten ein Quartal. CASP ist die deterministische Leitplanke, die du in die Automatisierungsschleife einsetzt — dieselbe Form in jedem Projekt.

Ein erforderlicher CI-Status-Check

casp check sitzt im selben Slot wie Lint und Tests. Ein Zustand, der lügt, kann nicht gemerged werden — Drift wird auf Org-Ebene blockiert, nicht der Disziplin Einzelner überlassen.

Eine Leitplanke für Agenten-Flotten

Autonome Agenten vervielfachen Fehler. CASP gibt jedem von ihnen denselben validierten Faden zum Lesen und dasselbe harte Gate, bevor er pusht. Automatisierung ohne die Doppelarbeitssteuer.

Ein Audit-Trail, kostenlos

Jeder Zustandsübergang ist ein git-Commit. Eine vollständige, diff-bare, rücksetzbare Aufzeichnung, wie jedes Projekt sich bewegt hat — git log ist dein Compliance-Trail.

Besteht InfoSec by Design

Rein lokal, keine Telemetrie, keine Cloud, kein Account. Nichts zu prüfen, nichts zu exfiltrieren. Der Security-Review ist eine Zeile: Es verlässt nie die Maschine.

.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

Ein Protokoll, jedes Repo. Dieselbe validierte Form, org-weit.

10 / Der Vertrag

Bewusst meinungsstark.

Ein Protokoll verdient sich Adoption dadurch, dass es vorhersehbar ist. Diese geben nicht nach.

P01

Validiere den Zustand, nicht die Absicht

CASP prüft, was dein Repo ist, nie, was du vorhattest. Fakten gegen git, jedes Mal.

P02

Templates sind Gates

Kanonische Artefakte werden erzwungen, nicht vorgeschlagen. Jede Sitzung kommt in derselben Form heraus.

P03

check vor jedem Push

Der Validator ist nicht optional. Ein lügender Zustand erreicht nie dein Remote.

P04

Nichts verlässt deine Maschine

Deterministisch, git-nativ, rein lokal. Keine Telemetrie. Keine Cloud, kein Account, keine Rechnung.

In zwei Minuten ausliefern

Gib jedem Projekt einen Faden, den dein Agent nicht verlieren kann.

Installieren, init, und dein Agent liest die Wahrheit in seiner ersten Zeile.

  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