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

> aidlc-workflows (AI-DLC) là bộ quy trình do AWS Labs phát hành, giúp trợ lý AI viết code làm việc theo từng giai đoạn rõ ràng: yêu cầu, thiết kế, code, kiểm thử, vận hành, và dừng lại chờ bạn duyệt ở mỗi cổng. Repo chạy được trên Claude Code, Kiro, Codex CLI, Cursor, opencode và GitHub Copilot. Cài đặt chỉ cần một dòng lệnh, rồi cấu hình cho từng dự án bằng lệnh aidlc.

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

aidlc-workflows là bộ quy trình “làm phần mềm cùng AI” do AWS Labs phát hành, tên gọi đầy đủ là AI-DLC (AI-Driven Development Life Cycle). Nó không phải một ứng dụng riêng. Nó là lớp quy tắc và công cụ đặt lên trên trợ lý AI viết code mà bạn đang dùng, để AI làm việc có trình tự thay vì nhận một câu rồi viết lung tung.

Nếu bạn từng nhờ AI viết code rồi thấy dự án càng lớn thì AI càng quên yêu cầu cũ, quyết định cũ, thì repo này dành cho bạn. AI-DLC giữ yêu cầu, quyết định, code, kiểm thử và phần vận hành nối với nhau trong một vòng đời có ghi lại. Mỗi bước quan trọng đều có cổng duyệt: AI dừng lại và chờ bạn đồng ý rồi mới đi tiếp.

Điểm đáng giá nhất là “một lõi, nhiều công cụ”: cùng một bộ quy trình chạy trên Claude Code, Kiro CLI, Kiro IDE, Codex CLI, Cursor, opencode và GitHub Copilot. Bạn đổi công cụ thì cách làm việc không đổi. Repo hiện có khoảng 6.062 sao và 1.080 fork, giấy phép MIT-0, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy, rồi quay lại đọc phần cài đặt.

```repo
- repo | awslabs/aidlc-workflows
- kind | Framework
- desc | Bộ quy tắc và công cụ của AWS Labs biến trợ lý AI viết code thành quy trình giao phần mềm có các cổng duyệt, chạy trên Claude Code, Kiro, Codex, Cursor và nhiều công cụ khác.
- 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
```

## AI-DLC làm được gì

Dưới đây là những thứ chính repo mang lại, tính theo lợi ích thực tế.

- **Chia việc thành giai đoạn rõ ràng.** README ghi 5 giai đoạn và 33 bước nhỏ, đi từ khởi tạo đến vận hành. Bạn không phải tự nghĩ “giờ nên bảo AI làm gì tiếp”.
- **Đội AI chuyên môn hoá.** Có 14 agent: 11 chuyên gia theo lĩnh vực, 2 người rà soát và 1 agent “composer” thích ứng. Việc nào có chuyên gia đó lo, giống một nhóm nhỏ thay vì một AI làm tất cả.
- **11 hồ sơ quy trình (workflow profile).** Có sẵn cho làm tính năng mới, sửa lỗi, hạ tầng, bảo mật, làm thử ý tưởng (proof of concept), giao hàng cho doanh nghiệp… Việc nhỏ thì chọn quy trình gọn, việc lớn thì chọn quy trình đầy đủ. AI sẽ tự chọn hồ sơ phù hợp từ yêu cầu của bạn.
- **Cổng duyệt của con người.** AI hỏi các quyết định còn thiếu và dừng ở cổng duyệt trước khi tiến tiếp. Bạn giữ quyền kiểm soát, không bị bất ngờ.
- **Nhật ký kiểm toán.** 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. Sau này ai mở dự án cũng biết vì sao một quyết định được đưa ra.
- **Một engine cho mọi công cụ.** Phần cốt lõi trung lập, mỗi công cụ chỉ có lớp mỏng riêng. Phương pháp không phụ thuộc nhà cung cấp mô hình AI.
- **Công cụ dòng lệnh aidlc.** Một lệnh `aidlc` để cấu hình dự án và chẩn đoán lỗi (`aidlc doctor`).

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

