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

> gstack là bộ khoảng 23 skill (lệnh dạng /tên) cho Claude Code và một số agent lập trình khác. Mỗi lệnh đóng một vai như CEO, thiết kế, review code, QA, bảo mật, phát hành. Cài bằng một lệnh git clone rồi chạy ./setup, khá nhanh nếu bạn đã có Claude Code, Git và Bun.

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

gstack là bộ "skill" (các lệnh gõ dạng `/tên-lệnh`) cho Claude Code, biến một cửa sổ chat lập trình thành một đội làm sản phẩm ảo: có người đặt câu hỏi khó về ý tưởng, người chốt kiến trúc, người soi thiết kế, người tìm lỗi trước khi lên production, người mở trình duyệt thật để test, và người đóng gói Pull Request. Tác giả là Garry Tan, Chủ tịch kiêm CEO của Y Combinator. Đây là bộ công cụ ông tự dùng hằng ngày rồi chia sẻ công khai.

Bạn nên xem repo này nếu bạn là founder biết code một chút, người mới dùng Claude Code và thấy khung chat trống rất khó biết bắt đầu từ đâu, hoặc tech lead muốn mỗi PR đều có review, test và QA bài bản. Repo hiện có khoảng 141.413 sao và 20.883 fork, giấy phép MIT, miễn phí.

Điểm đáng giá nhất là gstack không phải một đống công cụ rời rạc mà là một quy trình. Các lệnh nối nhau: `/office-hours` viết ra một tài liệu thiết kế, các lệnh sau đọc lại tài liệu đó, và cuối cùng `/ship` chạy test, review rồi mở PR. Bạn không phải tự nhớ phải dặn AI những gì ở mỗi bước.

```repo
- repo | garrytan/gstack
- kind | Skill
- desc | gstack là bộ slash command cho Claude Code, đóng vai CEO, designer, reviewer, QA, bảo mật và release engineer để bạn làm sản phẩm có quy trình.
- stars | 141k
- lang | TypeScript
- license | MIT
```

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

README mô tả quy trình theo thứ tự một sprint: Nghĩ → Lập kế hoạch → Xây → Review → Test → Ship → Nhìn lại. Dưới đây là những lệnh nổi bật trong phần README mình đọc được.

- **`/office-hours` (vai YC Office Hours):** bắt đầu từ đây. Nó hỏi sáu câu "ép" để định hình lại sản phẩm trước khi bạn viết code, phản biện cách bạn đặt vấn đề, đề xuất các hướng làm khác nhau, rồi viết một tài liệu thiết kế cho các lệnh sau dùng. Lợi ích: tránh làm nhầm thứ ngay từ đầu.
- **`/plan-ceo-review` (vai CEO):** nghĩ lại vấn đề, tìm bản "10 sao" ẩn trong yêu cầu. Có bốn chế độ: mở rộng, mở rộng chọn lọc, giữ nguyên phạm vi, thu hẹp.
- **`/plan-design-review` và `/design-review` (vai designer):** chấm từng khía cạnh thiết kế từ 0-10, nói bản 10 điểm trông thế nào, và phát hiện kiểu thiết kế "AI slop". Bản `/design-review` còn sửa luôn những gì nó tìm ra.
- **`/plan-devex-review` và `/devex-review`:** soi trải nghiệm của lập trình viên khi dùng sản phẩm của bạn, từ tài liệu đến luồng bắt đầu.
- **`/design-consultation`:** dựng cả hệ thống thiết kế từ đầu và ghi ra file `DESIGN.md`.
- **`/review` (vai staff engineer):** tìm lỗi qua được CI nhưng nổ ở production, tự sửa những lỗi hiển nhiên. Nó cũng báo những chỗ ai đó làm yếu test, timeout hay snapshot.
- **`/qa`:** mở trình duyệt thật trên URL staging (hoặc một API, CLI, job, webhook cục bộ tách biệt), bấm thử luồng, tái hiện lỗi và sửa.
- **`/autoplan`:** duyệt một kế hoạch từ đầu đến cuối.
- **`/ship`:** chạy test, review và tạo PR.
- **`/verify`:** chạy các kiểm tra của chính repo (typecheck, lint, build) cùng các test phù hợp, sửa đến khi xanh rồi chuyển sang `/ship`.
- **Các lệnh khác:** `/cso` (kiểm tra bảo mật theo OWASP và STRIDE), `/test-audit` (tìm những test tốn công hơn giá trị), `/deslop-shared-libs` (gợi ý gom code dùng chung), `/write-skill` (viết hoặc chỉnh một skill), `/make-pdf` và `/diagram`.

