ECC: đưa AI coding agent vào quy trình plan → test → review
ECC là bộ khung vận hành cho AI coding agent, hướng tới quy trình lập kế hoạch, kiểm thử, triển khai, review, xác minh và lưu lại kiến thức. Dự án mã nguồn mở MIT, hỗ trợ tốt nhất cho Claude Code và có các đường tích hợp khác.
AI coding agent có thể viết code, nhưng code chỉ là một phần của công việc kỹ thuật. Phần còn lại là lập kế hoạch, kiểm thử, tự rà soát thay đổi, xác minh kết quả và giữ lại kiến thức cho lần sau.
ECC nhắm vào lớp quy trình đó. Dự án tự mô tả là một hệ thống “agent harness” — có thể hiểu là bộ khung vận hành cho coding agent — dành cho Claude Code, Codex, OpenCode, Cursor và các công cụ khác.
Thay vì phải lặp lại cùng một bộ instruction trong mỗi phiên, ECC hướng tới việc biến quy trình kỹ thuật thành một phần thường trực trong cách agent làm việc với repository.
Chuỗi workflow mà ECC đặt làm trung tâm
README của dự án đưa ra chuỗi:
text
plan -> test -> implement -> review -> verify -> remember -> improve
Tức là agent không chỉ được hướng đến việc tạo diff, mà còn cần đi qua các bước:
Plan: lập kế hoạch trước khi xây dựng.
Test: kiểm thử thay đổi.
Implement: triển khai.
Review: tự rà soát công việc, kể cả từ context mới.
Verify: xác minh kết quả.
Remember: lưu lại điều quan trọng.
Improve: biến các kết quả lặp lại thành kỹ năng hoặc workflow có thể tái sử dụng.
Đây là điểm khác với cách giao việc một lần kiểu “sửa bug này”. Trong mô hình của ECC, quy ước repository, quyết định kỹ thuật và bài học từ tác vụ trước là những thứ nên được lưu lại, thay vì liên tục đưa lại vào context của model.
Khẩu quyết của dự án là:
> Optimize the context window. Persist everything else.
Có thể hiểu ngắn gọn: context window là tài nguyên hữu hạn của phiên làm việc hiện tại; còn những kiến thức hữu ích cho repo nên được duy trì theo cách bền vững hơn.
ECC có những lớp nào?
ECC giới thiệu các thành phần xoay quanh:
Skills: đóng gói cách làm có thể tái sử dụng.
Instincts: đưa các thói quen xử lý vào agent harness.
Memory: lưu lại điều cần nhớ.
Security: đưa yếu tố an toàn vào quy trình làm việc với agent.
Research-first development: ưu tiên tìm hiểu trước khi sửa lỗi hoặc xây tính năng.
Điểm cần lưu ý: ECC không thay thế model, IDE hay nền tảng coding agent. Nó là lớp tổ chức quy trình và công cụ xung quanh các hệ thống đó.
Hỗ trợ Claude Code, Codex, Cursor đến đâu?
Theo README, ECC hoạt động tốt nhất với Claude Code ở thời điểm hiện tại.
Dự án cũng nêu:
Có đường plugin native cho Codex và Qoder.
Có adapter giới hạn năng lực cho Cursor, OpenCode, Gemini và Zed.
Vì vậy, nếu đội ngũ dùng nhiều coding agent, không nên mặc định mọi client đều có cùng mức tích hợp. “Adapter giới hạn năng lực” cho thấy trải nghiệm hoặc khả năng sử dụng có thể khác với đường tích hợp native.
Cài đặt: chọn một luồng, đừng chồng cấu hình
Với Claude Code, README đưa ra hai cách:
Guided setup
Native plugin commands
Cả hai đều cài cùng plugin:
text
ecc@ecc
Khuyến nghị của dự án là chọn một cách cài đặt, không chồng thêm một bản cài Claude thủ công đầy đủ lên trên. Đây là điều đáng kiểm tra trước khi thử nghiệm, đặc biệt nếu repository đã có sẵn instruction, hook hoặc cấu hình agent riêng.
README cũng cảnh báo chỉ nên cài ECC từ các kênh chính thức:
Repository github.com/affaan-m/ECC
npm package ecc-universal
npm package ecc-agentshield
GitHub App ECC Tools
Plugin ecc@ecc
Website ecc.tools
Dự án nói các bản re-upload hoặc mirror không chính thức không được duy trì hay rà soát, và có thể chứa mã độc.
Một cách thử trên repository thật
Không cần bắt đầu bằng một thay đổi lớn. Hãy chọn một issue nhỏ, có phạm vi rõ ràng và có thể kiểm thử.
Sau đó đánh giá agent theo cả vòng đời công việc:
Agent có xác định được phạm vi và hướng xử lý không?
Có nêu hoặc chuẩn bị được cách kiểm thử hành vi cần sửa không?
Diff có nhỏ gọn, đúng trọng tâm không?
Có bước review lại thay đổi không?
Có xác minh bằng các kiểm tra sẵn có của repository không?
Có kiến thức nào từ tác vụ nên được lưu lại cho lần sau không?
Ví dụ với lỗi validation, đầu ra hữu ích không chỉ là một điều kiện if mới. Nó còn có thể gồm mô tả nguyên nhân, kiểm thử thể hiện lỗi, bản sửa tối thiểu và ghi chú về quy tắc validation cần nhớ.
Mã nguồn mở, nhưng cần tách bạch chi phí
ECC được phát hành theo giấy phép MIT. README cho biết phần OSS vẫn miễn phí.
Dự án cũng có ECC Pro dưới dạng GitHub App lưu trữ cho private repository. Trang README ghi mức giá private repo từ 19 USD/ghế/tháng.
Tuy nhiên, “OSS miễn phí” không đồng nghĩa toàn bộ chi phí dùng coding agent bằng không. Chi phí của model, nền tảng AI hoặc các dịch vụ liên quan vẫn phụ thuộc vào công cụ mà đội ngũ đang dùng.
Với private repository, nên đọc kỹ cấu hình và quyền truy cập của GitHub App trước khi kết nối với mã nguồn nội bộ. Phần tài liệu được cung cấp không nêu chi tiết phạm vi quyền của ứng dụng.
Checklist trước khi áp dụng rộng
[ ] Chọn một luồng cài đặt Claude Code, không chồng nhiều cách cài.
[ ] Bắt đầu bằng tác vụ nhỏ, có thể kiểm thử.
[ ] Đánh giá cả kế hoạch, test, diff, review và bước xác minh.
[ ] Xác định kiến thức nào của repo cần được lưu lại.
[ ] Phân biệt native integration với adapter giới hạn năng lực.
[ ] Chỉ dùng plugin, package và GitHub App từ nguồn chính thức.
ECC phù hợp để thử khi vấn đề của team không còn là “agent có viết được code hay không”, mà là làm sao để agent tham gia vào một quy trình kỹ thuật có kiểm tra, có ghi nhớ và có thể lặp lại.