# gstack: biến Claude Code thành đội kỹ sư ảo từ CEO đến QA — hướng dẫn cài đặt và dùng

> gstack là bộ skill mã nguồn mở (MIT) của Garry Tan, biến Claude Code và một số agent lập trình khác thành đội ngũ ảo gồm CEO, kỹ sư, nhà thiết kế, QA và người phát hành. Bạn dùng bằng các lệnh như /office-hours, /review, /qa, /ship. Cài đặt chỉ cần dán một đoạn vào Claude Code, mất khoảng 30 giây theo README, nhưng cần có sẵn Git và Bun.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-17 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/gstack-doi-ky-su-ao-cho-claude-code

gstack là một bộ skill (lệnh gạch chéo) cho Claude Code, biến một phiên Claude Code thành cả đội làm sản phẩm: người nghĩ lại bài toán, người chốt kiến trúc, người soi thiết kế, người review code, người test bằng trình duyệt thật, người kiểm tra bảo mật và người đẩy PR. Tất cả là các file Markdown, miễn phí, giấy phép MIT. Tác giả là Garry Tan, Chủ tịch kiêm CEO của Y Combinator, và đây là bộ công cụ ông tự dùng hằng ngày.

Vấn đề repo giải quyết rất quen thuộc. Khi mở Claude Code, bạn nhìn vào một ô nhập trống và phải tự nghĩ ra cách hỏi, cách review, cách kiểm thử. gstack đưa sẵn quy trình: mỗi vai trò là một lệnh, và các lệnh nối tiếp nhau theo thứ tự một sprint thật. Repo hiện có khoảng 141 nghìn sao và khoảng 20,9 nghìn fork, viết chủ yếu bằng TypeScript, và vẫn được cập nhật trong 3 tháng gần đây.

Theo README, bộ này hợp với ba nhóm: founder hoặc CEO có chút kỹ thuật nhưng vẫn muốn tự ra sản phẩm; người mới dùng Claude Code, cần vai trò có cấu trúc thay vì prompt trống; và tech lead muốn review, QA, release chặt chẽ cho từng PR. Điểm đáng giá nhất là gstack không chỉ là một đống prompt rời rạc. Nó là một quy trình: `/office-hours` viết tài liệu thiết kế, các skill sau đọc lại tài liệu đó, và mỗi bước biết bước trước đã làm gì.

```repo
- repo | garrytan/gstack
- kind | Skill
- desc | Bộ 23 công cụ dạng lệnh gạch chéo giúp Claude Code đóng vai CEO, thiết kế, QA, bảo mật, release để lập kế hoạch, review, test và ship.
- stars | 141k
- lang | TypeScript
- license | MIT
```

## gstack làm được gì

README mô tả quy trình theo thứ tự: Nghĩ, Lên kế hoạch, Xây, Review, Test, Ship, Nhìn lại. Dưới đây là những skill đáng chú ý nhất, giải thích theo lợi ích thực tế.

### Nghĩ và lên kế hoạch

- **`/office-hours`**: bạn mô tả bạn đang làm gì, nó hỏi lại sáu câu hỏi buộc bạn nghĩ kỹ, phản biện cách bạn đặt vấn đề và đưa ra các hướng làm kèm ước lượng công sức. Kết quả là một tài liệu thiết kế mà các skill sau tự đọc. Lợi ích: bạn không lao vào code một ý tưởng chưa được hỏi vặn.
- **`/plan-ceo-review`**: đóng vai CEO, thử tìm "sản phẩm 10 sao" ẩn trong yêu cầu ban đầu. Có bốn chế độ: mở rộng, mở rộng có chọn lọc, giữ phạm vi, thu hẹp.
- **`/plan-design-review`**: đóng vai nhà thiết kế cấp cao, chấm từng khía cạnh từ 0 đến 10, giải thích mức 10 trông ra sao rồi sửa kế hoạch cho đạt. Có phát hiện "AI slop", tức giao diện đại trà do AI sinh ra.
- **`/plan-devex-review`**: soi trải nghiệm của lập trình viên dùng sản phẩm của bạn, từ lúc đọc tài liệu tới lúc chạy được lần đầu.
- **`/design-consultation`**: dựng một hệ thống thiết kế từ đầu và ghi ra file `DESIGN.md`.
- **`/autoplan`**: duyệt một kế hoạch từ đầu đến cuối, gồm sơ đồ luồng dữ liệu, ma trận test, các kiểu lỗi có thể xảy ra và vấn đề bảo mật.

