# Compound Engineering: AI học từ mỗi lần code, lần sau làm nhanh hơn — hướng dẫn cài đặt và dùng

> Compound Engineering là plugin gồm 38 skill cho các AI coding agent như Claude Code, Cursor, Codex. Nó chia công việc thành một vòng lặp: brainstorm, plan, work, review và ghi lại bài học vào tài liệu trong repo. Với Claude Code, cài chỉ cần hai lệnh trong khung chat.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-15 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/compound-engineering-plugin-huong-dan-cai-dat-va-dung

Compound Engineering là một plugin gồm 38 skill dành cho AI coding agent (Claude Code, Cursor, Codex và nhiều công cụ khác). Mỗi skill là một quy trình làm việc dựng sẵn: nghĩ yêu cầu, lập kế hoạch, code, review. Điểm riêng của nó là bước cuối: **ghi lại điều đã học** vào tài liệu trong dự án, để lần sau AI đọc được và không phải học lại từ đầu.

Vấn đề repo này nhắm tới rất quen với ai từng dùng AI để code. Mỗi lần bạn mở một phiên chat mới, AI quên hết bài học của lần trước. Bạn lại giải thích lại, lại sửa đúng lỗi cũ. Plugin xử lý việc đó bằng cách ép quy trình có một vòng lặp, và bước cuối của vòng là ghi bài học vào thư mục `docs/solutions/`. Lần brainstorm và lập kế hoạch tiếp theo sẽ đọc lại thư mục này.

Repo hiện có khoảng 26.055 sao và 2.067 fork, giấy phép MIT, do Kieran Klaassen và Trevin Chow duy trì cùng cộng đồng. Nó hợp với lập trình viên mới muốn có quy trình bài bản, và với người làm sản phẩm dùng AI để code thường xuyên. Nếu bạn chỉ cần hỏi AI một câu code lẻ, plugin này hơi thừa.

```repo
- repo | EveryInc/compound-engineering-plugin
- kind | Plugin
- desc | Plugin gồm 38 skill cho AI coding agent: lên ý tưởng, lập kế hoạch, code, review rồi ghi lại bài học để lần sau làm nhanh hơn.
- stars | 26k
- lang | TypeScript
- license | MIT
```

## Compound Engineering làm được gì

Triết lý của repo là mỗi đơn vị công việc phải làm cho đơn vị sau dễ hơn, không khó hơn. README mô tả tỷ lệ khoảng 80% thời gian dành cho lập kế hoạch và review, 20% cho thực thi. Các skill chính xoay quanh vòng lặp sáu bước:

- **`/ce-brainstorm`**: hỏi đáp tương tác để nghĩ rõ tính năng hay vấn đề, rồi viết ra bản yêu cầu. Bạn không phải tự nghĩ hết trước khi bắt đầu.
- **`/ce-plan`**: biến ý tưởng hoặc bản yêu cầu thành kế hoạch đủ chi tiết để bắt tay làm.
- **`/ce-work`**: thực hiện theo kế hoạch, giữ phần kiểm tra, commit và giao nộp ở phía công cụ chủ.
- **`/ce-simplify-code`**: gọt lại code vừa viết, bỏ test và comment thừa trước khi review.
- **`/ce-code-review`**: review nhiều agent so với kế hoạch trước khi merge. Mặc định chỉ báo cáo, việc áp dụng sửa trên máy phải do bạn chọn.
- **`/ce-compound`**: ghi bài học vào `docs/solutions/` cho vòng sau.

Ngoài vòng lặp chính còn nhiều skill dùng khi cần:

- **`/ce-debug`** khi bắt đầu từ một lỗi chứ không phải tính năng.
- **`/ce-ideate`** khi bạn chưa biết nên làm gì.
- **`/ce-explain`** để hỏi một hành vi trong code hoạt động thế nào và vì sao tồn tại.
- **`/ce-pov`** để xin một khuyến nghị.
- **`/ce-doc-review`** để review tài liệu.
- Nhóm Git: `ce-commit`, `ce-commit-push-pr`, `ce-babysit-pr`, `ce-resolve-pr-feedback`, `ce-worktree`.
- Nhóm kiểm thử: `ce-test-browser`, `ce-test-xcode`.
- Skill **`/ce-help`** để hỏi nên chạy skill nào tiếp theo.
- Skill **`/lfg`** chạy cả quy trình gần như không cần bạn can thiệp.

