Coding-Agent State Protocol

Model menyimpan konteks. CASP membuktikan bahwa state itu benar — terhadap git.

CASP menjaga satu gambaran yang selalu benar tentang posisi sebenarnya tiap proyek Anda — kapan pun, divalidasi terhadap git. Kembalilah setelah seminggu atau setelah berbulan-bulan, di stack apa pun, di berapa pun jumlah agen, sesi, atau rekan tim: buka dan state-nya benar — atau casp check memblokir push sampai ia benar.

Pemeriksaan pra-terbang + kotak hitam untuk sesi coding AI
$npm i -g @justethales/casp salin
Lihat di GitHub
casp check — validator penyimpangan
01 / Benang merah yang terus Anda kehilangan

Berkas state yang basi membuat agen Anda salah dengan penuh percaya diri.

Anda kembali ke sebuah proyek setelah seminggu — atau Anda menangani lima sekaligus. Agen membaca berkas state yang tidak lagi cocok dengan kenyataan, dengan percaya diri mulai mengerjakan pekerjaan yang sudah dirilis, dan Anda menghabiskan satu sore untuk membatalkannya.

Papan, kartu, dan lembar kerja tidak menyelamatkan Anda: menyusun ulang konteks dilakukan manual, dan agen tidak dapat membaca satu pun darinya. State harus dapat dibaca mesin, native git — dan terbukti benar.

CASP memberi setiap proyek satu benang merah yang bertahan dari sesi ke sesi — dan tidak bisa menyimpang diam-diam.
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 / Pembeda yang menentukan

Semua orang menyimpan konteks. CASP memvalidasinya.

CASP adalah fondasi deterministik dari loop swa-verifikasi — satu-satunya pemeriksaan dalam "verifikasi pekerjaanmu" yang bukan model memeriksa dirinya sendiri: state terhadap git, di batas push, yang tak bisa dijangkau pemeriksaan di dalam loop. Ranah di sekitarnya — Mem0, Letta, Zep, proyek "memory" native git yang baru — semuanya menyimpan apa yang terjadi; hampir tidak ada yang memverifikasi bahwa state yang tersimpan masih cocok dengan git. Pemeriksaan itulah casp check — wajib sebelum setiap push.

penyimpangan next-prompt
terdeteksi

next_prompt Anda menunjuk ke berkas yang sudah dirilis — atau tidak ada. CASP menolak memulai sesi yang salah.

kebenaran git
ditegakkan

last_commit tidak ada dalam riwayat, daftar migrasi tidak sinkron, state belum di-commit — diperiksa terhadap git itu sendiri, bukan terkaan.

push, diblokir
deterministik

Tanpa skor kemiripan yang samar. Sebuah gerbang lulus/gagal yang tegas dan dapat diulang, yang menghentikan push selama state berbohong.

03 / Di samping stack yang sudah Anda pakai

Git, PR, dan CI tidak tahu apa yang dirilis berikutnya.

CASP tidak menggantikan apa pun dalam alur kerja Anda. Ia mengisi satu celah yang tidak ditutupi hal lain — masa kini yang tervalidasi dari sebuah proyek, dalam bentuk yang dapat dibaca dan ditindaklanjuti agen Anda.

Jira · Linear
Niat
Apa yang Anda rencanakan untuk dilakukan.
Menyimpang dari kenyataan, hidup di cloud, agen Anda tidak dapat membacanya dengan andal.
CASP
Masa kini tervalidasi
Di mana proyek berada saat ini — dan langkah berikutnya yang tepat, terbukti terhadap git.
Dapat dibaca mesin, di dalam repo, deterministik. Satu benang merah yang ditindaklanjuti agen.
git · PR · CI
Riwayat & verifikasi
Apa yang berubah · sudah ditinjau · apakah ia ter-build.
Catatan sempurna tentang masa lalu — dan bisu soal apa yang datang berikutnya.
04 / Tiga berkas. Satu benang merah.

Seluruh protokol muat di dalam repo Anda.

Tanpa basis data. Tanpa layanan. Tanpa vector store. Tiga berkas sederhana yang dapat dibaca agen pada baris pertama sesi mana pun.

state.json
sumber kebenaran