Ngoài Claude Code, gstack còn cài được cho Codex CLI, OpenCode, Cursor, Factory Droid, Kiro, GitHub Copilot CLI, Antigravity CLI, Gemini CLI, OpenClaw, Hermes. Riêng Claude Code là mức "full" (được chứng nhận bằng một lần chạy quy trình thật), các agent khác đang ở mức thử nghiệm.

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

Theo README, bạn cần:

- **Claude Code** đã cài và đăng nhập được.
- **Git.**
- **Bun** phiên bản 1.4.2 trở lên (đây là bản đã test; bước setup từ chối Bun cũ hơn 1.3.3).
- **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). Nếu không có, `./setup` sẽ dựng trình duyệt đi kèm của gstack.
- Lệnh `/cso` cần thêm bộ công cụ biên dịch gốc (native toolchain). Nếu máy thiếu, setup sẽ báo và để `/cso` ở trạng thái không dùng được.
- Nếu dùng review từ bên ngoài, Claude Code cần "Codex CLI, đã đăng nhập"; với các agent khác thì ngược lại là Claude Code CLI hoặc Codex CLI đã đăng nhập.

File `.env.example` trong repo chỉ liệt kê một biến là `ANTHROPIC_API_KEY`. README phần mình đọc không nói rõ khi nào cần điền, nên bạn xem thêm `docs/install.md` trong repo.

Phần README mình có chưa mô tả riêng cách chạy trên Windows (ngoài việc cần Node.js). Nếu bạn dùng Windows, hãy đọc `docs/install.md` trước khi bắt đầu.

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

```steps
- Mở Claude Code | Cần đăng nhập sẵn, và máy đã có Git, Bun
- Dán lệnh cài | git clone vào thư mục skills rồi chạy ./setup
- Thêm mục vào CLAUDE.md | Dặn Claude dùng /browse của gstack để duyệt web
- Bật team mode (tuỳ chọn) | Chạy một lệnh trong repo của nhóm để đồng đội tự có gstack
- Thử /office-hours | Gõ lệnh đầu tiên để xem gstack hoạt động
```

### Cài trên máy của bạn

Cách README khuyên là mở Claude Code rồi dán một câu yêu cầu để Claude tự làm. Câu đó chứa lệnh sau, bạn cũng có thể tự chạy trong terminal:

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

Lệnh này làm ba việc: tải bản mới nhất của repo vào thư mục `~/.claude/skills/gstack` (nơi Claude Code đọc skill), đi vào thư mục đó, rồi chạy `./setup`. Người mới hay vấp ở chỗ: phải chạy `./setup` ngay trong thư mục `gstack`, không phải thư mục dự án của bạn.

Nếu muốn Claude làm giúp, dán nguyên câu README gợi ý vào Claude Code:

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

Phần "thêm mục gstack vào CLAUDE.md" là để Claude luôn dùng `/browse` của gstack khi cần lên web, và không dùng các công cụ `mcp__claude-in-chrome__*`.

### Chọn kênh cập nhật (nếu muốn)

Bản cài mới mặc định theo kênh `stable` (bản có gắn tag, cập nhật chậm hơn nhưng ổn định hơn). Nếu muốn theo từng thay đổi mới nhất, hoặc quay lại kênh ổn định, README ghi hai lệnh:

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

Người mới cứ để mặc định là được.

### Bật team mode cho cả nhóm (khuyến nghị trong README)

Nếu bạn làm việc cùng người khác trên một repo, đứng trong repo đó và chạy lệnh sau. Nó chuyển sang team mode, thiết lập để đồng đội tự có gstack, rồi commit thay đổi:

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