Repo còn có tính năng thử nghiệm Compound Packs: các thư mục quy tắc dùng chung cho nhiều repo (quy ước nhóm, chính sách bảo mật), để lập kế hoạch dựa vào và review kiểm tra theo. README ghi rõ đây là tính năng experimental.

## Cần chuẩn bị gì

Tư liệu README (phần mình có) nói khá ít về yêu cầu hệ thống, nên mình chỉ nêu những gì có:

- Một công cụ AI coding được hỗ trợ đã cài sẵn: Claude Code, Cursor, Codex (app hoặc CLI), hoặc một trong các công cụ khác như Kimi Code CLI, Cline, Grok Build CLI, Devin CLI, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi.
- Một dự án (thư mục code) để chạy skill. Skill ghi tài liệu vào thư mục `docs/` của dự án.
- Với Codex CLI: lệnh `codex` phải chạy được. Với Cline: cần `git` để clone repo.

README phần đã đọc không ghi yêu cầu phiên bản Node hay Python, cũng không nói cần API key riêng cho plugin. Công cụ chủ của bạn (Claude Code, Cursor...) có thể có yêu cầu tài khoản riêng, bạn xem tài liệu của chúng. Repo có thư mục `docs/` và trang chủ https://every.to/compound-engineering nếu cần đọc thêm.

## Cài đặt từng bước

Vì plugin chạy trên nhiều công cụ, mình hướng dẫn kỹ đường Claude Code (đường đầu tiên trong README), rồi nêu nhanh Cursor và Codex.

```steps
- Mở công cụ | Mở Claude Code trong thư mục dự án của bạn
- Thêm marketplace | Chạy lệnh /plugin marketplace add để plugin xuất hiện trong danh sách
- Cài plugin | Chạy /plugin install compound-engineering
- Chạy thiết lập | Gõ /ce-setup trong dự án để kiểm tra và tạo file cấu hình
- Thử skill đầu | Gõ /ce-help hoặc /ce-brainstorm kèm ý tưởng của bạn
```

### Mở Claude Code trong dự án

Mở terminal, đi vào thư mục dự án rồi khởi động Claude Code. Các lệnh bên dưới bắt đầu bằng dấu `/` nên gõ **trong khung chat của Claude Code**, không gõ vào terminal thường. Đây là chỗ người mới hay nhầm.

### Thêm marketplace và cài plugin

Gõ lần lượt hai lệnh sau trong chat Claude Code:

```text
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineering
```

Lệnh đầu khai báo nguồn plugin (repo GitHub của Every). Lệnh sau cài plugin tên `compound-engineering`.

```note
Đã cài từ trước? README cảnh báo: phải làm mới marketplace TRƯỚC khi cập nhật. Chỉ chạy /plugin update thì bạn vẫn ở phiên bản cũ. Cách làm mới nằm ở mục Upgrading trong README, phần mình có chưa chép lệnh đó nên bạn mở README gốc để xem.
```

### Cài trên Cursor

Trong khung chat Agent của Cursor, gõ:

```text
/add-plugin compound-engineering
```

Hoặc tìm "compound engineering" trong plugin marketplace của Cursor. Nếu dùng Grok Bot, README dặn: cài một lần trên tài khoản Cursor, đừng chạy `/add-plugin` trong chat Grok Bot và đừng clone repo vào máy Grok Bot.

### Cài trên Codex

Với Codex CLI, đăng ký marketplace rồi cài plugin:

```bash
codex plugin marketplace add EveryInc/compound-engineering-plugin
codex plugin add compound-engineering@compound-engineering-plugin
```

Cài xong, khởi động lại Codex. Với Codex app, README hướng dẫn thêm marketplace tuỳ chỉnh qua giao diện: mở Plugins ở thanh bên, bấm mũi tên cạnh Create, chọn Add marketplace. Nhập Source là `EveryInc/compound-engineering-plugin`, Git ref là `main`, để trống Sparse paths. Sau đó tìm Compound Engineering, cài **compound-engineering-plugin** và khởi động lại.

Nếu bạn dùng profile Codex không mặc định, chạy mọi lệnh với cùng một `CODEX_HOME`, như ví dụ trong README:

```bash
CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add EveryInc/compound-engineering-plugin
CODEX_HOME="$HOME/.codex/profiles/work" codex plugin add compound-engineering@compound-engineering-plugin
```

### Các công cụ khác

README còn có lệnh cho Grok Build CLI, Devin CLI, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi và Cline. Ví dụ Qwen Code:

```bash
qwen extensions install EveryInc/compound-engineering-plugin:compound-engineering
```

