Coding-Agent State Protocol

Bağlamı model tutar. CASP, durumun gerçek olduğunu kanıtlar — git'e karşı.

Yeni modeller tüm yol haritanızı saatlerce, hatta günlerce, ipliği kaybetmeden yürütür. Durum sapması işte tam da bu yüzden daha çok önem taşır, daha az değil: bir ajan kontrol noktalarınız arasında ne kadar çok iş yaparsa, kaydettiği durum git'e uymayı sessizce o kadar çok bırakabilir. casp check, bu olduğu anda push'u engelleyen deterministik kapıdır — bugün Claude Code ile, ve sonra çıkacak her modelle.

Yapay zekâ kodlama oturumları için uçuş öncesi kontrol + kara kutu
$npm i -g @justethales/casp kopyala
GitHub'da görüntüle
casp check — sapma doğrulayıcı
01 / Sürekli kaybettiğiniz iplik

Bayatlamış bir durum dosyası ajanınızı kendinden emin biçimde yanıltır.

Bir projeye bir hafta sonra dönersiniz — ya da aynı anda beş tanesini birden çevirirsiniz. Ajan, artık gerçekle örtüşmeyen bir durum dosyasını okur, çoktan teslim edilmiş bir işe kendinden emin biçimde başlar, siz de onu geri almak için bir öğleden sonra harcarsınız.

Panolar, kartlar ve elektronik tablolar sizi kurtarmaz: bağlamı yeniden kurmak elle yapılır ve ajan bunların hiçbirini okuyamaz. Durumun makine tarafından okunabilir, git-native — ve kanıtlanabilir biçimde gerçek olması gerekir.

CASP her projeye oturumlar boyunca ayakta kalan tek bir iplik verir — ve bu iplik sessizce sapamaz.
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 / Belirleyici ayrım

Herkes bağlamı depolar. CASP onu doğrular.

Komşu alan — Mem0, Letta, Zep, yeni git-native "bellek" projeleri — hepsi olup biteni depolar. Neredeyse hiçbiri, depolanan durumun hâlâ git gerçeğine uyduğunu doğrulamaz. O doğrulama, casp check'tir — ve her push'tan önce zorunludur.

next-prompt sapması
yakalandı

next_prompt değeriniz çoktan teslim edilmiş — ya da var olmayan — bir dosyayı gösterir. CASP yanlış oturumu başlatmayı reddeder.

git gerçeği
dayatıldı

last_commit geçmişte yok, migrations listesi senkron dışı, commit edilmemiş durum — bir tahmine karşı değil, git'in kendisine karşı denetlenir.

push, engellendi
deterministik

Bulanık benzerlik skorları yok. Durum yalan söylediği sürece push'u durduran, sert ve tekrarlanabilir bir geçti/kaldı kapısı.

03 / Mevcut yığınınızın yanında

Git, PR'lar ve CI sırada ne teslim edileceğini bilmez.

CASP iş akışınızdaki hiçbir şeyin yerini almaz. Başka hiçbir şeyin kapatmadığı tek boşluğu doldurur — bir projenin doğrulanmış şimdiki zamanı, ajanınızın okuyup üzerine hareket edebileceği bir biçimde.

Jira · Linear
Niyet
Yapmayı planladığınız şey.
Gerçekten sapar, bulutta yaşar, ajanınız onu güvenilir biçimde okuyamaz.
CASP
Doğrulanmış şimdi
Projenin şu anda nerede durduğu — ve tam olarak sonraki adım, git'e karşı kanıtlanmış.
Makine tarafından okunabilir, depo içinde, deterministik. Ajanların üzerine hareket ettiği tek iplik.
git · PR · CI
Geçmiş & doğrulama
Ne değişti · gözden geçirildi mi · derleniyor mu.
Geçmişin kusursuz bir kaydı — ve sıradakine dair sessiz.
04 / Üç dosya. Tek iplik.

Tüm protokol deponuza sığar.

Veritabanı yok. Servis yok. Vektör deposu yok. Bir ajanın herhangi bir oturumun ilk satırında okuyabileceği üç düz dosya.

state.json
gerçeğin kaynağı