Dapat dibaca mesin, per proyek: fase saat ini, fase berikutnya, next-prompt persis yang harus dijalankan, fase yang sudah dirilis, migrasi yang sudah diterapkan, commit terakhir, id sesi terakhir.

now.md
untuk manusia

"Di mana saya sekarang" dalam satu layar. Buka, dapatkan kembali benang merahnya dalam lima detik — tanpa penggalian.

roadmap.md
apa yang dirilis berikutnya

Tiga berikutnya yang akan dirilis ditambah papan skor fase. Agen selalu tahu urutan pekerjaan.

Templat adalah gerbang, bukan panduan.  Templat kanonis session-prompt, session-log dan audit-brief membuat setiap sesi — manusia maupun agen — menghasilkan artefak berbentuk sama. Struktur ditegakkan, bukan disarankan.
05 / Rencanakan sekali, rilis per potong

Anda menulis rencananya sekali. Agen Anda yang bertanya apa berikutnya.

Ubah spesifikasi Anda menjadi antrean prompt sesi — masing-masing sebuah berkas di repositori Anda yang menyatakan apa yang mendahuluinya. casp next menyerahkan kepala antrean itu kepada agen Anda, dan menolak menyerahkan potongan yang sudah dirilis.

casp next mencetak prompt-nya. Ia tidak pernah menjalankannya — agen Andalah yang menjalankan. CASP adalah bagian yang membuat serah-terima itu layak dipercaya, bukan sebuah orkestrator.

docs/plan/sessions/ — antrean 2 shipped · 3 queued
PHASE-AUTH-GATE.mdnext_after: —shipped
PHASE-BILLING-CORE.mdnext_after: auth-gateshipped
PHASE-AUDIT-LOG.mdnext_after: team-rolesqueued
PHASE-API-DOCS.mdnext_after: audit-logqueued

Di akhir setiap sesi, agen Anda menambahkan catatan, memperbarui state, dan menyusun prompt berikutnya dalam antrean — Anda menyesuaikan satu baris alih-alih menulis dari nol. Dan papan fase tetap di roadmap.md, sehingga agen mana pun tahu urutan kerjanya.

roadmap.md — papan skor fase 13 dirilis 22 total
10apiMesin sinkronisasi real-timedirilis
11mobileNotifikasi pushdirilis
12mobileCache offline-firstdirilis
13webIzin timdirilis
15apiPenagihan per kursiantre
16mobileLogin biometrikantre
/ Di produksi

Bukan demo. Dua produk live berjalan di atas CASP hari ini.

Setiap angka di bawah dibaca langsung dari state.json tiap proyek — berkas yang sama yang dibaca agen, divalidasi terhadap git pada push terakhir. Tanpa hitung-hitungan marketing.

LIVE

ERP manajemen armada yang dipakai klien sebuah perusahaan transportasi di Pantai Gading — web + mobile, multi-modul, multi-peran: pengemudi, kendaraan, kepatuhan, kas, bengkel, sengketa, akuntansi.

25+
fase dirilis
20+
migrasi dilacak
6
sesi dalam sehari

Setiap modul adalah fase tervalidasi. Agen membaca cockpit, menjalankan fase berikutnya dari next_prompt, dan tidak pernah merilis ulang modul yang sudah dirilis — bahkan pada hari dengan enam sesi.

LIVE

Platform ops & orkestrasi peluncuran internal untuk ZeroSuite — roadmap berbulan-bulan yang dikerjakan tim nyata, dengan gating mode peluncuran dan backlog pasca-peluncuran yang dilacak.

41
fase dirilis
17
migrasi
3
operator

Satu benang merah tervalidasi sepanjang 40+ fase dan tiga orang — ditambah 58 item yang secara eksplisit ditunda hingga setelah peluncuran, tak satu pun hilang. Inilah kasus "proyek besar multi-pengguna" yang menjadi alasan CASP dibangun.

Protokol yang sama, dua produk yang sangat berbeda. Cockpit adalah satu-satunya hal yang mereka bagikan.

06 / State, bukan memori

CASP bukan lapisan memori AI.

Alat memori mengingat siapa Anda. CASP melacak di mana proyek Anda berada — dan membuktikannya. Artefak berbeda, operasi berbeda, kegagalan berbeda yang ia cegah.

