# aidlc-workflows: quy trình AI viết code có kiểm soát — hướng dẫn cài đặt và dùng

> aidlc-workflows là bộ quy trình và luật điều hướng AI-DLC do AWS Labs phát hành, biến trợ lý AI lập trình thành một quy trình giao phần mềm có cấu trúc, có bước duyệt của con người. Bạn cài bằng một dòng lệnh, chọn công cụ đang dùng rồi gõ /aidlc kèm yêu cầu. Cài đặt không khó, kể cả khi máy chưa có Node hay Bun.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-29 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/aidlc-workflows-quy-trinh-ai-viet-code-co-kiem-soat

**aidlc-workflows là một bộ quy trình làm việc (workflow) cho các trợ lý AI lập trình**, do AWS Labs phát hành. Thay vì bạn ra lệnh rồi để AI tự làm một mạch, bộ này ép AI đi qua các giai đoạn rõ ràng: hiểu yêu cầu, thiết kế, viết code, kiểm thử, rồi vận hành. Ở mỗi chặng quan trọng, AI dừng lại chờ bạn duyệt.

Vấn đề nó giải quyết rất quen thuộc. Khi dự án lớn dần, AI hay “quên” bối cảnh: yêu cầu một đằng, code một nẻo, test không khớp quyết định ban đầu. AI-DLC giữ yêu cầu, quyết định, code, test và vận hành nối với nhau trong một vòng đời có ghi lại đầy đủ. Repo hiện có khoảng 6062 sao và 1080 fork, giấy phép MIT-0.

Bạn nên đọc bài này nếu đang dùng (hoặc muốn thử) Claude Code, Kiro, Codex CLI, Cursor, opencode hay GitHub Copilot và muốn AI làm việc có kỷ luật hơn. Điểm đáng giá nhất: một lõi duy nhất chạy được trên cả bảy công cụ đó, nên bạn đổi công cụ vẫn giữ nguyên cách làm việc. Xem video ngắn bên dưới để thấy nhanh cách nó chạy, rồi quay lại đây làm theo từng bước.

```repo
- repo | awslabs/aidlc-workflows
- kind | Framework
- desc | Bộ quy trình AI-DLC của AWS Labs giúp trợ lý AI lập trình làm việc theo từng giai đoạn, có cổng duyệt, chạy trên Claude Code, Kiro, Codex, Cursor, Copilot.
- stars | 6.1k
- lang | TypeScript
- license | MIT-0
```

```video
- youtube | https://youtube.com/shorts/oYXXVm0kg1Y
- facebook | https://www.facebook.com/reel/1429650195415339
- title | Video giới thiệu aidlc-workflows
```

## aidlc-workflows làm được gì

Theo README, repo gồm một “lõi” trung lập (không phụ thuộc công cụ nào) và các lớp mỏng riêng cho từng công cụ. Những thứ bạn nhận được:

### Quy trình có giai đoạn rõ ràng

Có 5 giai đoạn và 33 bước, từ khởi tạo đến vận hành. Lợi ích thực tế: bạn không phải tự nhớ “đã làm phân tích chưa, đã viết test chưa”. Quy trình nhắc và dẫn đường thay bạn.

### Nhiều “nhân sự” AI chuyên trách

Bộ này có 14 agent: 11 chuyên gia theo lĩnh vực, 2 người rà soát (reviewer) và một agent “composer” tự thích ứng. Việc chia vai giúp mỗi phần được xem xét từ đúng góc nhìn, thay vì một AI ôm hết.

### 11 hồ sơ quy trình theo loại việc

Có sẵn hồ sơ cho tính năng mới, sửa lỗi, hạ tầng, bảo mật, bản thử nghiệm (proof of concept), giao hàng cho doanh nghiệp… Bạn chỉ mô tả việc cần làm, AI-DLC tự chọn quy trình hợp, hỏi lại những quyết định còn thiếu. Việc nhỏ không bị ép đi quy trình nặng nề.