Makine tarafından okunabilir, proje başına: mevcut faz, sonraki faz, yürütülecek tam next-prompt, teslim edilen fazlar, uygulanan migration'lar, son commit, son oturum kimliği.

now.md
insanlar için

Tek ekranlık "şu anda neredeyim." Açın, ipliği beş saniyede geri alın — arkeoloji yok.

roadmap.md
sırada ne teslim ediliyor

Teslim edilecek Sonraki-3, artı bir faz skor tablosu. Ajan iş sırasını her zaman bilir.

Şablonlar kapıdır, kılavuz değil.  Kanonik session-prompt, session-log ve audit-brief şablonları, her oturumun — insan ya da ajan — aynı biçimde artefaktlar üretmesini sağlar. Yapı önerilmez, dayatılır.
05 / Büyük yol haritaları için tasarlandı

Kırk faz boyunca tek bir sıralı iplik — web ve mobil.

Gerçek bir ürün tek bir özellik değildir. API, web istemcisi ve mobil arasında, haftalar boyunca dönüşümlü oturumlar ve ajanlar tarafından teslim edilen onlarca fazdır. CASP tüm bunlar boyunca tek bir doğrulanmış sıra tutar — böylece her ajan hangi fazın sırada olduğunu bilir ve teslim edilmiş bir fazı asla yeniden teslim etmez.

Ve döngü kendi kendine kapanır: her oturumun sonunda ajan bir sonraki oturumun prompt'unu sizin için yazar — siz bir satırı ayarlarsınız, sıfırdan yazmazsınız — bir oturum günlüğü ekler ve durumu ilerletir. Sonraki oturumu açın, tam olarak bir öncekinin durduğu yerden devam eder. Yol haritası yürür; siz denetlersiniz.

roadmap.md — faz skor tablosu 13 teslim edildi 22 toplam
10apiGerçek zamanlı senkronizasyon motoruteslim edildi
11mobileAnlık bildirimlerteslim edildi
12mobileÇevrimdışı öncelikli önbellekteslim edildi
13webEkip izinleriteslim edildi
15apiKoltuk başına faturalamasırada
16mobileBiyometrik girişsırada
/ Üretimde

Demo değil. Bugün iki canlı ürün CASP üzerinde çalışıyor.

Aşağıdaki her sayı doğrudan her projenin state.json dosyasından okunur — ajanın okuduğu, son push'ta git'e karşı doğrulanan dosyanın aynısı. Pazarlama matematiği yok.

LIVE

Fildişi Sahili'ndeki bir nakliye şirketi için müşteriye dönük bir filo yönetimi ERP'si — web + mobil, çok modüllü, çok rollü: şoförler, araçlar, uyumluluk, kasa, garaj, ihtilaf, muhasebe.

25+
teslim edilen faz
20+
izlenen migration
6
bir günde oturum

Her modül doğrulanmış bir fazdır. Ajan kokpiti okur, sonraki fazı next_prompt üzerinden yürütür ve teslim edilmiş bir modülü asla yeniden teslim etmedi — altı oturumluk bir günde bile.

LIVE

ZeroSuite için dahili ops & lansman-orkestrasyonu platformu — gerçek bir ekip tarafından yürütülen, lansman-modu kapılaması ve izlenen lansman-sonrası backlog'u olan, çok aylık bir yol haritası.

41
teslim edilen faz
17
migration
3
operatör

40+ faz ve üç kişi boyunca tek bir doğrulanmış iplik — artı lansman sonrasına açıkça ertelenmiş 58 öğe, hiçbiri kaybolmadı. Bu, CASP'in uğruna tasarlandığı "büyük çok kullanıcılı proje" durumudur.

Aynı protokol, çok farklı iki ürün. Paylaştıkları tek şey kokpit.

06 / Durum, bellek değil

CASP bir yapay zekâ bellek katmanı değildir.

Bellek araçları kim olduğunuzu hatırlar. CASP projenizin nerede durduğunu izler — ve bunu kanıtlar. Farklı artefakt, farklı işlem, önlediği farklı bir arıza.