CASP
Lapisan memori · Mem0 / Letta / "soul" native git
Apa yang dipegang
State eksekusi proyek
Fakta & preferensi pengguna
Operasi inti
Memvalidasi terhadap git
Menyimpan & memanggil kembali
Saat terjadi konflik
Pemeriksaan deterministik terhadap kebenaran rujukan
Terkaan kemiripan yang samar
Kapan ia berjalan
Gerbang sinkron — memblokir push
Pemanggilan asinkron / pada akhirnya
Keluar dari mesin Anda
Tidak pernah · tanpa telemetri
Bervariasi / cloud
07 / Pos komando

Lima kata kerja. Diketik tanpa repot.

Satu suku kata, tanpa homograf, sama saja dalam bahasa Inggris, Prancis, atau Spanyol.

casp initPasang lapisan kontinuitas ke repo mana pun.
casp statusCuplikan satu layar: fase, berikutnya, apa yang sudah dirilis.
casp checkValidator penyimpangan. Wajib sebelum setiap push.
casp nextMulai otomatis sesi berikutnya dari state.next_prompt.
casp new promptHasilkan session-prompt bergerbang dari templat kanonis.
casp new logBuka session-log dalam bentuk yang dibagikan setiap sesi.
08 / Di dalam editor Anda

Slash-command native untuk agen Anda.

CASP menyertakan slash-command Claude Code agar state berada di tempat Anda sudah bekerja.

/casp

Status hanya-baca — agen membaca benang merah saat ini sebelum menulis satu baris pun.

/next

Mulai otomatis sesi berikutnya langsung dari state.next_prompt. Tanpa salin-tempel, tanpa menebak.

Bekerja dengan Claude Code · Cursor · Aider · Continue — apa pun yang membaca berkas.

09 / Untuk organisasi rekayasa

Saat agen berjalan tanpa pengawasan, penyimpangan menjadi masalah skala armada.

Satu agen yang salah bertindak menghabiskan satu sore. Seratus agen yang melakukannya di seratus repo menghabiskan satu kuartal. CASP adalah pagar pengaman deterministik yang Anda sisipkan ke dalam lingkar otomasi — bentuk yang sama di setiap proyek.

Pemeriksaan status CI yang wajib

casp check menempati slot yang sama dengan lint dan test. State yang berbohong tidak bisa di-merge — penyimpangan diblokir di tingkat organisasi, bukan dibiarkan pada disiplin siapa pun.

Pagar pengaman untuk armada agen

Agen otonom melipatgandakan kesalahan. CASP memberi setiap agen benang merah tervalidasi yang sama untuk dibaca dan gerbang tegas yang sama sebelum ia melakukan push. Otomasi tanpa pajak pekerjaan ganda.

Jejak audit, gratis

Setiap transisi state adalah commit git. Catatan lengkap, dapat di-diff, dapat dikembalikan tentang bagaimana setiap proyek bergerak — git log adalah jejak kepatuhan Anda.

Lolos infosec sejak rancangan

Sepenuhnya lokal, tanpa telemetri, tanpa cloud, tanpa akun. Tidak ada yang perlu ditinjau, tidak ada yang bisa diekstraksi. Tinjauan keamanannya satu baris: ia tidak pernah meninggalkan mesin.

.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

Satu protokol, setiap repo. Bentuk tervalidasi yang sama, di seluruh organisasi.

10 / Kontrak

Tegas dengan sengaja.

Sebuah protokol memperoleh adopsi dengan menjadi dapat diprediksi. Yang ini tidak menawar.

P01

Validasi state, bukan niat

CASP memeriksa apa adanya repo Anda sekarang, bukan apa yang Anda maksudkan. Fakta terhadap git, setiap kali.

P02

Templat adalah gerbang

Artefak kanonis ditegakkan, bukan disarankan. Setiap sesi keluar dengan bentuk yang sama.

P03

check sebelum setiap push

Validator tidak opsional. State yang berbohong tidak pernah sampai ke remote Anda.

P04

Tidak ada yang keluar dari mesin Anda

Deterministik, native git, sepenuhnya lokal. Tanpa telemetri. Tanpa cloud, tanpa akun, tanpa tagihan.

Rilis dalam dua menit

Beri setiap proyek benang merah yang tidak bisa hilang dari agen Anda.

Instal, init, dan agen Anda membaca kebenaran pada baris pertamanya.

  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