### Review, test và phát hành

- **`/review`**: đóng vai kỹ sư cấp cao, tìm những lỗi qua được CI nhưng nổ khi lên production, và tự sửa các lỗi hiển nhiên. Nó còn báo những chỗ test bị làm yếu đi hoặc bị tắt, để một con người biết tên từng chỗ.
- **`/qa`**: mở trình duyệt thật trên URL staging của bạn (hoặc một API, CLI, job, webhook chạy cô lập ở máy), tái hiện lỗi và sửa.
- **`/verify`**: chạy các kiểm tra của repo (typecheck, lint, build) và các test phù hợp, sửa cái hỏng, lặp lại đến khi xanh, rồi bàn giao cho `/ship`.
- **`/ship`**: chạy test, review và tạo PR.
- **`/design-review`**: kiểm tra thiết kế như `/plan-design-review` nhưng sau đó sửa luôn, có commit nhỏ và ảnh trước/sau.
- **`/test-audit`**: quét các test tốn nhiều hơn giá trị chúng bảo vệ; mặc định chỉ báo cáo, không tự xoá.
- **`/cso`**: kiểm toán bảo mật theo OWASP và STRIDE. Skill này cần thêm bộ công cụ biên dịch gốc của máy.

Ngoài ra README còn liệt kê `/deslop-shared-libs` (gợi ý gom code dùng chung), `/write-skill` (viết hoặc chỉnh một skill cho gọn), `/devex-review` (kiểm thử trải nghiệm lập trình viên thật), `/make-pdf`, `/diagram` và `/gstack-upgrade`. Phần liệt kê trong tư liệu mình có bị cắt giữa chừng, nên danh sách đầy đủ 23 công cụ bạn nên xem trong README của repo.

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

Theo README, bạn cần:

- **Claude Code** đã cài và dùng được (đây là agent chính, được chứng nhận mức "full").
- **Git**.
- **Bun** phiên bản 1.4.2 trở lên (bản đã được test). Bước setup từ chối chạy nếu Bun cũ hơn 1.3.3, vì bản cũ để các công cụ đã biên dịch đọc được file `.env` của dự án.
- **Node.js** nếu bạn dùng Windows.
- Trên macOS, README khuyên dùng trình duyệt Aside (macOS 15 trở lên) cho các skill duyệt web, `/make-pdf` và `/diagram`. Không có Aside thì `./setup` sẽ dựng trình duyệt đi kèm của gstack.
- Với `/cso`: cần bộ công cụ biên dịch gốc. Setup sẽ báo nếu thiếu và tắt skill này.

Về tài khoản và tiền: README nói gstack miễn phí, nhưng không nói gì về chi phí dùng Claude Code, nên phần đó chưa có thông tin trong tư liệu. File `.env.example` của repo có một biến tên `ANTHROPIC_API_KEY`; README đoạn mình đọc không giải thích cách dùng nó, nên bạn hãy xem file đó và tài liệu trong repo nếu cần.

Về phần cứng: tư liệu không nhắc yêu cầu GPU hay cấu hình đặc biệt.

```note
Các skill như /review, /qa, /ship có thể sửa code, tạo commit và mở PR trong dự án của bạn. Lần đầu hãy thử trên một nhánh riêng hoặc một dự án nhỏ, và đọc kỹ những gì nó định làm trước khi đồng ý.
```

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

```steps
- Kiểm tra điều kiện | Có Claude Code, Git, Bun (và Node.js nếu dùng Windows)
- Cài gstack | Dán một đoạn yêu cầu vào Claude Code để nó clone và chạy setup
- Bật chế độ nhóm | Chạy một lệnh trong repo dự án để đồng đội tự có gstack (nên làm)
- Cài cho agent khác | Dùng ./setup --host nếu bạn không chỉ dùng Claude Code
- Thử lệnh đầu tiên | Gõ /office-hours trong Claude Code
```

### Bước 1: Cài trên máy của bạn

Mở Claude Code rồi dán nguyên đoạn dưới đây vào. Claude sẽ tự làm phần còn lại:

