Hệ thống context engineering cho AI coding assistants

TL;DR

GSD là một hệ thống workflow giúp AI coding assistants (như Claude Code) build software một cách có hệ thống và đáng tin cậy. Nó giải quyết vấn đề “context rot” — chất lượng code giảm dần khi context window đầy lên.

Nói đơn giản: Thay vì nói cho AI “build cái này đi” rồi ngồi chờ mù mịt, GSD cho mình một framework rõ ràng: hỏi → research → plan → execute → verify. Mỗi task chạy trong fresh context, commit riêng, không lẫn lộn.

Bài này dành cho ai?

1. Dev muốn AI làm việc thay mình

Vấn đề: Mô tả ý tưởng cho AI rồi nhận về code lộn xộn, không nhất quán, không scale được Khi nào cần: Khi cần build feature hoặc project từ đầu với AI Được gì: Workflow rõ ràng, AI research trước khi code, verify sau khi xong

2. Dev muốn build sản phẩm với AI

Vấn đề: Không biết cách tổ chức để AI code hiệu quả, code nhanh nhưng debug mệt Khi nào cần: Khi muốn tối ưu hóa việc dùng AI để ship sản phẩm nhanh Được gì: Framework có sẵn, AI tự verify, git history sạch

3. Team lead / Solo founder

Vấn đề: Không muốn chạy theo enterprise workflow (Jira, sprint planning…) nhưng cần structure Khi nào cần: Khi cần một workflow đủ nghiêm túc để AI làm việc đàng hoàng, không phải “vibe coding” bừa bãi Được gì: System có complexity bên trong, đơn giản bên ngoài

Các điểm chính

1. Context window là bottleneck chính Claude Code mạnh, nhưng càng nhiều context thì chất lượng càng giảm. GSD giải quyết bằng cách: mỗi task chạy trong fresh 200k tokens context riêng. Main session chỉ 30-40%. → Làm gì: Dùng GSD workflow thay vì nhồi mọi thứ vào một session

2. Workflow có 5 bước rõ ràng /gsd:new-project → hỏi ý tưởng → research → requirements → roadmap /gsd:discuss-phase → nắm bắt implementation preferences /gsd:plan-phase → research + tạo atomic plans /gsd:execute-phase → chạy song song theo waves, mỗi task commit riêng /gsd:verify-work → manual testing, auto-diagnose nếu lỗi → Làm gì: Tuân theo workflow, đừng bỏ qua bước nào

3. Wave execution — chạy song song những gì có thể Plans được chia thành waves dựa trên dependencies. Trong cùng wave chạy song song, waves chạy tuần tự. Independent tasks → parallel. Dependent → sequential. → Làm gì: Design task theo “vertical slices” (feature end-to-end) thay vì “horizontal layers” (tất cả models rồi tất cả APIs)

4. XML prompt formatting cho từng task Mỗi plan có cấu trúc XML: <name>, <files>, <action>, <verify>, <done>. Không ambiguous, không guessing. → Làm gì: Khi tự viết prompt, dùng cấu trúc này

5. Atomic commits — mỗi task một commit Task hoàn thành → commit ngay. Ai commit bậy thì revert dễ. Git bisect tìm lỗi chính xác. → Làm gì: Không gộp nhiều task vào một commit

6. Model profiles — cân bằng quality vs cost quality: Opus cho planning + execution balanced (default): Opus plan, Sonnet execute budget: Sonnet toàn bộ inherit: Theo runtime hiện tại → Làm gì: Set /gsd:set-profile budget cho project nhỏ, quality cho project quan trọng

7. Quick mode cho task nhỏ /gsd:quick — không cần full workflow. Thêm --discuss để hỏi trước, --research để investigate, --full để verify. → Làm gì: Dùng quick mode cho bug fixes, small features

Quick Start

1. Cài đặt:

npx get-shit-done-cc@latest

Chọn runtime (Claude Code, OpenCode…) và location (global/local)

2. Khởi project:

/gsd:new-project

Trả lời câu hỏi, hệ thống tự tạo PROJECT.md, REQUIREMENTS.md, ROADMAP.md

3. Chạy workflow:

/gsd:discuss-phase 1    # Nói rõ mình muốn gì
/gsd:plan-phase 1       # AI research và tạo plans
/gsd:execute-phase 1    # AI build, tự commit
/gsd:verify-work 1       # Test thử

4. Quick mode cho task nhỏ:

/gsd:quick
> Add dark mode toggle to settings

5. Skip permissions (khuyến nghị):

claude --dangerously-skip-permissions

Để AI tự approve date, git commit mà không hỏi 50 lần