Theo README, bạn cần:

- **Hệ điều hành:** macOS, Linux, WSL, hoặc Windows với PowerShell.
- **Một công cụ AI viết code (harness)** trong danh sách hỗ trợ, kèm phiên bản tối thiểu nếu có: Claude Code; Kiro IDE từ 1.1.70 hoặc Kiro CLI từ 2.24.1 (bản v3); Kiro CLI (V2) từ 2.6; Codex CLI từ 0.145.0; Cursor; opencode từ 1.18.29; GitHub Copilot CLI từ 1.0.74 hoặc VS Code từ 1.130.
- **Quyền dùng mô hình AI.** Việc chọn nhà cung cấp và mô hình thuộc về công cụ bạn dùng. README khuyên dùng mô hình suy luận mạnh, hiện đề xuất Claude Opus 4.8. Với Kiro, quyền dùng mô hình đi kèm Kiro. Nếu dùng Amazon Bedrock, bạn cần bật các mô hình đã cấu hình và có thông tin đăng nhập AWS đúng vùng.
- **Không cần cài Bun hay Node.js** nếu cài theo cách thường (native). Chỉ cách “tự chép file” mới cần Bun.
- **Một thư mục dự án** để cấu hình.

Repo cũng có `pyproject.toml` yêu cầu Python 3.12 trở lên, nhưng đó là gói tài liệu của repo, bạn không cần để dùng AI-DLC. Phần lập trình của repo viết bằng TypeScript và dùng Bun, chỉ liên quan nếu bạn muốn đóng góp code.

```note
AI-DLC chạy trên mô hình AI của bạn nên có thể phát sinh chi phí tuỳ nhà cung cấp. README nhắc: AI có thể sai, hãy xem lại kết quả và chi phí trước khi làm theo.
```

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

```steps
- Cài AI-DLC | Chạy một dòng lệnh để có lệnh aidlc và các runtime
- Mở terminal tại dự án | cd vào thư mục dự án của bạn
- Cấu hình harness | aidlc config --harness <tên công cụ>
- Kiểm tra | aidlc doctor
- Bắt đầu quy trình | Mở công cụ AI và gõ /aidlc kèm yêu cầu
```