```text
Install gstack: run `git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup` then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing and never use mcp__claude-in-chrome__* tools. Claude Code lists the installed skills itself, so the section needs no skill list. Then ask the user if they also want to add gstack to the current project so teammates get it.
```

Đoạn lệnh bên trong làm ba việc: tải bản mới nhất của repo vào thư mục `~/.claude/skills/gstack` (`--depth 1` chỉ lấy bản mới nhất cho nhẹ), đi vào thư mục đó, rồi chạy `./setup`. Sau đó Claude thêm một mục "gstack" vào file CLAUDE.md, dặn dùng skill `/browse` của gstack mỗi khi cần duyệt web. Cuối cùng nó hỏi bạn có muốn thêm gstack vào dự án hiện tại cho đồng đội không.

Lưu ý cho người mới: dán vào khung chat của Claude Code, không phải vào PowerShell hay cửa sổ khác. Nếu bạn muốn tự gõ lệnh trong terminal, phần lõi là:

```bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup
```

Về kênh cập nhật: bản cài mới đi theo kênh `stable` (bản gắn tag, ra theo lịch thứ Hai và thứ Năm, tối đa một lần mỗi 72 giờ, lỗi quan trọng được vá trong khoảng một ngày), thay vì mọi commit trên main. Muốn đổi, chạy một trong hai lệnh sau:

```bash
~/.claude/skills/gstack/bin/gstack-config set update_channel main
~/.claude/skills/gstack/bin/gstack-config set update_channel stable
```

Lệnh đầu theo từng commit mới, lệnh sau chỉ theo bản phát hành.

### Bước 2: Bật chế độ nhóm (nên làm)

Bước này dành cho dự án có nhiều người. Hãy mở terminal ngay trong thư mục dự án của bạn rồi chạy:

```bash
(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"
```

Lệnh này chuyển bạn sang chế độ nhóm, chuẩn bị repo để đồng đội tự có gstack, rồi commit thay đổi. README cho biết repo của bạn không bị chép file vào, không lệch phiên bản, và mỗi phiên Claude Code đều kiểm tra cập nhật nhanh (tối đa mỗi giờ một lần, im lặng, an toàn khi mất mạng). Nếu muốn nhắc nhẹ thay vì bắt buộc, đổi `required` thành `optional`. Chú ý: hook `required` chạy bằng Node.js, nên mọi đồng đội cần có Node.js trong PATH. Muốn gỡ gstack, xem docs/uninstall.md trong repo.

### Bước 3: Cài cho agent khác (không bắt buộc)

`./setup` trần chỉ cài cho Claude Code. Muốn dùng với agent khác, hãy làm như sau:

```bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host auto      # or: ./setup --host codex
./setup --status                         # one row per install: host, tier, scope, version, path
```

`--host auto` cài cho mọi agent mà setup tìm thấy trên máy; `--host codex` chỉ cài cho Codex. Lệnh `./setup --status` in mỗi bản cài một dòng: agent nào, mức nào, phạm vi, phiên bản, đường dẫn. README liệt kê các agent hỗ trợ: Codex CLI, OpenCode, Cursor, Factory Droid, Kiro, GitHub Copilot CLI, Antigravity CLI, Gemini CLI, OpenClaw, Hermes (đa số ở mức "experimental"). Chi tiết từng agent nằm ở docs/hosts.md.

Về Windows: README chỉ ghi "cần Node.js trên Windows" và nhắc docs/install.md cho thời gian cài đặt, hook và điều kiện chi tiết. Phần hướng dẫn riêng cho Windows mình không thấy trong tư liệu, nên bạn hãy đọc file đó trước khi cài.

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

Cách nhanh nhất: mở Claude Code và gõ `/office-hours`. README nói đây là lệnh gọi đầu tiên cho Claude Code. Nếu mọi thứ ổn, Claude sẽ bắt đầu hỏi bạn về điều bạn đang làm, về nỗi đau cụ thể chứ không phải tính năng.

Nếu bạn cài cho nhiều agent, chạy:

```bash
./setup --status
```

Bạn sẽ thấy mỗi bản cài một dòng với agent, mức hỗ trợ, phạm vi, phiên bản và đường dẫn. Ở agent khác Claude, cách gọi lệnh đầu tiên khác nhau: một số dùng `/gstack-office-hours`, một số chỉ cần bạn nhờ Claude "ask for gstack-office-hours" theo bảng trong README.

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