README cho biết cách này không đưa file gstack vào repo của bạn, và mỗi phiên Claude Code sẽ kiểm tra cập nhật nhanh, tối đa mỗi giờ một lần. Nếu muốn chỉ nhắc đồng đội chứ không 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.

### Cài cho agent khác (nếu không dùng Claude Code)

```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. `./setup --status` liệt kê từng bản cài. Muốn gỡ gstack, README trỏ tới `docs/uninstall.md`.

```note
Dán lệnh vào Claude Code nghĩa là bạn cho nó quyền chạy lệnh trên máy bạn. Hãy đọc kỹ lệnh trước khi đồng ý, và chỉ cài từ đúng địa chỉ garrytan/gstack. Với team mode, lệnh sẽ tự commit vào repo, nên chạy trong một nhánh sạch.
```

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

Cách đơn giản nhất theo README là gõ `/office-hours` trong Claude Code. Nếu cài đúng, Claude sẽ đáp bằng các câu hỏi về nỗi đau mà bạn đang giải quyết (README mô tả nó hỏi ví dụ cụ thể, không phải giả định). Đó là dấu hiệu skill đã được nạp.

Bạn cũng có thể chạy trong thư mục gstack:

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

Lệnh này in mỗi bản cài một dòng gồm host, tier, phạm vi, phiên bản và đường dẫn. Thấy dòng cho Claude Code là yên tâm. Nếu `/cso` không dùng được, đó có thể chỉ do máy thiếu native toolchain, setup đã báo trước.

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

### Chủ doanh nghiệp nhỏ biết code chút ít, muốn làm một app

Bối cảnh: bạn có ý tưởng "app nhắc việc hằng ngày" nhưng chưa rõ nên làm gì trước. Trong Claude Code gõ `/office-hours` rồi mô tả bạn đang làm gì và đau ở đâu. README có ví dụ: người dùng nói muốn làm app tóm tắt lịch, gstack phản biện rằng thực ra họ đang mô tả một trợ lý chief of staff bằng AI, rồi đề xuất bắt đầu từ phần hẹp nhất để học từ người dùng thật. Kết quả là một tài liệu thiết kế mà các lệnh sau sẽ đọc.

### Lập trình viên mới, trước khi gửi PR

Bối cảnh: bạn vừa viết xong tính năng trên một nhánh. Chạy `/review` trên nhánh đó. README nói nó tìm những lỗi qua được CI nhưng hỏng ở production, tự sửa lỗi hiển nhiên và hỏi bạn khi cần quyết định (ví dụ một lỗi race condition). Sau đó `/ship` chạy test, review rồi mở PR. Trong ví dụ của README, số test tăng từ 42 lên 51.

> Nó không phải trợ lý gợi ý code, mà là cả một đội làm việc theo thứ tự của một sprint.
>
> — Ông T

### Chủ shop hoặc nhân viên kiểm thử trang web

Bối cảnh: bạn có một trang staging và muốn biết có lỗi bấm nút, lỗi form không. Gõ `/qa https://địa-chỉ-staging-của-bạn`. README mô tả nó mở trình duyệt thật, bấm qua các luồng, tái hiện lỗi và sửa. Bạn nhận lại danh sách lỗi đã tìm và đã sửa. Với API, CLI, job hoặc webhook chạy cục bộ, README nói chạy được khi nó nằm ở môi trường tách biệt.

### Founder cần xin ý kiến về thiết kế và bảo mật

Bối cảnh: bạn dựng xong giao diện đầu tiên. Chạy `/design-review` để chấm điểm từng khía cạnh thiết kế và sửa kèm commit nhỏ, có ảnh trước/sau. Với phần bảo mật, `/cso` chạy kiểm tra theo OWASP và STRIDE. Hai lệnh này cho bạn góc nhìn của chuyên gia mà bạn chưa có người thật để hỏi.

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

