Coding-Agent State Protocol

Mô hình giữ ngữ cảnh. CASP chứng minh trạng thái là đúng — đối chiếu với git.

Các mô hình mới vận hành toàn bộ lộ trình của bạn suốt nhiều giờ, thậm chí nhiều ngày, mà không đánh mất mạch việc. Chính vì thế độ lệch trạng thái lại càng quan trọng hơn, chứ không kém đi: một tác tử làm càng nhiều giữa các điểm kiểm soát của bạn, thì trạng thái nó ghi lại càng dễ âm thầm ngừng khớp với git. casp check là cổng chặn tất định khóa lệnh push ngay khi điều đó xảy ra — với Claude Code hôm nay, và mọi mô hình ra mắt sau này.

Kiểm tra tiền chuyến bay + hộp đen cho các phiên lập trình bằng AI
$npm i -g @justethales/casp sao chép
Xem trên GitHub
casp check — bộ kiểm chứng độ lệch
01 / Mạch việc bạn cứ liên tục đánh mất

Một tệp trạng thái lỗi thời khiến tác tử của bạn sai một cách đầy tự tin.

Bạn quay lại một dự án sau một tuần — hoặc bạn cùng lúc xoay xở năm dự án. Tác tử đọc một tệp trạng thái không còn khớp với thực tế, tự tin bắt tay vào phần việc đã hoàn thành từ trước, và bạn mất cả một buổi chiều để gỡ lại.

Bảng, thẻ và bảng tính không cứu được bạn: tái dựng ngữ cảnh là thủ công, và tác tử không thể đọc được gì trong đó cả. Trạng thái cần đọc được bằng máy, thuần git — và đúng một cách có thể chứng minh.

CASP cho mỗi dự án một mạch việc duy nhất tồn tại xuyên suốt các phiên — và không thể âm thầm lệch đi.
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 / Điểm khác biệt quyết định

Ai cũng lưu trữ ngữ cảnh. CASP kiểm chứng nó.

Không gian lân cận — Mem0, Letta, Zep, các dự án "bộ nhớ" thuần git mới — đều lưu trữ những gì đã xảy ra. Gần như không có dự án nào xác minh rằng trạng thái đã lưu vẫn còn khớp với thực tế của git. Việc xác minh đó chính là casp check — và nó là bắt buộc trước mỗi lần push.

độ lệch next-prompt
phát hiện

next_prompt của bạn trỏ tới một tệp đã hoàn thành — hoặc không tồn tại. CASP từ chối khởi động sai phiên.

sự thật gốc của git
cưỡng chế

last_commit vắng mặt trong lịch sử, danh sách migration lệch nhịp, trạng thái chưa commit — được đối chiếu với chính git, không phải một phỏng đoán.

push, bị chặn
tất định

Không có điểm tương đồng mơ hồ. Một cổng pass/fail cứng rắn, lặp lại được, chặn lệnh push chừng nào trạng thái còn nói dối.

03 / Bên cạnh stack hiện có của bạn

Git, PR và CI không biết điều gì sẽ ra mắt tiếp theo.

CASP không thay thế bất cứ thứ gì trong quy trình của bạn. Nó lấp đúng khoảng trống duy nhất mà không công cụ nào khác bao phủ — thì hiện tại đã được kiểm chứng của một dự án, dưới một dạng mà tác tử của bạn có thể đọc và hành động theo.

Jira · Linear
Ý định
Những gì bạn dự định làm.
Lệch khỏi thực tế, sống trên cloud, tác tử của bạn không thể đọc một cách đáng tin cậy.
CASP
Hiện tại đã kiểm chứng
Dự án đang đứng ở đâu ngay lúc này — và bước kế tiếp chính xác, được chứng minh đối chiếu với git.
Đọc được bằng máy, nằm trong repo, tất định. Mạch việc duy nhất mà các tác tử hành động theo.
git · PR · CI
Lịch sử & xác minh
Cái gì đã thay đổi · đã được review chưa · có build được không.
Một bản ghi hoàn hảo về quá khứ — và im lặng về những gì sắp tới.
04 / Ba tệp. Một mạch việc.

Toàn bộ giao thức gói gọn trong repo của bạn.

Không cơ sở dữ liệu. Không dịch vụ. Không kho vector. Ba tệp đơn giản mà một tác tử có thể đọc ngay từ dòng đầu tiên của bất kỳ phiên nào.

state.json
nguồn sự thật

Đọc được bằng máy, theo từng dự án: phase hiện tại, phase kế tiếp, next-prompt chính xác cần thực thi, các phase đã hoàn thành, các migration đã áp dụng, commit cuối, mã phiên cuối.

now.md
dành cho con người