### Cổng duyệt của con người

AI dừng ở các “cổng duyệt” trước khi đi tiếp. Với người không chuyên code, đây là phần quan trọng nhất: bạn vẫn là người quyết định, AI không tự ý đi xa.

### Nhật ký kiểm toán và bộ nhớ

README ghi có 134 loại sự kiện được ghi lại, cùng trạng thái lưu bền, kiến thức của nhóm và các quy tắc học được. Nhờ vậy làm lại hôm sau hay đổi người làm, bối cảnh vẫn còn.

### Một công cụ dòng lệnh `aidlc`

Bộ cài đặt đặt lệnh `aidlc` vào máy. Lệnh này dùng để cấu hình dự án (`aidlc config`) và kiểm tra tình trạng (`aidlc doctor`).

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

Chỉ những gì README nói:

- **Hệ điều hành:** macOS, Linux, WSL, hoặc Windows (dùng PowerShell).
- **Một công cụ AI lập trình** bạn đã dùng được. Bản tối thiểu README nêu: Kiro IDE từ 1.1.70 hoặc Kiro CLI từ 2.24.1 (cho engine v3); Kiro CLI (V2) từ 2.6; Codex CLI từ 0.145.0; opencode từ 1.18.29; GitHub Copilot CLI từ 1.0.74 hoặc VS Code từ 1.130. Với Claude Code và Cursor, README không ghi số phiên bản tối thiểu.
- **Không cần cài Bun hay Node.js** nếu cài theo cách thông thường. Chỉ khi chọn cách “copy thủ công” thì mới cần Bun.
- **Mô hình AI:** README khuyên dùng mô hình có khả năng suy luận tốt; mô hình đang được khuyến nghị là Claude Opus 4.8. Phần chọn nhà cung cấp mô hình do công cụ bạn dùng lo, không phải AI-DLC.
- **Amazon Bedrock:** chỉ cần nếu bạn chọn dùng Bedrock. Khi đó phải bật mô hình và có thông tin đăng nhập AWS hợp lệ. Kiro thì không cần bước này vì quyền dùng mô hình đi kèm Kiro.

```note
AI sinh ra có thể sai, và việc chạy mô hình có thể tốn tiền. README nhắc bạn xem lại kết quả và chi phí trước khi dùng. Lệnh cài ở dưới tải script từ internet rồi chạy ngay, nên chỉ chạy khi bạn tin nguồn (ở đây là trang release chính thức của repo).
```

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

```steps
- Cài aidlc | Chạy một dòng lệnh cài đặt theo hệ điều hành
- Vào thư mục dự án | Mở terminal ngay tại gốc dự án của bạn
- Cấu hình công cụ | Chạy aidlc config với tên công cụ bạn dùng
- Kiểm tra | Chạy aidlc doctor
- Bắt đầu | Mở công cụ AI và gõ /aidlc kèm yêu cầu
```

### Bước 1: Cài đặt AI-DLC

Chọn đúng dòng cho hệ điều hành của bạn. Trên macOS, Linux hoặc WSL, mở Terminal và chạy:

```bash
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh
```

Trên Windows, mở PowerShell bình thường và chạy:

```powershell
irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex
```

Bộ cài đặt lệnh `aidlc` cùng toàn bộ phần chạy cho các công cụ. Vài chỗ người mới hay vấp:

- Trên Windows, hãy mở PowerShell thường, **đừng** chọn “Run as administrator”. Chạy bằng quyền quản trị bị README cảnh báo là kém an toàn nên sẽ hiện cảnh báo và hỏi lại.
- Bộ cài tự thêm thư mục chứa `aidlc` vào PATH của tài khoản Windows hiện tại. Nếu terminal khác chưa nhận lệnh, hãy mở terminal mới.
- Muốn bỏ qua việc sửa PATH trên Windows, README có cờ `-NoModifyPath`.
- Trên macOS, Linux hoặc WSL, nếu bộ cài in ra hướng dẫn về PATH thì làm theo đúng hướng dẫn đó.

