gstack: Bộ Workflow Skills Biến Claude Code Thành Một Virtual Software Team

TL;DR

gstack là open-source skill pack cho Claude Code, tạo bởi Garry Tan (CEO Y Combinator) — đã đạt 16,000+ GitHub stars chỉ trong vài tuần. Thay vì để Claude Code "làm tất" theo kiểu generic, gstack chia thành 9 specialist roles với slash commands rõ ràng: từ product review, architecture, code review đến QA tự động và shipping.

Một trong những lỗi phổ biến nhất khi dùng AI coding agents: bạn yêu cầu Claude Code làm tất cả — plan, code, review, test — trong cùng một context, cùng một session. Kết quả thường là output "vừa đủ" nhưng thiếu depth ở mỗi giai đoạn.

gstack giải quyết điều này không phải bằng một model mới, mà bằng nguyên tắc chuyên môn hoá: mỗi giai đoạn phát triển có một skill riêng, với cognitive mode riêng.

Garry Tan mô tả nó đơn giản: "AI should have explicit roles, not handle everything in a mushy mode."

gstack Là Gì?

Theo gstacks.org:

"gstack is an opinionated skill pack for Claude Code that transforms a single AI assistant into a virtual software development team."

gstack không phải là framework mới hay model mới. Nó là một tập hợp 9 workflow skills được cài vào Claude Code, kích hoạt bằng slash commands. Mỗi skill đại diện cho một "nhân viên" trong software team với vai trò rõ ràng.

gstack 9 specialist roles trong Claude Code — từ product vision đến deployed code

9 Skills Của gstack Giải Thích

/plan-ceo-review — Product Vision

Nhìn vào feature request từ góc độ user. Tìm "10-star product" ẩn trong request thay vì implement theo nghĩa đen. Đặt câu hỏi: Product này thực sự dành cho ai? Cần giải quyết pain point thật sự nào?

/plan-eng-review — Architecture Design

Lock in architecture, data flow, state transitions, edge cases, failure modes và test coverage. Tạo diagrams — sequence, state, component, data-flow — vì diagrams buộc hidden assumptions phải lộ ra.

/review — Production-grade Code Review

Tìm bugs pass CI nhưng blow up trong production: N+1 queries, race conditions, trust boundary violations, missing indexes, broken retry logic, stale reads. Tích hợp Greptile để triage code review comments tự động.

/ship — One-Command Shipping

Sync main, run tests, resolve Greptile issues, push branch, open PR. Xử lý toàn bộ release hygiene — không phải để quyết định build gì, mà để deploy branch đã sẵn sàng mà không mất momentum.

/browse — Stateful Browser

Cung cấp "mắt" cho agent. Log in, click qua app, chụp screenshots, đọc console errors. Chạy trên persistent Chromium daemon — không phải browser headless mới mỗi lần. Cookies, tabs, localStorage tồn tại giữa các calls.

/qa — Automated QA với Find-Fix-Verify

QA testing có cơ chế: phân tích git diff → identify affected pages → test → fix bugs với atomic commits → re-verify. Bốn modes: diff-aware (mặc định), full exploration, quick smoke test, regression baseline. Output: health score 0-100.

/qa-report — Report-only QA

Giống /qa nhưng không touch code. Chỉ tạo bug report để handoff cho team mà không có agent tự sửa.

/setup-browser-cookies — Authenticated Testing

Import cookies từ real browser (Chrome, Arc, Brave, Edge, Comet) vào headless session. Test authenticated pages mà không cần login lại thủ công. Cookie values không bao giờ được hiển thị.

/retro — Engineering Retrospective

Phân tích commit history, coding sessions, shipping velocity, test ratios, PR sizes. Tạo per-contributor insights — praise và growth opportunities. Lưu JSON snapshots để tracking trends qua các tuần.

Technical Architecture: Persistent Chromium Daemon

Điểm kỹ thuật quan trọng nhất của gstack là /browse và /qa không dùng Selenium hay browser headless thông thường.

Chúng chạy trên một compiled binary (Bun) kết nối với persistent Chromium daemon:

• Sub-second command latency (vì browser không cần khởi động lại)
• State retention giữa các calls — cookies, tabs, localStorage tồn tại
• Ref-based interaction — agent reference UI elements bằng stable refs thay vì CSS selectors dễ vỡ
• Security: cookie values không expose, chỉ domain metadata được dùng

Workflow Thực Tế: Từ Idea Đến Ship

Đây là một feature development cycle hoàn chỉnh với gstack:

1. /plan-ceo-review
   → Pressure-test ý tưởng từ góc độ product
   → "Tại sao user cần feature này?"

2. /plan-eng-review
   → Architecture + test strategy
   → Sequence diagrams, edge cases

3. Implement
   → Viết code theo plan đã được approve

4. /review
   → Tìm production bugs trước khi merge
   → Greptile triage

5. /browse + /setup-browser-cookies
   → Login với real cookies
   → Verify UI flows visually

6. /qa
   → Diff-aware testing trên affected pages
   → Fix + verify trong một vòng

7. /ship
   → Sync, test, push, PR
   → Done

Garry Tan báo cáo metrics với gstack trong 50 ngày: trung bình 10,000 lines of code và 100 pull requests mỗi tuần.

Cài Đặt 2 Bước

Bước 1: Install vào machine

Mở Claude Code và paste lệnh install (xem full install guide). Claude sẽ handle phần còn lại — skills cài vào ~/.claude/skills/gstack/.

Bước 2 (Optional): Add vào repo

Chia sẻ gstack với team. Files thật sự được commit vào .claude/ trong repo — teammates chỉ cần chạy setup một lần.

Prerequisites:

• Claude Code subscription (required — skills chạy trong Claude Code sessions)
• Bun v1.0+ (cho persistent browser binary)
• Git

Update: Skills tự update — không cần reinstall thủ công.

Conductor: 10 Sessions Song Song

gstack tích hợp với Conductor — chạy 10 Claude Code sessions song song với Git worktrees. Mỗi session có thể dùng một skill khác nhau, cho phép bạn chạy /qa trên một branch trong khi /plan-eng-review đang train trên branch khác.

gstack Tốt Cho Ai?

Phù hợp:

• Teams đã dùng Claude Code muốn workflow có structure hơn
• Solo developers muốn coverage đầy đủ cho từng giai đoạn
• Engineering leads muốn AI review nhất quán

Ít phù hợp:

• Teams muốn custom framework hoàn toàn
• Projects không dùng Claude Code

Nhìn Rộng Hơn

gstack và Superpowers (ra mắt cùng tuần) đánh dấu một trend rõ: AI coding tools đang được chuyên môn hoá. Thay vì một agent làm tất, pattern mới là một đội agents với vai trò rõ ràng, phối hợp theo workflow có cấu trúc.

FAQ

gstack có miễn phí không? Có — MIT license, open source. Chỉ cần Claude Code subscription để chạy.

Persistent browser có hoạt động với Safari không? Cookie import hỗ trợ Chrome, Arc, Brave, Edge, Comet. Safari chưa được list là supported.

gstack khác GitHub Copilot thế nào? GitHub Copilot là IDE autocomplete + chat. gstack là workflow layer — không phải model hay IDE plugin, mà là set of specialist roles cho toàn bộ SDLC.

Health score trong /qa được tính thế nào? gstack tạo health score 0-100 dựa trên số pages tested, bugs found, bugs fixed, và test coverage của diff. Chi tiết thuật toán tại gstacks.org.