Bản "tôi đang ở đâu lúc này" gọn trong một màn hình. Mở ra, lấy lại mạch việc trong năm giây — không cần đào bới.

roadmap.md
điều ra mắt tiếp theo

Ba việc kế tiếp cần ra mắt cùng một bảng điểm các phase. Tác tử luôn biết thứ tự công việc.

Mẫu là cổng chặn, không phải gợi ý.  Các mẫu chuẩn session-prompt, session-logaudit-brief khiến mỗi phiên — dù là người hay tác tử — đều tạo ra các sản phẩm cùng một hình dạng. Cấu trúc được cưỡng chế, không phải đề xuất.
05 / Thiết kế cho những lộ trình lớn

Một mạch việc có thứ tự duy nhất trải khắp bốn mươi phase — web lẫn mobile.

Một sản phẩm thực thụ không phải là một tính năng. Đó là hàng chục phase trải khắp API, client web và mobile, ra mắt suốt nhiều tuần bởi các phiên và các tác tử thay phiên nhau. CASP duy trì một thứ tự đã kiểm chứng duy nhất trên toàn bộ — để bất kỳ tác tử nào cũng biết phase nào là kế tiếp, và không bao giờ ra mắt lại một phase đã hoàn thành.

Và vòng lặp tự khép lại: ở cuối mỗi phiên, tác tử viết sẵn prompt của phiên kế tiếp cho bạn — bạn chỉnh một dòng, bạn không phải soạn từ đầu — bổ sung một nhật ký phiên, và cập nhật trạng thái. Mở phiên kế tiếp và nó tiếp tục đúng chỗ phiên trước dừng lại. Lộ trình tự thực thi; bạn giám sát.

roadmap.md — bảng điểm các phase 13 đã ra mắt 22 tổng cộng
10apiEngine đồng bộ thời gian thựcđã ra mắt
11mobileThông báo đẩyđã ra mắt
12mobileBộ đệm ưu tiên ngoại tuyếnđã ra mắt
13webPhân quyền nhómđã ra mắt
15apiTính phí theo chỗ ngồichờ xử lý
16mobileĐăng nhập sinh trắc họcchờ xử lý
/ Đang chạy thực tế

Không phải bản demo. Hai sản phẩm đang vận hành trên CASP ngay hôm nay.

Mọi con số bên dưới được đọc trực tiếp từ state.json của từng dự án — chính tệp mà tác tử đọc, được kiểm chứng đối chiếu với git ở lần push cuối. Không có phép tính tiếp thị nào.

LIVE

Một ERP quản lý đội xe hướng tới khách hàng cho một công ty vận tải ở Bờ Biển Ngà — web + mobile, đa mô-đun, đa vai trò: tài xế, phương tiện, tuân thủ, quỹ tiền, gara, tranh chấp, kế toán.

25+
phase đã ra mắt
20+
migration được theo dõi
6
phiên trong một ngày

Mỗi mô-đun là một phase đã kiểm chứng. Tác tử đọc cockpit, chạy phase kế tiếp từ next_prompt, và chưa từng ra mắt lại một mô-đun đã hoàn thành — kể cả trong một ngày sáu phiên.

LIVE

Nền tảng nội bộ vận hành & điều phối ra mắt của ZeroSuite — một lộ trình kéo dài nhiều tháng do một nhóm thực thụ thực hiện, với cổng chặn theo chế độ ra mắt và một backlog hậu ra mắt được theo dõi.

41
phase đã ra mắt
17
migration
3
người vận hành

Một mạch việc đã kiểm chứng duy nhất trải khắp 40+ phase và ba người — cùng 58 hạng mục được hoãn lại một cách rõ ràng sau ra mắt, không mất hạng mục nào. Đây chính là trường hợp "dự án lớn nhiều người dùng" mà CASP được tạo ra để phục vụ.

Cùng một giao thức, hai sản phẩm rất khác nhau. Cockpit là thứ duy nhất chúng cùng chia sẻ.

06 / Là trạng thái, không phải bộ nhớ

CASP không phải là một lớp bộ nhớ cho AI.

Các công cụ bộ nhớ ghi nhớ bạn là ai. CASP theo dõi dự án của bạn đang đứng ở đâu — và chứng minh điều đó. Sản phẩm khác nhau, thao tác khác nhau, sự cố mà nó ngăn chặn cũng khác nhau.

CASP
Các lớp bộ nhớ · Mem0 / Letta / "soul" thuần git
Nó giữ gì
Trạng thái thực thi của dự án
Thông tin & sở thích của người dùng
Thao tác cốt lõi
Kiểm chứng đối chiếu với git
Lưu trữ & gọi lại
Khi có xung đột
Kiểm tra tất định đối chiếu với sự thật gốc
Phỏng đoán tương đồng mơ hồ
Khi nào nó chạy
Cổng đồng bộ — khóa lệnh push
Gọi lại bất đồng bộ / về sau
Rời khỏi máy của bạn
Không bao giờ · không gửi dữ liệu đo lường
Tùy / cloud
07 / Bàn điều khiển lệnh

