ECC: Biến AI coding agent thành "chiến binh" thực thụ với bộ kỹ năng hoàn chỉnh

Bạn đang dùng Claude Code, Cursor, hay Codex để code hàng ngày? Mình cũng vậy. Và mình dám cá là bạn cũng từng gặp cảnh này: agent viết code sai context, quên mất convention của project, hoặc cứ lặp đi lặp lại cùng một lỗi mà bạn đã sửa hôm qua. Vấn đề không phải AI dở vấn đề là chúng ta chưa cho nó một hệ thống vận hành đủ tốt.

Đó là lý do ECC ra đời. Và sau khi vọc thử, mình thấy đây là một trong những project đáng chú ý nhất cho ai đang làm việc nghiêm túc với AI coding agent.

ECC là gì và tại sao bạn nên quan tâm?

ECC (viết tắt không chính thức, repo gốc tại affaan-m/ECC) tự mô tả là "the harness-native operator system for agentic work". Nghe hơi trừu tượng, nhưng bản chất nó là thế này:

Thay vì chỉ có một file CLAUDE.md hay vài dòng system prompt rồi hy vọng agent hiểu, ECC cung cấp một hệ thống hoàn chỉnh gồm:

• Skills: Các kỹ năng được định nghĩa rõ ràng mà agent có thể gọi
• Instincts: Những "phản xạ" tự động agent biết phải làm gì trước khi bạn hỏi
• Memory optimization: Agent nhớ context, convention, và quyết định trước đó
• Security scanning: Tự động quét lỗ hổng bảo mật trong code
• Hooks: Các hook chạy trước/sau khi agent thực thi
• Rules: Bộ quy tắc cho từng harness cụ thể
• MCP configurations: Config sẵn cho Model Context Protocol

Điều mình thấy hay là project này không phải kiểu "nghĩ ra rồi viết docs đẹp". Nó được phát triển qua 10+ tháng sử dụng thực tế hàng ngày để build sản phẩm thật. 202K stars trên GitHub không phải tự nhiên mà có.

Hỗ trợ những harness nào?

Đây là điểm mạnh lớn nhất của ECC nó không lock bạn vào một tool duy nhất:

Theo kinh nghiệm của mình, việc switch giữa các AI agent là chuyện bình thường. Tuần này dùng Claude Code, tuần sau thử Codex, rồi quay lại Cursor. Có một bộ config chung chạy được trên tất cả giúp tiết kiệm rất nhiều thời gian setup.

Cách cài đặt và bắt đầu

Bước 1: Clone repo

1git clone https://github.com/affaan-m/ECC.git
2cd ECC

Bước 2: Chạy script cài đặt

Trên macOS/Linux:

1./install.sh

Trên Windows:

1.\install.ps1

Script sẽ tự detect bạn đang dùng harness nào và setup tương ứng.

Bước 3: Copy config vào project của bạn

Đây là bước quan trọng nhất. Bạn cần copy các thư mục config phù hợp vào root của project:

1# Ví dụ cho Claude Code
2cp -r ECC/.claude/ your-project/.claude/
3cp ECC/CLAUDE.md your-project/CLAUDE.md
4
5# Ví dụ cho Cursor
6cp -r ECC/.cursor/ your-project/.cursor/
7
8# Hoặc copy tất cả nếu bạn dùng nhiều harness
9cp -r ECC/.claude/ ECC/.cursor/ ECC/.codex/ your-project/

Bước 4: Customize rules và skills

Mở thư mục rules/ và skills/ để điều chỉnh cho phù hợp với project:

1# Xem cấu trúc skills
2ls skills/
3
4# Xem rules có sẵn
5ls rules/

Mình khuyên bạn nên đọc qua file CLAUDE.md hoặc AGENTS.md trong repo để hiểu cách ECC tổ chức context cho agent. Đây là nơi "phép màu" xảy ra.

Cấu trúc thư mục đáng chú ý

Repo khá lớn với gần 2000 commits, nhưng bạn chỉ cần quan tâm những phần chính:

Hooks Thứ mình thấy hữu ích nhất

Trong tất cả features, hooks là thứ mình dùng nhiều nhất. Hooks cho phép bạn chạy script tự động trước hoặc sau khi agent thực hiện một action.

Ví dụ thực tế:

1# Hook chạy trước khi agent commit
2pre-commit:
3  - run: "npm run lint"
4  - run: "npm run test -- --changed"
5
6# Hook chạy sau khi agent tạo file mới  
7post-create-file:
8  - run: "prettier --write {{file}}"

Điều này giải quyết một pain point rất lớn: agent hay tạo code không theo convention hoặc quên chạy lint. Với hooks, bạn enforce được quality gate mà không cần nhắc đi nhắc lại.

Security scanning tích hợp

Một điểm mình đánh giá cao là ECC tích hợp security scanning ngay trong workflow. Thay vì để agent viết code xong rồi mới review security, hệ thống sẽ:

1. Scan code ngay khi agent tạo hoặc sửa file
2. Flag các pattern nguy hiểm (hardcoded secrets, SQL injection, etc.)
3. Suggest fix trước khi code được commit

Bạn có thể đọc chi tiết trong file the-security-guide.md ở root repo.

Một vài tips từ kinh nghiệm thực tế

Đừng copy tất cả mọi thứ. Repo rất lớn và bạn sẽ overwhelm nếu cố dùng hết. Bắt đầu với:

1. File CLAUDE.md (hoặc AGENTS.md) copy vào project
2. Thư mục rules/ chọn rules phù hợp
3. Thư mục hooks/ setup basic hooks

Đọc file TROUBLESHOOTING.md trước khi hỏi. Rất nhiều edge case đã được document sẵn.

Dùng COMMANDS-QUICK-REF.md như cheat sheet. File này liệt kê tất cả commands có sẵn, rất tiện khi mới bắt đầu.

Cẩn thận với file .env.example. Copy thành .env và fill đúng API keys. Đừng commit file .env lên git dù nghe hiển nhiên nhưng mình đã thấy nhiều người mắc lỗi này.

Ai nên dùng ECC?

Điều mình muốn nói thêm

Thành thật mà nói, khi mới nhìn repo này mình hơi hoài nghi 202K stars, 28K forks, nghe quá "khủng" cho một project về config. Nhưng sau khi đào sâu, mình hiểu tại sao. ECC không chỉ là config nó là một hệ tư tưởng về cách làm việc với AI agent.

Cái hay nhất là triết lý "research-first development". Mỗi quyết định trong ECC đều có research backing, không phải kiểu "mình thấy hay thì thêm vào". Thư mục research/ chứa đầy đủ findings và reasoning.

Nếu bạn đang dùng bất kỳ AI coding agent nào và muốn nâng level workflow lên, hãy dành 30 phút clone repo về, đọc README, và thử apply vài rules + hooks vào project hiện tại. Mình nghĩ bạn sẽ thấy sự khác biệt ngay từ ngày đầu tiên.

Repo: github.com/affaan-m/ECC