ECC – Biến AI coding agent thành một quy trình làm việc thực sự

AI coding agent ngày càng giỏi. Claude Code, Codex hay Cursor có thể đọc project, sửa code, chạy test và xử lý những task khá lớn. Nhưng dùng lâu sẽ thấy một vấn đề quen thuộc: model có thể thông minh, nhưng cách nó làm việc chưa chắc đã ổn định.

Có lúc agent lao vào code ngay khi chưa hiểu yêu cầu. Có lúc sửa xong nhưng quên chạy test. Có lúc một lỗi vừa xử lý hôm qua, sang session mới lại phải giải thích từ đầu.

ECC được tạo ra để giải quyết phần đó.

Thay vì cố cung cấp thêm một AI model mới, ECC xây một hệ thống làm việc bao quanh coding agent, để agent biết lúc nào nên lập kế hoạch, lúc nào cần test, review, kiểm tra bảo mật và lưu lại những gì đáng nhớ.

Triết lý của ECC khá dễ hiểu:

plan → test → implement → review → verify → remember → improve

Nói đơn giản hơn: thay vì cứ prompt rồi hy vọng AI làm đúng, ECC cố biến quá trình coding với AI thành một workflow có cấu trúc.

ECC có gì đáng chú ý?

Điểm mình thích ở ECC là nó không chỉ gom một bộ prompt vào GitHub rồi gọi đó là framework.

Project hiện cung cấp một hệ thống khá lớn gồm 71 agent, hơn 300 skill, gần 100 command, cùng hooks, rules, memory, continuous learning và AgentShield để kiểm tra các vấn đề liên quan tới prompt, permissions, secrets hay cấu hình agent.

Các agent được chia theo nhiệm vụ cụ thể như planning, architecture, security review, sửa build, review code hay xử lý những công việc theo domain.

Nhờ vậy, thay vì yêu cầu một agent duy nhất vừa phân tích, vừa code, vừa tự đánh giá chính code của mình, ECC có thể tách công việc thành nhiều bước rõ ràng hơn.

Đây cũng là phần tạo cảm giác khác biệt khi dùng với Claude Code: bạn đang xây một workflow cho agent, chứ không chỉ viết một prompt dài hơn.

Một workflow thực tế sẽ trông như thế nào?

Ví dụ bạn muốn thêm authentication vào project.

Thay vì nói:

Thêm authentication vào project này.

và để agent tự quyết định mọi thứ, với ECC bạn có thể bắt đầu bằng:

/ecc:plan "Thêm xác thực người dùng"

Agent sẽ ưu tiên hiểu project và lập kế hoạch trước khi thay đổi code.

Sau đó workflow có thể tiếp tục với implement, test, review và verify. Nếu trong quá trình đó xuất hiện một pattern hữu ích, ECC còn có cơ chế memory và continuous learning để biến những kinh nghiệm lặp lại thành context hoặc workflow tái sử dụng.

Với những project lớn, đây là thứ khá có giá trị. Prompt càng dài không đồng nghĩa agent càng làm việc tốt; nhiều khi thứ thiếu lại là quy trình.

Không chỉ dành cho Claude Code

Claude Code hiện là môi trường được ECC hỗ trợ tốt nhất, nhưng project cũng có hướng tích hợp cho Codex và Qoder, đồng thời cung cấp adapter cho Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen và một số agent harness khác.

Tuy nhiên mức hỗ trợ giữa các nền tảng không hoàn toàn giống nhau. Một số nơi chỉ dùng được một phần capabilities của ECC, nên nếu muốn trải nghiệm đầy đủ nhất thì Claude Code vẫn là lựa chọn hợp lý hơn ở thời điểm hiện tại.

Cài ECC

Cách đơn giản nhất hiện tại là sử dụng installer chính thức ecc-universal.

Bạn cần Node.js 18 trở lên. Nếu sử dụng Claude Code thì cần thêm Git và Claude Code 2.1 trở lên.

Chạy:

npx ecc-universal@2.2.3 setup

Installer sẽ hướng dẫn chọn môi trường, phạm vi cài đặt và cấu hình hooks phù hợp.

Nếu dùng pnpm, Yarn hoặc Bun cũng có thể chạy:

pnpm dlx ecc-universal@2.2.3 setup

yarn dlx ecc-universal@2.2.3 setup

hoặc:

bunx ecc-universal@2.2.3 setup