Cline cần bật Settings -> Features -> Enable Skills, rồi chạy các lệnh sau:

```bash
git clone https://github.com/EveryInc/compound-engineering-plugin
./compound-engineering-plugin/.cline/scripts/install-skills.sh --global
```

Với công cụ nào bạn dùng, cứ làm theo mục tương ứng trong README, và nhớ khởi động lại hoặc mở phiên mới sau khi cài.

## Kiểm tra đã chạy được chưa

Sau khi cài và khởi động lại (nếu công cụ yêu cầu), chạy trong dự án:

```text
/ce-setup
```

Theo README, lệnh này báo cáo các khả năng công cụ tuỳ chọn, tạo file `.compound-engineering/config.yaml` của repo nếu chưa có, làm mới file ví dụ đã commit, và đưa file cấu hình local đã tồn tại vào gitignore. Nếu lệnh được nhận và chạy ra báo cáo, plugin đã hoạt động.

Cách thử nhẹ hơn: gõ `/ce-help` để hỏi nên dùng skill nào. Riêng Devin CLI, README hướng dẫn kiểm tra bằng `devin plugins list` và `devin plugins info compound-engineering`. Nhớ rằng trong Codex, bạn gọi skill bằng `$` thay vì `/`, ví dụ `$ce-plan`.

## Dùng vào việc thật

### Thêm tính năng mới cho website bán hàng

Bạn là dev mới, chủ shop nhờ làm tính năng "tự thử lại khi job gửi email đơn hàng bị lỗi". Thay vì bảo AI "làm đi", bạn chạy đúng vòng lặp ví dụ trong README:

```text
/ce-brainstorm make background job retries safer
/ce-plan
/ce-work
/ce-simplify-code
/ce-code-review
/ce-compound
```

Brainstorm hỏi bạn các câu để chốt yêu cầu. Plan biến nó thành kế hoạch làm được. Work thực hiện, simplify gọn lại, review soi trước khi merge, và compound ghi bài học vào `docs/solutions/`. Kết quả là code đã review cùng một ghi chú để lần sau AI không mắc lại lỗi cũ.

> Phiên đầu dạy AI, phiên thứ hai AI mới thật sự nhớ.
>
> — Ông T

### Giao trọn một tính năng cho AI tự chạy

Bạn bận họp và có yêu cầu khá rõ. Chạy `/ce-brainstorm` mô tả tính năng, rồi gõ `/lfg`. Theo README, `/lfg` chọn đường tới nguồn việc đã kiểm chứng (kế hoạch, hoặc bản sửa từ `ce-debug` nếu là báo lỗi), thực hiện, gọn code, chạy review và áp dụng sửa, ghi bài học, chạy kiểm thử trên trình duyệt rồi commit. Nếu repo có remote, nó đẩy lên, mở PR và theo dõi CI với số lần sửa có giới hạn. Nó không tự merge trừ khi bạn cho phép. README khuyên chạy sau `/ce-brainstorm` để nó làm theo yêu cầu thật chứ không theo một câu mô tả sơ sài.

### Sửa một lỗi khó hiểu

Khách phản ánh trang thanh toán thỉnh thoảng bị lỗi. Bạn dùng `/ce-debug` kèm mô tả lỗi, thay vì bắt đầu từ brainstorm. Sửa xong, chạy `/ce-compound` để nguyên nhân gốc được lưu lại. Lần sau có lỗi tương tự, các bước lập kế hoạch sẽ đọc ghi chú này.

### Hiểu một đoạn code cũ trước khi sửa

Bạn vừa nhận dự án từ người khác và chưa dám đụng vào. Hỏi `/ce-explain` về hành vi cần sửa. README nói skill này giải thích nó hoạt động thế nào và vì sao tồn tại. Cần một quyết định (ví dụ chọn cách làm nào), dùng `/ce-pov`. Nói "oracle this" để thêm ý kiến độc lập từ các mô hình khác.

## Lỗi hay gặp và cách xử lý

**Cập nhật rồi mà vẫn phiên bản cũ.** Nguyên nhân README nêu rõ: chưa làm mới marketplace trước khi cập nhật. Làm theo mục Upgrading trong README gốc, đừng chỉ chạy `/plugin update`.

**Cài xong mà không thấy skill.** Nhiều công cụ chỉ nạp skill khi khởi động phiên. README dặn khởi động lại Codex, chạy `/reload` hoặc mở phiên mới với Kimi, mở phiên mới với Devin và Grok, và bắt đầu task mới với Cline. Hãy làm vậy trước khi nghĩ là cài hỏng.