- **Bun quá cũ.** README nói setup từ chối Bun cũ hơn 1.3.3, và bản đã test là 1.4.2 trở lên. Cập nhật Bun rồi chạy lại `./setup`.
- **Gõ lệnh `/office-hours` mà Claude không nhận.** Có thể bước cài chưa chạy xong hoặc `./setup` chưa chạy đúng thư mục. Chạy lại phần setup trong `~/.claude/skills/gstack`, rồi mở phiên Claude Code mới. Cài cho agent khác thì xem cách gọi lệnh trong bảng host (ví dụ Codex là "ask for gstack-office-hours").
- **`/cso` không dùng được.** Máy thiếu native toolchain. Setup đã cảnh báo; bạn cần bổ sung toolchain theo hướng dẫn trong `docs/install.md`.
- **Đồng đội không có gstack sau khi bật team mode.** Hook `required` chạy bằng Node.js, nên mọi người cần Node.js trong PATH. Kiểm tra bằng cách chạy `node --version`.
- **Muốn dùng bản mới nhất nhưng thấy cập nhật chậm.** Đó là do kênh `stable`. Nếu thật sự cần, dùng lệnh `gstack-config set update_channel main` ở trên, chấp nhận rủi ro bản mới chưa qua kiểm chứng.

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

**Điểm mạnh:** có quy trình rõ từ ý tưởng đến PR, miễn phí, giấy phép MIT, repo được cập nhật trong ba tháng gần đây, chạy trên nhiều agent chứ không chỉ Claude Code. Với người mới, lợi ích lớn nhất là có sẵn các vai trò thay vì khung chat trống.

**Giới hạn:** README tự mô tả bộ công cụ là "opinionated" (mang quan điểm riêng của tác giả), nên bạn phải chấp nhận cách làm việc của nó. Các agent ngoài Claude Code đều ở mức thử nghiệm và phần an toàn chỉ mang tính tham khảo, không chặn được. Số lệnh khá nhiều nên học dần từng lệnh là hợp lý. Mình chưa có thông tin về chi phí token khi chạy cả quy trình, nhưng vì mọi lệnh chạy qua agent của bạn nên bạn nên theo dõi hạn mức tài khoản.

**Nên chọn cách khác khi:** bạn chỉ cần sửa nhanh một lỗi nhỏ, hoặc không dùng Git và dòng lệnh. Khi đó một lệnh riêng lẻ trong gstack (như `/review`) có thể là đủ, hoặc bạn chỉ cần chat thường với Claude Code.

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

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

README ghi rõ là miễn phí và theo giấy phép MIT. Tuy nhiên gstack chạy trên Claude Code hoặc agent khác, nên việc bạn dùng các dịch vụ đó có thể có chi phí riêng. Repo không nói gì thêm về chi phí này.

### gstack khác gì việc tự chat với Claude Code?

gstack cho bạn các lệnh có sẵn vai trò (CEO, designer, reviewer, QA, bảo mật, release) và chúng nối tiếp nhau, ví dụ tài liệu từ /office-hours được các lệnh sau đọc lại. Bạn không phải tự viết lại hướng dẫn mỗi lần.

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

README có nhắc cần Node.js trên Windows, nhưng phần mình đọc không mô tả riêng các bước cài trên Windows. Bạn nên xem docs/install.md trong repo trước khi cài.

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

Cần Claude Code, Git và Bun từ 1.4.2 trở lên (bản đã test). Dùng Windows thì cần thêm Node.js. Lệnh /cso còn cần native toolchain; nếu thiếu, setup sẽ báo và để /cso không dùng được.

### gstack có chạy với Codex, Cursor hay Gemini CLI không?

Có. README liệt kê Codex CLI, OpenCode, Cursor, Factory Droid, Kiro, GitHub Copilot CLI, Antigravity CLI, Gemini CLI, OpenClaw, Hermes. Claude Code là mức đầy đủ, các agent còn lại đang ở mức thử nghiệm với phần an toàn mang tính tư vấn, không chặn.

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

README phần mình có không trả lời trực tiếp câu hỏi này. Repo có file SECURITY.md; nếu bạn làm việc với mã nguồn nhạy cảm, hãy đọc file đó và các hook mà setup đăng ký (xem docs/install.md) trước khi dùng.

### Làm sao để cả nhóm cùng dùng gstack?

Chạy lệnh team mode trong repo của nhóm. README nói cách này không đưa file gstack vào repo, giúp đồng đội tự có gstack và không bị lệch phiên bản. Đổi required thành optional nếu chỉ muốn nhắc nhở.