Nếu bạn không cài được file chạy gốc hoặc muốn tự quản lý file dự án, README có đường “copy thủ công”: cài Bun, tải file `aidlc-copy-runtime-X.Y.Z.tar.gz` từ trang release mới nhất, rồi chép nguyên thư mục `runtime/<harness>/` vào dự án. Cách này không cần lệnh `aidlc`. Với người mới, mình khuyên đi đường cài tự động ở trên.

### Bước 2: Vào thư mục dự án

Mở terminal và đi tới thư mục gốc của dự án bạn muốn AI làm việc. Đây là chỗ nhiều người sai: cấu hình sẽ được ghi vào thư mục hiện tại, nên đứng sai thư mục là cấu hình sai chỗ.

```bash
cd /path/to/your-project
```

Thay `/path/to/your-project` bằng đường dẫn thật tới dự án của bạn.

### Bước 3: Cấu hình theo công cụ bạn dùng

Ví dụ với Claude Code:

```bash
aidlc config --harness claude
```

Thay `claude` bằng một trong các giá trị: `kiro`, `kiro-v2`, `codex`, `cursor`, `opencode`, `copilot`. Ghi nhớ nhanh theo bảng của README:

- Claude Code dùng `claude`, mở bằng lệnh `claude`, gọi bằng `/aidlc`.
- Kiro (IDE hoặc Kiro CLI v3) dùng `kiro`.
- Kiro CLI bản V2 dùng `kiro-v2`.
- Codex CLI dùng `codex`, mở bằng `codex`, gọi bằng `$aidlc` (có dấu đô la, không phải dấu gạch chéo).
- Cursor dùng `cursor`; opencode dùng `opencode`; GitHub Copilot dùng `copilot`.

Nếu chạy `aidlc config` mà không có `--harness` và đang ở trong terminal, công cụ sẽ mở phần cài đặt tương tác để bạn chọn dần.

Lưu ý riêng cho Kiro IDE: nếu bạn mở thư mục chưa tin cậy trong terminal của Kiro, Kiro sẽ hỏi có tin thư mục không. Chỉ chọn **Trust Folder & Continue** với dự án của chính bạn hoặc dự án bạn đã kiểm tra, vì tin cậy nghĩa là các hook trong thư mục `.kiro` được phép chạy lệnh trên máy bạn. Không chắc thì chọn **Cancel** và xem lại thư mục trước.

### Bước 4: Kiểm tra bằng doctor

```bash
aidlc doctor
```

Lệnh này kiểm tra tình trạng cài đặt. README cũng khuyên chạy nó đầu tiên mỗi khi gặp sự cố.

### Bước 5: Mở công cụ AI và bắt đầu

Mở công cụ bạn đã chọn trong thư mục dự án (ví dụ gõ `claude`), rồi mô tả việc cần làm:

```text
/aidlc Build a REST API for inventory management
```

Với Codex CLI, dùng `$aidlc` thay cho `/aidlc`. Với Kiro IDE, trước tiên hãy chọn **aidlc** trong bộ chọn agent ở khung chat. Câu lệnh mẫu trong README viết bằng tiếng Anh; README không nói gì về việc dùng tiếng Việt, nên nếu bạn gõ tiếng Việt, hãy tự thử và xem kết quả.

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

Có ba dấu hiệu theo tư liệu:

- Lệnh `aidlc doctor` chạy xong mà không báo lỗi. README không mô tả chính xác màn hình kết quả, nên nếu có cảnh báo, hãy đọc kỹ nội dung và đối chiếu với phần Troubleshooting trong tài liệu của dự án.
- Gõ `/aidlc` (hoặc `$aidlc` với Codex) trong công cụ AI được nhận ra như một lệnh của AI-DLC.
- Khi bạn mô tả việc cần làm, AI-DLC chọn một quy trình phù hợp, hỏi những quyết định còn thiếu, và **dừng ở cổng duyệt** trước khi đi tiếp. Nếu AI cứ làm một mạch không hỏi gì, rất có thể cấu hình chưa đúng thư mục.

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