### Cài lệnh aidlc

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
```

Trình cài đặt cài sẵn lệnh `aidlc` và mọi runtime cho các công cụ. Trên Windows nó cài cho tài khoản hiện tại và tự thêm thư mục chứa lệnh vào PATH của người dùng.

Chỗ người mới hay vấp: đừng mở PowerShell bằng “Run as administrator”. README cảnh báo cài bằng quyền quản trị kém an toàn hơn và sẽ hiện cảnh báo. Cài xong, hãy mở terminal mới để nó nhận lệnh `aidlc`. Trên macOS, Linux hoặc WSL, nếu trình cài đặt in ra hướng dẫn thêm PATH thì làm theo đúng hướng dẫn đó. Muốn bỏ qua việc sửa PATH trên Windows thì dùng `-NoModifyPath`.

Nếu bạn không cài được file thực thi hoặc muốn tự quản lý file dự án, README có cách thủ công: cài Bun, tải `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`.

### Cấu hình cho dự án

Vào thư mục gốc của dự án rồi chọn công cụ bạn dùng. Ví dụ với Claude Code:

```bash
cd /path/to/your-project
aidlc config --harness claude
aidlc doctor
```

Thay `/path/to/your-project` bằng đường dẫn thật tới dự án của bạn. Thay `claude` bằng `kiro`, `kiro-v2`, `codex`, `cursor`, `opencode` hoặc `copilot` nếu bạn dùng công cụ khác. Nếu gõ `aidlc config` mà không có `--harness`, trong terminal thường nó sẽ mở bước thiết lập tương tác để bạn chọn.

Lưu ý riêng cho Kiro: Kiro IDE từ 1.1.70 hoặc Kiro CLI từ 2.24.1 (engine v3) dùng `kiro`, còn Kiro CLI (V2) dùng `kiro-v2`. Nếu mở thư mục chưa tin cậy trong terminal của Kiro IDE, 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 đã kiểm tra, vì việc tin cậy cho phép hook trong thư mục `.kiro` chạy lệnh trên máy bạn. Chưa chắc thì chọn **Cancel** và xem lại thư mục trước.

### Chọn nhà cung cấp mô hình (nếu cần)

Mô hình AI do công cụ của bạn quản lý, AI-DLC giữ nguyên mô hình bạn đã chọn. Nếu dùng Amazon Bedrock, README nói lệnh sau có thể áp dụng cấu hình Bedrock cho các nơi được hỗ trợ, hoặc ghi lại phần thiết lập thủ công cho công cụ khác:

```bash
aidlc config providers
```

### Mở công cụ và bắt đầu

Mở công cụ AI trong dự án đã cấu hình. Bảng dưới là cách mở theo README:

| Công cụ | Cách mở | Lệnh gọi |
| --- | --- | --- |
| Claude Code | `claude` | `/aidlc` |
| Kiro (v3) | Mở dự án trong Kiro IDE rồi chọn **aidlc** ở bộ chọn agent trong khung chat, hoặc chạy `kiro-cli --v3` | `/aidlc` |
| Kiro CLI (V2) | `kiro-cli --v2` | `/aidlc` |
| Codex CLI | `codex` | `$aidlc` |
| Cursor | Mở Cursor hoặc chạy `agent` | `/aidlc` |
| opencode | `opencode` | `/aidlc` |
| GitHub Copilot | Copilot CLI hoặc VS Code | `/aidlc` |

Sau đó mô tả việc cần làm:

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

Codex CLI dùng `$aidlc` thay cho `/aidlc`. Với Kiro IDE, nhớ chọn **aidlc** ở bộ chọn agent trước. README ghi yêu cầu mẫu bằng tiếng Anh; chưa có thông tin về việc viết bằng tiếng Việt cho kết quả thế nào, bạn nên thử trên việc nhỏ trước.

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

Cách kiểm tra chính thức là lệnh chẩn đoán, chạy từ thư mục gốc của dự án:

```bash
aidlc doctor
```

README không mô tả chính xác dòng chữ hiển thị khi thành công, nên mình không đoán. Bạn đọc kết quả trên màn hình: nếu có cảnh báo hay lỗi, đó là chỗ cần sửa, và README khuyên chạy lệnh này đầu tiên khi gặp sự cố.

Bước kiểm tra thứ hai là chạy thử thật. Mở công cụ AI trong dự án, gõ `/aidlc` kèm một yêu cầu nhỏ. Nếu quy trình hoạt động, AI sẽ chọn một quy trình từ yêu cầu, hỏi lại các quyết định còn thiếu và dừng ở cổng duyệt trước khi đi tiếp. Thấy AI hỏi và chờ bạn thay vì lao vào viết code ngay là dấu hiệu tốt.

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

Tất cả các tình huống dưới đây đều bắt đầu bằng `/aidlc` (hoặc `$aidlc` trên Codex) và một mô tả việc. Mô tả càng cụ thể, AI càng ít phải hỏi lại. Các câu mẫu mình viết dưới đây là ví dụ cho bạn, README chỉ đưa một câu mẫu duy nhất là REST API quản lý kho.

> AI không còn là cỗ máy gõ code thần tốc, mà là một nhóm làm việc biết dừng lại hỏi bạn trước mỗi quyết định lớn.
>
> — Ông T

### Chủ shop muốn có API quản lý kho

Bối cảnh: bạn bán hàng online, có một bạn lập trình viên làm thuê hoặc bạn tự mày mò. Cần một API để các ứng dụng khác đọc và cập nhật tồn kho. Đây chính là ví dụ trong README:

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

AI-DLC chọn quy trình phù hợp, hỏi các điểm chưa rõ (ví dụ cần quản lý những thông tin gì của hàng hoá) rồi chạy qua từng giai đoạn. Kết quả là yêu cầu, thiết kế và code được ghi lại có trình tự, mỗi cổng bạn đều được xem trước khi cho đi tiếp.

### Lập trình viên mới cần sửa lỗi mà không phá chỗ khác

Bối cảnh: bạn mới vào dự án, gặp một lỗi mà code còn lạ. Repo có sẵn hồ sơ cho việc sửa lỗi, nên bạn chỉ cần mô tả triệu chứng:

```text
/aidlc Fix the bug where the order total is wrong when a discount code is applied
```

AI sẽ chọn quy trình hợp với việc sửa lỗi, hỏi thêm thông tin cần thiết và dừng ở cổng duyệt. Bạn nhận được một chuỗi bước có ghi lại, dễ đọc lại sau này, thay vì một đoạn sửa không rõ lý do.

### Nhóm nhỏ làm thử ý tưởng nhanh

Bối cảnh: nhân viên văn phòng hoặc người làm sản phẩm muốn dựng thử một công cụ nội bộ để xem có khả thi không. README liệt kê hồ sơ cho proof of concept, phù hợp việc nhẹ, làm nhanh:

```text
/aidlc Build a quick proof of concept for an internal tool that collects leave requests
```

Kết quả là một bản thử có cấu trúc, và vì mọi quyết định đã được ghi lại, nếu ý tưởng được chọn, nhóm có thể tiếp tục từ chính hồ sơ đó mà không phải làm lại.

### Rà soát bảo mật và hạ tầng

Bối cảnh: dev trong công ty cần kiểm tra bảo mật hoặc dựng hạ tầng và muốn mọi bước có bằng chứng rà soát. README nói có hồ sơ cho hạ tầng và bảo mật, cùng bằng chứng rà soát gắn với nguồn:

```text
/aidlc Review the security of our login flow and propose fixes
```

Bạn nhận được các bước phân tích có người duyệt ở mỗi cổng, cùng nhật ký để quản lý hoặc đồng nghiệp xem lại.

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

Luôn chạy `aidlc doctor` từ thư mục gốc dự án trước. Các lỗi thường gặp theo README:

- **Không tìm thấy lệnh `aidlc`.** Trên Windows, thoát hẳn rồi mở lại ứng dụng terminal hoặc IDE; mở thêm một tab trong cửa sổ đã mở trong lúc cài vẫn dùng PATH cũ. Hoặc dùng lệnh trực tiếp được in ra khi cài với `-NoModifyPath`. Trên macOS, Linux, WSL thì làm theo hướng dẫn PATH của trình cài.
- **Phiên bản dự án và runtime lệch nhau.** Chạy lại `aidlc config` trong thư mục dự án.
- **Hook của Codex không chạy.** Bạn cần tin cậy hook của dự án như hướng dẫn trong tài liệu Codex của repo.
- **Truy cập Bedrock thất bại.** Kiểm tra đã bật các mô hình được cấu hình, thông tin đăng nhập AWS đúng và vùng đúng.
- **Giai đoạn của plugin biến mất sau khi làm mới.** Chạy `/aidlc plugin sync`.
- **Kỹ năng mới làm mới nhưng chưa có tác dụng.** Mở một phiên mới trong công cụ AI của bạn.

Một lỗi khác dễ gặp là cài nhầm tên công cụ. Hãy dùng đúng giá trị trong bảng ở trên, và nhớ Kiro có hai tên khác nhau (`kiro` và `kiro-v2`) tuỳ phiên bản. README còn nói các bản cũ đọc hai tên Kiro theo chiều ngược lại, nên nếu dùng bản cũ hãy xem phần ghi chú trong README. Cần chẩn đoán sâu hơn thì xem mục Troubleshooting trong thư mục `docs/` của repo.

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

**Điểm mạnh.** Quy trình rõ ràng, có cổng duyệt, có nhật ký, hợp với việc cần minh bạch và làm theo nhóm. Chạy được trên nhiều công cụ phổ biến nên không bị khoá vào một hãng. Cài bằng một dòng lệnh, không cần cài Bun hay Node.js. Giấy phép MIT-0 rất thoáng, và repo do AWS Labs phát hành, còn được cập nhật gần đây.

**Giới hạn.** Đây là phương pháp làm việc, không phải phép màu: chất lượng vẫn phụ thuộc mô hình AI bạn dùng, và README khuyên dùng mô hình suy luận mạnh. Mô hình càng mạnh thì chi phí có thể càng cao, vì vậy hãy theo dõi chi phí. Quy trình nhiều bước và nhiều cổng duyệt nghĩa là bạn phải dành thời gian đọc và đồng ý, nên với việc quá nhỏ (đổi một dòng chữ, sửa một lỗi chính tả) có thể thấy hơi nặng nề. Tài liệu và ví dụ chủ yếu bằng tiếng Anh. Người chưa quen terminal sẽ cần thời gian làm quen với `aidlc config` và cách mở từng công cụ.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần AI viết nhanh một đoạn script rời, cứ dùng trợ lý AI trực tiếp mà không cần quy trình. Nếu bạn cần phương pháp thật sự khác, ví dụ không muốn cổng duyệt, hãy cân nhắc các cách làm tự do hơn. Còn nếu dự án đủ lớn để AI hay quên ngữ cảnh, hoặc cần lưu vết quyết định cho cả nhóm, AI-DLC là lựa chọn đáng thử. Hãy bắt đầu bằng một dự án nhỏ để làm quen nhịp làm việc của nó.

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

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

Bản thân repo dùng giấy phép MIT-0 nên bạn dùng tự do. Tuy nhiên bạn vẫn cần quyền dùng mô hình AI qua công cụ của mình (Claude Code, Kiro, Codex...), và phần này có thể tính phí theo nhà cung cấp. README nhắc bạn xem lại chi phí trước khi làm theo kết quả AI tạo ra.

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

Có. README có lệnh cài riêng cho Windows PowerShell, tự thêm thư mục chứa lệnh aidlc vào PATH của người dùng. Bạn nên chạy từ PowerShell bình thường, không phải bản “Run as administrator”. Trên macOS, Linux hoặc WSL dùng lệnh curl.

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

Không với cách cài thông thường: README nói không cần Bun hay Node.js vì bản native chạy qua lệnh aidlc. Chỉ cách tự chép file runtime thủ công mới cần cài Bun.

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

Claude Code, Kiro CLI, Kiro IDE, Codex CLI, Cursor, opencode và GitHub Copilot. Mỗi công cụ có phiên bản tối thiểu riêng, ví dụ Codex CLI từ 0.145.0, bạn xem bảng trong phần hướng dẫn để chọn đúng giá trị cho lệnh aidlc config.

### Có cần GPU hay máy mạnh không?

Tư liệu không nhắc yêu cầu GPU. AI-DLC là lớp quy tắc chạy trong công cụ AI bạn dùng, nên phần tính toán nặng do nhà cung cấp mô hình đảm nhiệm. Chưa có thông tin cụ thể về cấu hình máy tối thiểu.

### Dữ liệu và code của mình có an toàn không?

Tư liệu không có tuyên bố riêng về bảo mật dữ liệu; mô hình AI do công cụ của bạn quản lý. Có một lưu ý an toàn: với Kiro IDE, chỉ chọn tin cậy thư mục của chính bạn hoặc đã kiểm tra, vì thư mục tin cậy cho phép hook chạy lệnh trên máy. Trên Windows, nên cài bằng PowerShell thường, không dùng quyền quản trị.

### AI-DLC khác gì việc nhờ AI viết code bình thường?

Thay vì nhận một câu rồi viết ngay, AI-DLC chia việc thành giai đoạn, dùng nhiều agent chuyên môn, hỏi các quyết định còn thiếu và dừng ở cổng duyệt. Nó cũng ghi lại nhật ký và kiến thức của nhóm để không mất ngữ cảnh khi dự án lớn dần.