### Founder có ý tưởng nhưng chưa rõ nên làm gì

Bối cảnh: bạn muốn làm một ứng dụng tóm tắt lịch mỗi sáng, nhưng chưa chắc nên xây gì trước. Gõ `/office-hours` và kể vấn đề bằng ví dụ cụ thể, ví dụ nhiều lịch Google, sự kiện sai thông tin, địa điểm sai. Theo ví dụ trong README, công cụ sẽ phản biện cách bạn đặt tên sản phẩm, rút ra các khả năng bạn chưa nhận ra, thách thức vài giả định để bạn đồng ý hoặc chỉnh, rồi đưa ba hướng làm kèm khuyến nghị làm cái nhỏ nhất trước. Kết quả là một tài liệu thiết kế. Sau đó chạy `/plan-ceo-review` để nó đọc tài liệu và thử rà phạm vi.

> Đây không phải một trợ lý. Đây là cả một đội.
>
> — Ông T

### Lập trình viên review nhánh trước khi gộp

Bối cảnh: bạn vừa sửa xong một nhánh, test xanh, nhưng chưa dám gộp. Chuyển sang nhánh đó và gõ `/review`. Theo README, nó tìm lỗi qua được CI nhưng hỏng khi chạy thật (ví dụ race condition), tự sửa các lỗi hiển nhiên và hỏi bạn với những chỗ cần quyết định. Nó cũng báo những test, timeout hay suppression bị làm yếu đi. Kết quả bạn nhận là danh sách những gì đã tự sửa và những gì cần bạn duyệt.

### Kiểm thử trang staging như một người dùng thật

Bối cảnh: bạn có trang staging và muốn biết các luồng chính có chạy không. Gõ lệnh sau (thay bằng URL của bạn):

```text
/qa https://staging.myapp.com
```

README cho biết nó mở trình duyệt thật, bấm qua các luồng, tìm và sửa lỗi. Skill này cũng chạy được trên API, CLI, job hoặc webhook cục bộ cô lập. Kết quả: lỗi đã tái hiện được kèm chỗ sửa; bạn kiểm tra lại trước khi đi tiếp.

### Đội nhóm muốn mọi PR đều đi qua một quy trình chung

Bối cảnh: một tech lead muốn cả đội dùng chung bộ skill mà không phải cài tay. Chạy lệnh chế độ nhóm ở Bước 2 trong repo dự án. Từ đó mỗi phiên Claude Code của đồng đội tự kiểm tra cập nhật. Khi làm một tính năng, quy trình đầy đủ là `/autoplan` duyệt kế hoạch, sau khi duyệt thì Claude viết code, rồi `/review`, `/qa` và cuối cùng `/ship` chạy test, review và tạo PR. Ví dụ trong README kết thúc với số test tăng từ 42 lên 51 và một PR đã mở. Đó là minh hoạ của tác giả, kết quả thật của bạn sẽ khác.

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

### Setup từ chối chạy vì Bun cũ

README nói rõ setup không chạy với Bun cũ hơn 1.3.3, và bản được test là 1.4.2 trở lên. Hãy nâng Bun lên bản mới rồi chạy lại `./setup`. Đừng cố vượt qua kiểm tra này, vì lý do của nó là bảo vệ file `.env` của dự án.

### Gõ lệnh gạch chéo mà Claude không nhận ra

Có thể quá trình cài chưa xong hoặc bị lỗi giữa chừng. Hãy chạy lại `./setup` trong `~/.claude/skills/gstack`; README ghi đây cũng là lệnh sửa chữa cho Claude Code (`./setup --host claude`). Dùng `./setup --status` để xem bản cài có được ghi nhận không.

### `/cso` không dùng được

Skill kiểm toán bảo mật cần bộ công cụ biên dịch gốc. Nếu máy thiếu, setup sẽ báo và để skill này ở trạng thái không dùng được. Hãy xem docs/install.md để biết điều kiện chính xác rồi chạy lại setup sau khi cài đủ.

### Đồng đội ở chế độ nhóm bị chặn vì thiếu Node.js