Bối cảnh dưới đây là ví dụ minh hoạ dựa trên khả năng README mô tả (hồ sơ quy trình cho tính năng, sửa lỗi, hạ tầng, bảo mật, thử nghiệm). Kết quả thực tế phụ thuộc mô hình và công cụ bạn dùng.

### Chủ shop muốn có hệ thống quản lý kho đơn giản

Bạn bán hàng online, thuê một bạn lập trình viên mới ra trường, hai người cùng dùng Claude Code. Thay vì giao một câu “làm cho anh cái app kho”, bạn gõ câu mẫu của chính README:

```text
/aidlc Build a REST API for inventory management
```

AI-DLC chọn quy trình, hỏi các điểm còn thiếu (ví dụ cần quản lý những gì), rồi dừng ở cổng duyệt. Bạn đọc, đồng ý hoặc sửa, rồi mới cho đi tiếp. Kết quả là bạn hiểu mình đang được làm gì, thay vì nhận về một đống code không ai giải thích.

> Cái đáng tiền nhất của AI không phải là viết nhanh, mà là biết dừng lại hỏi bạn đúng lúc.
>
> — Ông T

### Lập trình viên mới sửa lỗi trong dự án có sẵn

Bạn vừa vào một dự án và được giao sửa lỗi. Chạy `aidlc config --harness cursor` (hoặc công cụ bạn đang dùng) ở thư mục dự án, rồi mô tả lỗi sau `/aidlc`. Vì có hồ sơ quy trình cho việc sửa lỗi, AI đi theo luồng phù hợp thay vì viết lại cả tính năng. Các quyết định được ghi lại, nên đồng nghiệp xem lại sẽ hiểu vì sao sửa như vậy.

### Nhóm nhỏ dùng nhiều công cụ AI khác nhau

Trong nhóm, người thích Claude Code, người thích Cursor, người dùng GitHub Copilot. Vì AI-DLC dùng chung một lõi, mỗi người chạy `aidlc config --harness` với công cụ của mình trong cùng dự án và vẫn làm theo cùng một quy trình, cùng cổng duyệt. Đây là điểm khác biệt lớn so với việc mỗi người tự viết một bộ prompt riêng.

### Người phụ trách quy trình muốn kiểm soát và truy vết

Bạn làm quản lý và cần biết AI đã làm gì, duyệt ở đâu. Nhật ký kiểm toán và bằng chứng rà soát gắn với nguồn giúp bạn xem lại các quyết định. README có tài liệu riêng (Harness Engineer Guide) cho việc chỉnh các bước, agent, quy tắc theo ý tổ chức; đây là phần dành cho người đã quen cơ bản.

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

Luôn bắt đầu bằng cách chạy `aidlc doctor` ở thư mục gốc dự án. Các lỗi README liệt kê:

### Báo không tìm thấy lệnh aidlc

Trên Windows, hãy tắt hẳn rồi mở lại ứng dụng terminal hoặc IDE. Một tab mới trong cửa sổ đã mở từ trước khi cài vẫn giữ PATH cũ. Trên macOS, Linux hoặc WSL, làm theo hướng dẫn PATH mà bộ cài đã in ra.

### Phiên bản dự án và phần chạy bị lệch

Chạy lại `aidlc config` ở thư mục dự án để đồng bộ.

### Codex không chạy hook

Bạn cần tin cậy (trust) các hook của dự án theo hướng dẫn trong tài liệu Codex của repo. Đây là bước bảo mật của chính Codex, không phải lỗi của AI-DLC.

### Truy cập Amazon Bedrock thất bại

Kiểm tra đã bật đúng mô hình được cấu hình chưa, thông tin đăng nhập AWS có hợp lệ không và vùng (region) có đúng không.

### Kỹ năng đã làm mới nhưng không có tác dụng