Năm động từ. Gõ chẳng tốn công.

Một âm tiết, không từ đồng tự, giống hệt nhau trong tiếng Anh, tiếng Pháp hay tiếng Tây Ban Nha.

casp initCài đặt lớp liên tục vào bất kỳ repo nào.
casp statusẢnh chụp nhanh trong một màn hình: phase, kế tiếp, những gì đã ra mắt.
casp checkBộ kiểm chứng độ lệch. Bắt buộc trước mỗi lần push.
casp nextTự động khởi động phiên kế tiếp từ state.next_prompt.
casp new promptTạo một session-prompt có cổng chặn từ mẫu chuẩn.
casp new logMở một session-log theo hình dạng mà mọi phiên cùng chia sẻ.
08 / Trong trình soạn thảo của bạn

Các slash-command gốc cho tác tử của bạn.

CASP cung cấp các slash-command Claude Code để trạng thái sống ngay nơi bạn vốn đã làm việc.

/casp

Trạng thái chỉ đọc — tác tử đọc mạch việc hiện tại trước khi viết một dòng nào.

/next

Tự động khởi động phiên kế tiếp ngay từ state.next_prompt. Không sao chép-dán, không phỏng đoán.

Hoạt động với Claude Code · Cursor · Aider · Continue — bất cứ thứ gì đọc được tệp.

09 / Cho các tổ chức kỹ thuật

Khi các tác tử chạy không giám sát, độ lệch trở thành vấn đề của cả đội.

Một tác tử làm sai một việc tốn một buổi chiều. Một trăm tác tử làm sai trên một trăm repo tốn cả một quý. CASP là rào chắn tất định mà bạn cài vào vòng lặp tự động hóa — cùng một hình dạng trong mọi dự án.

Một kiểm tra trạng thái CI bắt buộc

casp check chiếm cùng vị trí với lint và test. Một trạng thái nói dối thì không thể merge — độ lệch bị chặn ở cấp tổ chức, không phó mặc cho ý thức kỷ luật của bất kỳ ai.

Một rào chắn cho các đội tác tử

Các tác tử tự hành nhân lên các sai lầm. CASP trao cho từng tác tử cùng một mạch việc đã kiểm chứng để đọc và cùng một cổng chặn cứng rắn trước khi nó push. Tự động hóa mà không phải trả cái giá của việc làm trùng lặp.

Một dấu vết kiểm toán, miễn phí

Mỗi lần chuyển trạng thái là một commit git. Một bản ghi đầy đủ, so sánh được, hoàn tác được về cách mỗi dự án đã tiến triển — git log chính là dấu vết tuân thủ của bạn.

Vượt qua kiểm duyệt bảo mật ngay từ thiết kế

Chạy hoàn toàn cục bộ, không gửi dữ liệu đo lường, không cloud, không tài khoản. Chẳng có gì để thẩm định, chẳng có gì để rò rỉ ra ngoài. Bản đánh giá bảo mật gói gọn trong một dòng: nó không bao giờ rời khỏi máy.

.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

Một giao thức, mọi repo. Cùng một hình dạng đã kiểm chứng, trên toàn tổ chức.

10 / Bản giao kèo

Quan điểm rõ ràng, một cách có chủ đích.

Một giao thức giành được sự áp dụng bằng cách có thể đoán trước. Những điều này không lay chuyển.

P01

Kiểm chứng trạng thái, không phải ý định

CASP kiểm tra những gì repo của bạn đang là, không bao giờ là điều bạn định làm. Sự thật đối chiếu với git, mọi lúc.

P02

Mẫu là cổng chặn

Các sản phẩm chuẩn được cưỡng chế, không phải đề xuất. Mỗi phiên ra lò với cùng một hình dạng.

P03

check trước mỗi lần push

Bộ kiểm chứng không phải tùy chọn. Một trạng thái nói dối không bao giờ đến được remote của bạn.

P04

Không gì rời khỏi máy của bạn

Tất định, thuần git, chạy hoàn toàn cục bộ. Không gửi dữ liệu đo lường. Không cloud, không tài khoản, không hóa đơn.

Chạy thực tế trong hai phút

Cho mỗi dự án một mạch việc mà tác tử của bạn không thể đánh mất.

Cài đặt, khởi tạo, và tác tử của bạn đọc được sự thật ngay từ dòng đầu tiên.

  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