Hook `required` chạy bằng Node.js, nên máy nào chưa có Node.js trong PATH sẽ gặp vấn đề. Cài Node.js cho máy đó, hoặc đổi `required` thành `optional` nếu bạn chỉ muốn nhắc nhở.

### Dùng với agent khác nhưng quy tắc an toàn không chặn gì

Theo bảng trong README, chỉ Claude Code có skill an toàn được thực thi bằng hook chặn thật. Ở các agent khác, chúng chỉ ở mức khuyến cáo. Vì vậy với agent khác Claude, bạn hãy tự đọc kỹ trước khi cho phép chạy lệnh. Ngoài ra một số tính năng review bên ngoài cần Codex CLI hoặc Claude Code CLI đã đăng nhập.

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

**Điểm mạnh.** gstack cho bạn một quy trình sẵn sàng thay vì tự mày mò prompt. Các skill nối với nhau qua tài liệu thiết kế và kế hoạch test, nên không bị rời rạc. Cài nhanh, miễn phí, giấy phép MIT, có thể fork và sửa. Dự án đang được cập nhật đều và có kênh `stable` cho người muốn ổn định.

**Giới hạn.** Bạn cần quen với terminal ở mức cơ bản và phải có Git, Bun (và Node.js trên Windows). Chỉ Claude Code được chứng nhận mức "full"; các agent khác là thử nghiệm và an toàn chỉ ở mức khuyến cáo. Hướng dẫn riêng cho Windows và chi phí dùng Claude Code không có trong tư liệu mình đọc. Bộ công cụ cũng khá lớn (23 công cụ), nên người mới đừng cố học hết: README tự khuyên bắt đầu bằng `/office-hours`, `/review`, `/qa` rồi dừng lại xem có hợp không.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ cần một vài tác vụ nhỏ, hoặc không dùng Claude Code và không muốn cài Bun, một bộ prompt đơn giản có thể đủ. Nếu dự án của bạn không có code (chỉ văn bản, bảng tính), phần lớn skill ở đây sẽ ít giá trị. Còn nếu bạn là founder hoặc lập trình viên đang dùng Claude Code hằng ngày, đây là một bộ khung đáng thử trên một nhánh nhỏ trước khi áp dụng cho cả đội.

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

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

README ghi gstack là phần mềm mã nguồn mở, miễn phí, giấy phép MIT. Chi phí dùng Claude Code hoặc các agent khác mà gstack chạy trên đó không được nêu trong tư liệu, nên chưa có thông tin.

### Cài gstack cần những gì?

Cần Claude Code, Git và Bun từ 1.4.2 trở lên (setup từ chối Bun cũ hơn 1.3.3). Trên Windows cần thêm Node.js. Một số skill như /cso cần thêm bộ công cụ biên dịch gốc, và setup sẽ báo nếu thiếu.

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

README có nhắc cần Node.js trên Windows, nhưng không có hướng dẫn riêng từng bước cho Windows trong phần mình đọc. Hãy xem docs/install.md trong repo để biết chi tiết.

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

Tư liệu không nhắc yêu cầu GPU hay phần cứng đặc biệt nào. gstack là bộ lệnh dạng Markdown chạy trong agent lập trình, nên phần xử lý nặng nằm ở dịch vụ mô hình mà agent dùng.

### Có dùng được với Cursor, Codex hay Gemini CLI không?

Có. Dùng ./setup --host kèm tên agent, hoặc --host auto để cài cho mọi agent tìm thấy. Chỉ Claude Code ở mức full, các agent khác như Codex, Cursor, Gemini CLI ở mức experimental và các skill an toàn chỉ mang tính khuyến cáo.

### gstack khác gì việc tự viết prompt cho Claude Code?

gstack chia công việc thành các vai trò (CEO, thiết kế, review, QA, release) và nối chúng thành một quy trình, trong đó skill sau đọc kết quả của skill trước. Bạn không phải tự nghĩ prompt từ đầu cho mỗi bước.

### Làm sao cập nhật hoặc gỡ gstack?

Bản cài mới đi theo kênh stable và tự kiểm tra cập nhật; có lệnh /gstack-upgrade để làm mới các bản đã cài. Bạn đổi kênh bằng gstack-config set update_channel. Cách gỡ nằm trong docs/uninstall.md của repo.