Hãy mở một phiên mới của công cụ AI. Nếu các bước của plugin biến mất sau khi làm mới, README bảo chạy `/aidlc plugin sync`.

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

**Điểm mạnh:** quy trình rõ ràng, có cổng duyệt của con người, có nhật ký truy vết, chạy được trên bảy công cụ AI phổ biến, cài đặt một dòng lệnh và không đòi cài Node hay Bun. Giấy phép MIT-0 rất thoáng, repo còn được cập nhật trong vài tháng gần đây và có tài liệu riêng cho từng công cụ.

**Giới hạn:** bộ này khá “nặng” với việc nhỏ lẻ. Nếu bạn chỉ cần AI sửa một dòng code, đi qua quy trình nhiều giai đoạn là thừa. Phần khái niệm (giai đoạn, agent, hồ sơ, cổng duyệt) cần chút thời gian để làm quen. Tài liệu chính viết bằng tiếng Anh. README cũng nhắc rằng AI có thể sai nên bạn phải tự xem lại kết quả và chi phí. Chất lượng đầu ra còn phụ thuộc mô hình bạn chọn, và README khuyên dùng mô hình suy luận mạnh.

**Khi nào chọn cách khác:** nếu bạn chỉ thích hỏi đáp nhanh hoặc làm đồ chơi một lần, cứ dùng trợ lý AI như bình thường. Còn nếu dự án sẽ lớn dần, nhiều người cùng làm, cần biết ai quyết định gì và vì sao, thì AI-DLC đáng để thử trên một dự án nhỏ trước, rồi mới mở rộng.

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

### aidlc-workflows có miễn phí không?

Repo dùng giấy phép MIT-0 nên bạn dùng tự do. Tuy nhiên chi phí gọi mô hình AI phụ thuộc công cụ và nhà cung cấp bạn chọn, README nhắc bạn nên xem lại chi phí trước khi dùng. Mức giá cụ thể thì tư liệu chưa có thông tin.

### Có cần cài Node.js hay Bun không?

Với cách cài thông thường bằng dòng lệnh của README thì không cần Bun hay Node.js. Chỉ khi chọn đường copy thủ công (không dùng lệnh aidlc) bạn mới cần cài Bun.

### Chạy được trên Windows không?

Được. README có lệnh PowerShell riêng cho Windows, cài cho tài khoản hiện tại và tự thêm thư mục vào PATH. Bạn nên mở PowerShell thường, không chạy bằng quyền quản trị. Người dùng macOS, Linux hoặc WSL dùng lệnh curl.

### Hỗ trợ những công cụ AI nào?

Claude Code, Kiro CLI, Kiro IDE, Codex CLI, Cursor, opencode và GitHub Copilot. Bạn chọn công cụ bằng cờ --harness khi chạy aidlc config, ví dụ claude, kiro, kiro-v2, codex, cursor, opencode hoặc copilot.

### Có cần GPU không?

Tư liệu không nhắc đến yêu cầu GPU. AI-DLC là bộ quy trình chạy trong các công cụ AI lập trình, còn mô hình do công cụ hoặc nhà cung cấp bạn chọn xử lý.

### Code và dữ liệu của tôi có an toàn không?

README không nói chi tiết về xử lý dữ liệu. Nó chỉ cảnh báo hai điều: hãy chỉ tin cậy (trust) thư mục dự án của chính bạn hoặc đã kiểm tra, vì hook có thể chạy lệnh trên máy; và hãy xem lại kết quả do AI sinh ra. Dữ liệu gửi đi đâu còn tuỳ công cụ và mô hình bạn dùng.

### AI-DLC khác gì việc tự viết prompt cho AI?

AI-DLC đóng gói sẵn quy trình 5 giai đoạn, 33 bước, nhiều agent chuyên trách, cổng duyệt và nhật ký truy vết, dùng chung được cho nhiều công cụ. Prompt tự viết thì không có sẵn những phần đó. README không so sánh trực tiếp với công cụ khác.