**Gõ `/ce-plan` trong Codex không chạy.** Trong Codex, skill gọi bằng `$`: `$ce-plan`, `$lfg`. Với oh-my-pi, các skill thủ công hoặc ẩn dùng dạng `/skill:<tên>`.

**Cline không thấy skill.** Kiểm tra đã bật Settings -> Features -> Enable Skills trong extension Cline chưa. Chi tiết gỡ cài, ghim phiên bản nằm trong `.cline/INSTALL.md` của repo.

**Devin hỏi quyền liên tục.** README giải thích một vài skill khai báo tên công cụ kiểu Claude (ví dụ `Bash`) mà Devin không ánh xạ. Skill vẫn chạy nhưng một số thao tác hỏi quyền thay vì tự duyệt. Đây là hành vi dự kiến, không phải lỗi cài.

## Có nên dùng không

**Điểm mạnh:** có quy trình rõ ràng từ ý tưởng tới review, có bước ghi bài học để kiến thức tích luỹ trong repo, chạy trên nhiều công cụ AI, giấy phép MIT, repo còn được cập nhật trong vài tháng gần đây, và cài trên Claude Code chỉ hai lệnh. Bạn cũng không cần cài thêm công cụ ngoài, vì skill là các quy trình viết sẵn.

**Giới hạn:** 38 skill là khá nhiều, người mới dễ choáng. Cứ bắt đầu với sáu skill của vòng lặp chính và `/ce-help`. Quy trình thiên về làm kỹ (nhiều thời gian cho kế hoạch và review), nên với sửa nhanh một dòng nó có thể thừa. Mình chưa có tư liệu về chi phí token hay độ ổn định trên dự án lớn, nên bạn nên thử trên một dự án nhỏ trước. Các skill review, commit và đẩy PR có thể tác động tới repo của bạn, vì vậy hãy xem kỹ những gì AI sắp làm, nhất là với `/lfg`.

**Khi nào chọn cách khác:** nếu bạn chỉ hỏi đáp code lẻ, hoặc không muốn có thêm tài liệu trong thư mục `docs/`, chỉ cần dùng thẳng công cụ AI. Nếu muốn nhóm cùng dùng chung quy tắc ở nhiều repo, hãy xem tính năng Compound Packs, nhưng nhớ đó mới là tính năng thử nghiệm.

## Câu hỏi thường gặp

### Compound Engineering có miễn phí không?

Repo dùng giấy phép MIT nên bạn dùng và sửa tự do. Tư liệu không nói gì về phí của plugin. Công cụ chủ như Claude Code, Cursor hay Codex có chính sách giá riêng, bạn cần xem ở nhà cung cấp.

### Plugin này chạy trên công cụ nào?

README ghi plugin chạy trên 14 agent host, gồm Claude Code, Cursor và Codex. Ngoài ra có hướng dẫn cho Kimi Code CLI, Cline, Grok Build CLI, Devin CLI, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi và vài công cụ khác.

### Cài trên Claude Code như thế nào?

Trong khung chat Claude Code, gõ /plugin marketplace add EveryInc/compound-engineering-plugin rồi /plugin install compound-engineering. Sau đó chạy /ce-setup trong dự án để kiểm tra và tạo file cấu hình.

### Có chạy được trên Windows không?

Tư liệu mình có không nói rõ về hệ điều hành. Các lệnh cài trên Claude Code và Cursor gõ trong khung chat nên không phụ thuộc terminal. Riêng các script như của Cline là shell script, bạn nên xem .cline/INSTALL.md trong repo.

### Có cần GPU hay API key riêng không?

README phần mình có không nhắc tới GPU hay API key riêng cho plugin. Plugin là bộ skill chạy trong công cụ AI bạn đang dùng. Chuyện tài khoản và chi phí tuỳ công cụ chủ đó.

### Plugin lưu kiến thức ở đâu, dữ liệu có an toàn không?

Mặc định bài học ghi vào docs/solutions/ và kế hoạch vào docs/plans/ trong chính dự án của bạn. Bạn có thể đổi gốc thư mục bằng cài đặt docs_root. Về chính sách dữ liệu, repo có file PRIVACY.md để bạn đọc, mình chưa có nội dung của nó.

### Khác gì so với việc chỉ chat với AI để code?

Plugin ép quy trình có cấu trúc: brainstorm, plan, work, simplify, review rồi compound. Điểm khác chính là bước ghi bài học để các phiên sau đọc lại làm nền. Chat thường không tự làm việc đó.
