gstack: biến Claude Code thành đội ngũ ảo gồm CEO, QA, reviewer — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về garrytan/gstack — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: gstack: biến Claude Code thành cả đội kỹ sư ảo — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
gstack là bộ khoảng hai chục kỹ năng (skill) dạng lệnh gạch chéo cho Claude Code và một số agent lập trình khác, do Garry Tan (Chủ tịch kiêm CEO của Y Combinator) chia sẻ theo giấy phép MIT. Mỗi lệnh đóng một vai: tư vấn sản phẩm, duyệt kế hoạch, review code, kiểm thử bằng trình duyệt thật, rồi đẩy PR. Cài khá nhanh: dán một câu lệnh vào Claude Code hoặc chạy git clone rồi ./setup, nhưng cần có sẵn Git và Bun.
gstack là một bộ kỹ năng (skill) cho Claude Code, được viết hoàn toàn bằng Markdown và gọi bằng lệnh gạch chéo như /review hay /qa. Mỗi lệnh khiến Claude đóng một vai chuyên môn: nhà tư vấn sản phẩm, CEO, nhà thiết kế, kỹ sư review, người kiểm thử, chuyên gia bảo mật, người phát hành bản. Tác giả là Garry Tan, Chủ tịch kiêm CEO của Y Combinator, và ông nói đây là bộ công cụ ông tự dùng hằng ngày. Repo hiện có khoảng 141.000 sao và khoảng 20.800 fork, giấy phép MIT, miễn phí.
Vấn đề repo giải quyết khá quen thuộc. Khi bạn bảo một AI viết code, nó thường làm đúng điều bạn nói mà không hỏi lại. Nó cũng không tự kiểm tra bằng trình duyệt thật, và không biết xem lại những chỗ lỗi chỉ lộ ra khi chạy thật. gstack ép AI đi theo một quy trình giống một nhóm làm việc: nghĩ trước, lập kế hoạch, làm, review, kiểm thử, rồi mới phát hành.
Bạn nên đọc tiếp nếu bạn là founder, người làm sản phẩm có biết chút code, người mới dùng Claude Code và thấy khung chat trống hơi khó, hoặc tech lead muốn review và QA đều tay trên mỗi PR. Điểm đáng giá nhất là các bước nối với nhau: lệnh sau đọc kết quả của lệnh trước, nên bạn không phải giải thích lại từ đầu mỗi lần.
garrytan/gstack
gstack là bộ slash command Markdown miễn phí, biến Claude Code thành đội ngũ ảo: CEO, designer, reviewer, QA, bảo mật và người đẩy bản phát hành.
I.gstack làm được gì
README mô tả gstack như một quy trình chạy theo thứ tự: Nghĩ → Lập kế hoạch → Làm → Review → Kiểm thử → Phát hành → Nhìn lại. Dưới đây là các lệnh chính, giải thích theo lợi ích thực tế.
/office-hours— buổi tư vấn đầu tiên. Bạn mô tả bạn định làm gì, nó hỏi sáu câu hỏi buộc bạn nghĩ lại, phản biện cách bạn đặt vấn đề, đưa ra các hướng làm khác nhau rồi ghi thành một tài liệu thiết kế. Các lệnh sau đọc tài liệu này. Lợi ích: bạn tránh việc code ngay một ý tưởng chưa chín./plan-ceo-review— nhìn lại bài toán. Nó thử mở rộng hoặc thu hẹp phạm vi, có bốn chế độ: Expansion, Selective Expansion, Hold Scope, Reduction. Hợp khi bạn sợ làm quá to hoặc quá nhỏ./plan-design-reviewvà/design-review— thiết kế. Bản đầu chấm từng khía cạnh thiết kế từ 0 đến 10 rồi sửa kế hoạch, có cả phát hiện kiểu thiết kế "AI slop" (làm theo mẫu chung chung của AI). Bản sau làm cùng việc nhưng còn sửa code, commit nhỏ và có ảnh trước/sau./design-consultation— dựng hệ thiết kế từ đầu. Nó ghi ra fileDESIGN.md./plan-devex-reviewvà/devex-review— trải nghiệm lập trình viên. Bản thứ hai thử đi qua phần hướng dẫn bắt đầu như người dùng thật và đo thời gian./review— kỹ sư cấp cao soi code. Tìm lỗi qua được CI nhưng hỏng khi chạy thật, tự sửa lỗi hiển nhiên, và báo cho bạn biết mọi chỗ test bị nới lỏng hay bị tắt./qa— kiểm thử. Mở trình duyệt thật vào địa chỉ staging của bạn (hoặc một API, CLI, job, webhook chạy cô lập trên máy), tái hiện lỗi và sửa./verifychạ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./autoplanduyệt một kế hoạch từ đầu đến cuối./shipchạy test, review và tạo PR.- Các lệnh phụ trợ:
/test-auditrà những test tốn công hơn giá trị,/deslop-shared-libsgợi ý chỗ nên gom code dùng chung,/write-skillgiúp viết hoặc chỉnh skill mới,/csokiểm tra bảo mật theo OWASP và STRIDE.
README giới thiệu tổng cộng 23 công cụ. Danh sách ở trên là những cái phần README mình có trong tay nêu rõ. Danh sách đầy đủ bạn xem trong thư mục repo.
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 và Hermes. Mức hỗ trợ khác nhau, mình nói kỹ ở phần cài đặt.
II.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 (bản đã được thử nghiệm). Trình cài đặt từ chối chạy với Bun cũ hơn 1.3.3.
- Node.js nếu bạn dùng Windows. Chế độ nhóm (team mode) cũng cần Node.js trên PATH của mọi thành viên.
- Trên macOS, README khuyên dùng trình duyệt Aside (macOS 15 trở lên). Các skill về trình duyệt,
/make-pdfvà/diagramsẽ điều khiển nó bằng phiên đăng nhập thật của bạn. Nếu không có,./setuptự dựng trình duyệt đi kèm của gstack. /csocần thêm bộ công cụ biên dịch gốc của máy. Nếu thiếu, setup sẽ báo và để/csoở trạng thái không dùng được.
File .env.example trong repo có nhắc đến biến ANTHROPIC_API_KEY. README phần mình có không giải thích khi nào cần điền, nên nếu bạn đã đăng nhập Claude Code bình thường thì cứ cài trước rồi xem lại tài liệu nếu có thông báo yêu cầu key.
README phần mình có không nói gì về yêu cầu GPU hay dung lượng ổ đĩa. Chi tiết thời gian cài, điều kiện của /cso và các hook mà setup đăng ký nằm trong docs/install.md của repo.
III.Cài đặt từng bước
- Mở Claude CodeChạy trong thư mục nào cũng được cho bước cài đầu tiên
- Cài gstackDán câu lệnh clone và chạy ./setup, hoặc tự gõ trong terminal
- Bật chế độ nhómChỉ làm nếu bạn muốn cả nhóm dùng chung trong một repo
- Cài cho agent khácDùng ./setup --host nếu không dùng Claude Code
- Kiểm traChạy /office-hours hoặc ./setup --status
A.Cài gstack trên máy của bạn
Cách README khuyến nghị là mở Claude Code và dán một đoạn yêu cầu, để Claude tự làm. Đoạn dán vào có nội dung như sau:
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.Nếu muốn tự làm, phần lệnh chính là:
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setupLệnh này làm ba việc nối nhau bằng &&. Một: tải bản mới nhất của repo (chỉ một nhánh, không tải lịch sử) vào thư mục ~/.claude/skills/gstack. Hai: đi vào thư mục đó. Ba: chạy ./setup. Dấu && nghĩa là nếu bước trước lỗi thì bước sau không chạy.
Chỗ người mới hay vấp: lệnh ./setup là một file chạy, nên bạn phải đứng đúng trong thư mục gstack rồi mới gõ. Nếu dùng Windows, README nói cần Node.js nhưng không chỉ rõ cách chạy ./setup ở đó. Bạn xem docs/install.md trong repo trước khi thử.
Về cập nhật: bản cài mới đi theo kênh stable (bản phát hành có gắn thẻ), không phải mọi thay đổi trên nhánh main. Muốn đổi kênh, README ghi hai lệnh:
~/.claude/skills/gstack/bin/gstack-config set update_channel main
~/.claude/skills/gstack/bin/gstack-config set update_channel stableLệnh đầu theo từng thay đổi trên main, lệnh sau chỉ theo bản phát hành. Chi tiết ở docs/releases.md.
Skill là các file hướng dẫn mà Claude sẽ đọc và làm theo, còn `./setup` là một script chạy trên máy bạn. Trước khi cài, bạn nên mở repo xem qua, nhất là khi dùng trên máy có dữ liệu quan trọng. Phần safety skill chỉ được "enforced" (chặn bằng hook) trên Claude Code. Trên các agent khác README ghi là chỉ mang tính khuyến cáo.
B.Bật chế độ nhóm cho repo dùng chung
Bước này README gọi là khuyến nghị nếu bạn làm việc theo nhóm. Từ bên trong thư mục repo dự án của bạn (không phải thư mục gstack), chạy:
(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 máy bạn sang chế độ nhóm, chuẩn bị repo để đồng đội tự có gstack, rồi tạo một commit. Theo README, repo không chứa file gstack vendored (không sao chép mã vào), nên không bị lệch phiên bản. Mỗi phiên Claude Code bắt đầu bằng một lần kiểm tra cập nhật, giới hạn một lần mỗi giờ, lỗi mạng cũng không ảnh hưởng.
Nếu bạn chỉ muốn nhắc đồng đội thay vì bắt buộc, đổi required thành optional. Chế độ required chạy hook bằng Node.js, nên mọi người trong nhóm phải có Node.js. Gỡ cài: xem docs/uninstall.md.
C.Cài cho agent khác ngoài Claude Code
./setup trần chỉ cài cho Claude Code. Muốn chọn agent khác, README ghi:
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 in mỗi bản cài một dòng: agent nào, mức hỗ trợ, phạm vi, phiên bản, đường dẫn. Các giá trị --host khác có trong bảng của README, ví dụ opencode, cursor, factory, kiro, copilot, agy, gemini, openclaw, hermes.
README chia mức hỗ trợ thành ba bậc. Full (đã chứng nhận bằng một lần chạy quy trình thật) hiện chỉ Claude Code. Experimental là cài được và qua kiểm tra tương thích nhưng chưa chứng nhận. Instruction-only là không cài gì, setup chỉ in ra thứ cần sao chép. Với agent không phải Claude Code, cách gọi lệnh khác một chút, ví dụ hỏi theo kiểu "gstack-office-hours" thay vì gõ /office-hours.
IV.Kiểm tra đã chạy được chưa
Cách nhanh nhất là mở Claude Code và gõ /office-hours. Nếu cài đúng, Claude nhận lệnh và bắt đầu hỏi về việc bạn định làm. Theo README, Claude Code tự liệt kê các skill đã cài nên bạn cũng có thể gõ dấu / để xem danh sách.
Nếu dùng --host, chạy ./setup --status trong thư mục gstack. Bạn sẽ thấy mỗi bản cài một dòng, gồm agent, mức hỗ trợ, phạm vi, phiên bản và đường dẫn. Nếu agent bạn muốn dùng không có dòng nào, chạy lại lệnh ./setup --host <tên> tương ứng trong cột Repair của README.
README cũng nói /gstack-upgrade làm mới mọi bản cài đã đăng ký và báo máy nào lỗi.
V.Dùng vào việc thật
README gợi ý: dùng thử /office-hours, /review, /qa rồi dừng lại xem có hợp không, chưa cần chạy cả quy trình. Mình làm theo đúng tinh thần đó.
A.Chủ dự án muốn làm app nhưng ý tưởng còn mơ hồ
Bạn là chủ một cửa hàng, muốn có ứng dụng "nhắc lịch hẹn khách", nhưng chưa rõ cần những gì. Mở Claude Code và gõ:
/office-hours
Mình muốn làm app nhắc lịch hẹn cho khách của tiệm. Hiện mình ghi lịch trong nhiều nơi nên hay bị trùng.Claude sẽ hỏi về nỗi đau cụ thể, phản biện cách bạn gọi tên bài toán, đưa ra nhiều hướng làm kèm ước lượng công sức, và ghi tài liệu thiết kế. README có ví dụ: người dùng nói "app tóm tắt lịch mỗi ngày", Claude đáp rằng thứ họ mô tả thật ra là một trợ lý riêng. Kết quả bạn nhận được là một bản thiết kế rõ hơn, đủ để các lệnh sau như /plan-ceo-review đọc tiếp.
Nó không làm theo câu bạn nói, nó nghe nỗi đau của bạn rồi hỏi ngược lại.
Ông T
B.Lập trình viên mới muốn có người soi code trước khi gộp
Bạn vừa nhờ Claude viết một tính năng trên một nhánh. Trước khi gộp, gõ /review ngay trên nhánh đó. Theo README, nó tìm những lỗi qua được CI nhưng hỏng khi chạy thật, tự sửa lỗi hiển nhiên (gắn nhãn AUTO-FIXED) và hỏi bạn với những chỗ cần quyết định (nhãn ASK), ví dụ một lỗi tranh chấp dữ liệu. Nó cũng báo tên từng test bị nới lỏng, timeout bị tăng hay đoạn kiểm tra bị tắt. Kết quả: bạn bớt phải đọc lại từng dòng, và có danh sách rõ việc cần duyệt.
C.Kiểm thử một trang web đang chạy thử
Bạn có một trang staging (bản chạy thử trước khi ra chính thức). Gõ:
/qa https://staging.myapp.comThay địa chỉ bằng địa chỉ của bạn. Theo README, nó mở một trình duyệt thật, bấm qua các luồng, tìm lỗi và sửa. Bạn cũng có thể dùng /qa với một API, CLI, job hay webhook chạy cô lập trên máy. Kết quả là danh sách lỗi đã tái hiện được, cùng bản sửa trong code.
D.Cả nhóm dùng chung một quy trình, kết thúc bằng PR
Khi đã quen, bạn chạy /autoplan để duyệt kế hoạch từ đầu đến cuối, nhờ Claude làm, rồi /review, /qa và /ship. Ở ví dụ trong README, /ship báo số test tăng từ 42 lên 51 và tạo ra một PR. Với nhóm, bật chế độ nhóm ở bước cài đặt để mọi người cùng có đủ bộ lệnh, không lệch phiên bản.
VI.Lỗi hay gặp và cách xử lý
Báo Bun không đủ phiên bản hoặc không có Bun. README nói setup từ chối Bun cũ hơn 1.3.3, và bản đã thử nghiệm là 1.4.2 trở lên. Cài hoặc nâng cấp Bun theo trang chủ của Bun rồi chạy lại ./setup.
Gõ /office-hours mà Claude không biết lệnh. Có thể ./setup chưa chạy xong hoặc chạy sai thư mục. Vào ~/.claude/skills/gstack, chạy lại ./setup, rồi mở phiên Claude Code mới. Nếu cài bằng --host, nhớ rằng với nhiều agent khác bạn phải hỏi theo tên kiểu "gstack-office-hours" chứ không gõ gạch chéo.
/cso không dùng được. README nói /cso cần bộ công cụ biên dịch gốc. Khi thiếu, setup sẽ báo và để lệnh này không khả dụng. Cài bộ công cụ biên dịch cho hệ điều hành của bạn rồi chạy lại setup. Điều kiện chi tiết ở docs/install.md.
Đồng đội không có gstack khi bật chế độ nhóm. Hook required chạy bằng Node.js. Bảo đồng đội cài Node.js và đảm bảo nó nằm trên PATH. Nếu muốn nhẹ tay hơn, dùng optional thay cho required.
Cài ở máy khác agent thì lệnh không chạy. Vì ngoài Claude Code, các agent khác chỉ ở mức experimental hoặc instruction-only. Xem cột Repair trong bảng của README để chạy lại đúng ./setup --host <tên>, và đọc docs/hosts.md cho ghi chú theo từng agent.
VII.Có nên dùng không
Điểm mạnh. gstack miễn phí, giấy phép MIT, chủ yếu là Markdown nên đọc được, sửa được, fork được. Nó cho người mới một cấu trúc rõ ràng thay vì khung chat trống. Các bước nối nhau, tài liệu từ bước trước được bước sau dùng. Dự án vẫn được cập nhật trong vài tháng gần đây, và hỗ trợ nhiều agent ngoài Claude Code.
Giới hạn. Một số tính năng, như bộ lọc an toàn bằng hook, chỉ bị chặn thật sự trên Claude Code; trên agent khác chỉ là lời khuyến cáo. Một số skill cần phần mềm bổ sung: /cso cần bộ công cụ biên dịch, và trải nghiệm trình duyệt tốt nhất trên macOS dùng Aside. README viết khá nhiều theo phong cách riêng của tác giả, nên có người thấy các vai CEO, Designer hơi phô. Bạn cũng nên hiểu AI vẫn có thể sai: các kết quả review và QA là hỗ trợ, không thay cho việc người thật quyết định trước khi phát hành.
Khi nào nên chọn cách khác. Nếu bạn chỉ cần sửa nhanh một đoạn code nhỏ, cả quy trình sprint là thừa, cứ dùng Claude Code bình thường. Nếu bạn không muốn cài Git hay Bun, hoặc máy bị hạn chế quyền cài phần mềm, gstack sẽ khó chịu. Còn nếu bạn tò mò, làm theo gợi ý của README: cài, thử /office-hours, /review, /qa, rồi tự quyết định có đi tiếp hay không.
Câu hỏi thường gặp
gstack có miễn phí không?
Có. README nói rõ đây là bộ công cụ miễn phí, giấy phép MIT, bạn được fork và chỉnh sửa. Tuy vậy bạn vẫn cần Claude Code hoặc một agent lập trình khác, và README phần mình có không nói về chi phí của các dịch vụ đó.
gstack có chạy trên Windows được không?
README nhắc Windows cần cài thêm Node.js, nên có hỗ trợ Windows ở mức nào đó. Nhưng phần README mình có không hướng dẫn chi tiết cách chạy ./setup trên Windows. Bạn xem docs/install.md trong repo trước khi cài.
Cài gstack cần những gì?
Cần Claude Code, Git và Bun từ phiên bản 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ố lệnh như /cso cần thêm bộ công cụ biên dịch gốc của máy.
gstack có cần GPU không?
README phần mình có không nhắc đến yêu cầu GPU. gstack là bộ lệnh Markdown chạy trên các agent lập trình, nên phần xử lý nặng do dịch vụ của agent đảm nhiệm. Nếu cần chắc chắn, hãy xem docs/install.md.
gstack khác gì việc dùng Claude Code trực tiếp?
Claude Code là công cụ nền, còn gstack là bộ lệnh đặt lên trên, gồm các vai như tư vấn sản phẩm, review, QA và phát hành. Theo README, mỗi lệnh đọc kết quả của lệnh trước, giúp bạn đi theo một quy trình thay vì tự gõ yêu cầu từ trang trống.
Có dùng được 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 và Gemini CLI. Các agent này ở mức experimental và các safety skill chỉ mang tính khuyến cáo. Chỉ Claude Code được xếp mức full, với hook chặn thật sự.
Làm sao nhận bản cập nhật mới?
Bản cài mới đi theo kênh stable, tức bản phát hành có gắn thẻ, không phải mọi thay đổi trên main. Bạn đổi kênh bằng lệnh gstack-config set update_channel main hoặc stable. Có thể dùng /gstack-upgrade để làm mới các bản cài đã đăng ký.