Sau khi hoàn tất với Claude Code, có thể kiểm tra plugin bằng:

/plugin list

và xác nhận ecc@ecc đã được bật.

Cài trực tiếp bằng Claude Code

Nếu thích cách đơn giản hơn, ECC cũng có thể được cài trực tiếp từ marketplace của Claude Code:

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Sau đó thử:

/ecc:plan "Thêm xác thực người dùng"

Một chi tiết dễ gây nhầm là project sử dụng ba tên khác nhau:

GitHub: affaan-m/ECC
Claude plugin: ecc@ecc
npm: ecc-universal

Đây là chủ ý của project chứ không phải ba package khác nhau.

Có thể cài nhẹ hơn không?

Có. Nếu không muốn ECC can thiệp quá sâu hoặc chỉ muốn agents, rules, commands và core workflow skills, project có profile minimal:

./install.sh --profile minimal --target claude

Trên Windows:

.\install.ps1 --profile minimal --target claude

Profile này không cài hooks-runtime, vì vậy phù hợp hơn nếu bạn muốn thử ECC nhưng chưa muốn thay đổi nhiều hành vi của Claude Code.

Một lưu ý rất quan trọng: đừng cài chồng nhiều kiểu

ECC hỗ trợ plugin, installer và cài thủ công, nhưng không nên dùng tất cả cùng lúc.

Ví dụ, nếu đã:

/plugin install ecc@ecc

thì không nên tiếp tục chạy full installer lên cùng cấu hình.

Việc cài chồng có thể khiến rules, skills hoặc hooks bị duplicate và làm hành vi của agent khó đoán hơn. README của project cũng nhấn mạnh nên chọn một phương thức cài đặt chính.

Nếu muốn bổ sung rules cho plugin Claude Code, tốt hơn nên chỉ copy riêng những rule pack mình thực sự cần, chẳng hạn common hoặc typescript.

Khi nào ECC thực sự hữu ích?

Nếu bạn chỉ thỉnh thoảng nhờ AI sửa vài dòng code, ECC có thể hơi dư.

Nhưng khi bắt đầu giao cho agent những task kiểu:

đọc codebase → phân tích → sửa nhiều file → chạy test → sửa lỗi → review → commit

thì một workflow có cấu trúc bắt đầu đáng giá hơn rất nhiều.

ECC đặc biệt thú vị với những người đang dùng Claude Code hoặc các coding agent gần như một thành viên trong workflow phát triển hằng ngày. Nó giúp chuyển câu hỏi từ:

“Prompt thế nào để AI code tốt hơn?”

sang:

“Làm thế nào để AI có một quy trình engineering tốt hơn?”

Đó cũng là điểm mình thấy hấp dẫn nhất ở project này.

Một vài điểm cần lưu ý

ECC là một hệ thống khá lớn. Cài càng nhiều agent, hook, rule và skill thì càng nên hiểu chúng đang tác động vào workflow như thế nào.

Project cũng khuyến cáo chỉ cài ECC từ các nguồn chính thức như repository affaan-m/ECC, package ecc-universal, ecc-agentshield, plugin ecc@ecc hoặc website của project. Các bản mirror hoặc package re-upload bên ngoài không được project kiểm tra.

Nếu ECC hoạt động không đúng hoặc trước đó đã cài chồng nhiều lần, project có sẵn lệnh kiểm tra và gỡ cài đặt:

node scripts/ecc.js doctor

hoặc preview trước khi uninstall:

node scripts/uninstall.js --dry-run

rồi mới thực sự gỡ:

node scripts/uninstall.js

Có nên thử ECC?

Nếu đang dùng Claude Code thường xuyên, mình nghĩ ECC là một project đáng thử.

Không phải vì nó giúp model “thông minh hơn” một cách thần kỳ, mà vì nó giải quyết một vấn đề thực tế hơn: AI coding agent cần một cách làm việc tốt, không chỉ cần một model tốt.

Với những project nhỏ, bạn có thể bắt đầu bằng profile nhẹ hoặc chỉ cài plugin. Với codebase lớn hơn, những thứ như planning, verification, specialized agents, memory và reusable skills mới bắt đầu thể hiện rõ giá trị.

ECC vẫn là dự án mã nguồn mở theo giấy phép MIT, vì vậy có thể cài thử, xem cách nó tổ chức workflow và chỉ giữ lại những phần phù hợp với cách mình làm việc.

GitHub: https://github.com/affaan-m/ECC