CASP
Bellek katmanları · Mem0 / Letta / git-native "soul"
Ne tutar
Projenin yürütme durumu
Kullanıcı bilgileri & tercihleri
Temel işlem
Git'e karşı doğrular
Depolar & geri çağırır
Çakışmada
Referans gerçeğe karşı deterministik denetim
Bulanık benzerlik tahmini
Ne zaman çalışır
Eşzamanlı kapı — push'u engeller
Asenkron / nihai geri çağırma
Makinenizden çıkar mı
Asla · sıfır telemetri
Değişir / bulut
07 / Komuta paneli

Beş fiil. Zahmetsizce yazılır.

Tek hece, eşsesli yok, İngilizce, Fransızca ya da İspanyolca'da aynı.

casp initSüreklilik katmanını herhangi bir depoya kurar.
casp statusTek ekranlık anlık görünüm: faz, sonraki, neyin teslim edildiği.
casp checkSapma doğrulayıcı. Her push'tan önce zorunlu.
casp nextSonraki oturumu state.next_prompt üzerinden otomatik başlatır.
casp new promptKanonik şablondan kapılı bir session-prompt üretir.
casp new logHer oturumun paylaştığı biçimde bir session-log açar.
08 / Editörünüzde

Ajanınız için yerel slash-komutları.

CASP, durumun zaten çalıştığınız yerde yaşaması için Claude Code slash-komutları sunar.

/casp

Salt okunur durum — ajan tek bir satır yazmadan önce mevcut ipliği okur.

/next

Sonraki oturumu doğrudan state.next_prompt üzerinden otomatik başlatır. Kopyala-yapıştır yok, tahmin yok.

Claude Code · Cursor · Aider · Continue ile çalışır — dosya okuyan her şeyle.

09 / Mühendislik organizasyonları için

Ajanlar gözetimsiz çalıştığında, sapma bir filo sorununa dönüşür.

Yanlış işi yapan bir ajan bir öğleden sonraya mal olur. Yüz depoda bunu yapan yüz ajan bir çeyreğe mal olur. CASP, otomasyon döngüsüne yerleştirdiğiniz deterministik korkuluktur — her projede aynı biçimde.

Zorunlu bir CI durum denetimi

casp check, lint ve testlerle aynı yuvada durur. Yalan söyleyen bir durum merge edilemez — sapma organizasyon düzeyinde engellenir, kimsenin disiplinine bırakılmaz.

Ajan filoları için bir korkuluk

Otonom ajanlar hataları çoğaltır. CASP her birine okuyacağı aynı doğrulanmış ipliği ve push'tan önce aynı sert kapıyı verir. Tekrar eden iş vergisi olmadan otomasyon.

Ücretsiz bir denetim izi

Her durum geçişi bir git commit'idir. Her projenin nasıl ilerlediğine dair eksiksiz, karşılaştırılabilir, geri alınabilir bir kayıt — git log uyumluluk iziniz olarak kullanılır.

Tasarımı gereği infosec'ten geçer

Yalnızca yerel, sıfır telemetri, bulut yok, hesap yok. İncelenecek bir şey yok, dışarı sızdırılacak bir şey yok. Güvenlik incelemesi tek satır: makineyi asla terk etmez.

.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

Tek protokol, her depo. Aynı doğrulanmış biçim, organizasyon genelinde.

10 / Sözleşme

Bilinçli olarak iddialı.

Bir protokol, öngörülebilir olarak benimsenmeyi hak eder. Bu kurallar eğilmez.

P01

Niyeti değil, durumu doğrula

CASP, deponuzun ne olduğunu denetler, ne yapmak istediğinizi asla. Her seferinde git'e karşı gerçekler.

P02

Şablonlar kapıdır

Kanonik artefaktlar önerilmez, dayatılır. Her oturum aynı biçimde çıkar.

P03

her push'tan önce check

Doğrulayıcı isteğe bağlı değildir. Yalan söyleyen bir durum remote'unuza asla ulaşmaz.

P04

Hiçbir şey makinenizden çıkmaz

Deterministik, git-native, yalnızca yerel. Sıfır telemetri. Bulut yok, hesap yok, fatura yok.

İki dakikada üretime

Her projeye, ajanınızın kaybedemeyeceği bir iplik verin.

Kurun, başlatın, ve ajanınız daha ilk satırında gerçeği okur.

  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