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.

CASP giữ một bức tranh luôn đúng về nơi từng dự án của bạn thực sự đang đứng — ở bất kỳ thời điểm nào, được kiểm chứng với git. Quay lại sau một tuần hay sau nhiều tháng, trên bất kỳ stack nào, qua bất kỳ số lượng tác tử, phiên hay đồng đội nào: mở ra và trạng thái là đúng — hoặc casp check khóa lệnh push cho đến khi nó đúng.

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

CASP là nền tảng tất định của vòng lặp tự kiểm chứng — phép kiểm duy nhất trong "hãy kiểm tra công việc của bạn" mà không phải là mô hình tự kiểm tra chính nó: trạng thái đối chiếu với git, ngay tại ranh giới push, nơi phép kiểm bên trong vòng lặp không thể chạm tới. 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 dự án nào xác minh rằng trạng thái đã lưu vẫn còn khớp với git. Phép kiểm đó chính là casp check — 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 / Lên kế hoạch một lần, ra mắt theo từng lát

Bạn viết kế hoạch một lần. Tác tử của bạn hỏi việc kế tiếp.

Biến bản đặc tả của bạn thành một hàng đợi các prompt phiên — mỗi prompt là một tệp trong kho mã của bạn, khai báo cái gì đứng trước nó. casp next trao cho tác tử của bạn phần đầu hàng đợi đó, và từ chối trao một lát đã hoàn thành.

casp next chỉ in ra prompt. Nó không bao giờ chạy prompt — tác tử của bạn mới chạy. CASP là phần khiến việc bàn giao đáng tin cậy, không phải một bộ điều phối.

docs/plan/sessions/ — hàng đợi 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

Ở cuối mỗi phiên, tác tử của bạn bổ sung nhật ký, cập nhật trạng thái và soạn prompt kế tiếp trong hàng đợi — bạn chỉnh một dòng thay vì viết từ đầu. Và bảng phase vẫn nằm trong roadmap.md, để bất kỳ tác tử nào cũng biết thứ tự công việc.

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