GSD: Framework Meta-prompting Giải Quyết Context Rot khi Làm Việc với Claude Code

TL;DR

GSD (Get Shit Done) là framework meta-prompting open-source đặt mình ở giữa developer và AI coding agent, cung cấp structured context để Claude Code - và hơn 12 runtime khác - tạo ra output nhất quán qua các session dài. Vấn đề cốt lõi mà GSD giải quyết là context rot: hiện tượng chất lượng AI output giảm dần khi context window ngày càng đầy. Cài đặt qua npx get-shit-done-cc@latest, workflow chia thành 6 giai đoạn rõ ràng với parallel subagents.

Điểm cần lưu ý: repo gốc đã được archive và community đang duy trì fork tại open-gsd/gsd-core với tên mới "Git, Ship, Done!" - câu chuyện phía sau cũng không kém phần thú vị.

Vấn Đề: Context Rot Là Gì?

Nếu bạn đã dùng Claude Code cho dự án phức tạp, có thể bạn đã từng gặp cảm giác này: buổi sáng AI code rất ngon, nhưng sau vài giờ làm việc liên tục trong cùng một session, output bắt đầu kỳ lạ. Response ngắn hơn. Một số yêu cầu bị bỏ qua. Code inconsistent so với phần trước đó. Bạn phải nhắc lại những điều đã nói từ đầu session.

Đây là context rot - hiện tượng chất lượng output của AI model giảm dần khi context window ngày càng đầy. Cơ chế không phức tạp:

• 0-30% context window: AI đang ở peak performance, xử lý chính xác và đầy đủ
• 50-70%+: AI bắt đầu "cắt góc", bỏ sót instructions, code không nhất quán với yêu cầu
• Gần 100%: chất lượng thực sự đáng lo ngại, responses ngắn và generic

Đây không phải bug của Claude Code - đây là đặc tính của LLM với attention mechanism. Khi context quá dài, model phải phân bổ attention cho quá nhiều thông tin cùng lúc và ưu tiên những gì gần nhất trong conversation. Hầu hết developer xử lý bằng cách... mở session mới và paste lại context thủ công. GSD tự động hóa chính xác điều này.

GSD Hoạt Động Như Thế Nào

GSD đặt một abstraction layer giữa bạn và AI agent. Thay vì để Claude Code xử lý toàn bộ dự án trong một session ngày càng phình to, GSD áp dụng mấy nguyên tắc kỹ thuật cốt lõi:

Parallel subagents với fresh context: Mỗi agent nhận một nhiệm vụ cụ thể với context window riêng, fresh hoàn toàn. Agent nghiên cứu thì chỉ làm nghiên cứu với đúng data cần thiết. Agent code thì chỉ viết code với spec đã được chuẩn bị sẵn. Mỗi subagent có thể nhận tới 200K token context, và vì nó chỉ focus vào một task, context đó được dùng hiệu quả.

Main session nhẹ: Bằng cách delegate sang subagents, context window chính chỉ ở mức 30-40%. Bạn có thể làm việc cả ngày mà không bao giờ hit context rot.

XML-formatted prompts: GSD chuẩn hóa cách đưa context vào AI theo format XML, giúp model comprehend chính xác hơn so với plain text. Cấu trúc rõ ràng hơn = ít ambiguity hơn = output nhất quán hơn.

Wave-based execution: Các task độc lập nhau chạy song song trong cùng một wave. Task có dependency xếp vào wave sau. Cơ chế này tương tự parallel processing trong distributed systems - bạn tối đa throughput mà không vi phạm ordering constraint.

Quality gates tự động: Pre-flight check trước mỗi wave, revision request khi output không đạt, escalation và abort checkpoint ngăn vòng lặp vô hạn. Không cần giám sát thủ công từng bước.

Về mặt kiến trúc, đây là cách tiếp cận đúng đắn: thay vì một monolith session làm tất cả, GSD tạo ra nhiều microservice-style agents, mỗi cái chuyên một việc và không bị ảnh hưởng bởi noise từ phần khác của dự án.

Cài Đặt và 6 Giai Đoạn Workflow

Cài đặt GSD chỉ mất vài giây:

npx get-shit-done-cc@latest

Script sẽ hỏi bạn chọn runtime (Claude Code, OpenCode, Gemini CLI, Codex) và scope (global hoặc project-local). Sau đó verify bằng /gsd:help. GSD hỗ trợ 12 runtimes - tức là bạn không bị lock-in vào Claude Code nếu muốn thử tool khác.

Workflow chia thành 6 giai đoạn:

1. Initialize (/gsd:new-project): Interview requirements, research domain, xác định roadmap. GSD hỏi đúng câu hỏi để tránh scope creep về sau.
2. Discuss (/gsd:discuss-phase N): Ghi lại quyết định implementation trước khi code - đây là bước quan trọng nhất và cũng bị bỏ qua nhiều nhất. Theo GSD docs, skip bước này là nguồn gốc của phần lớn iteration vô nghĩa về sau.
3. Plan (/gsd:plan-phase N): Tạo atomic task specs, mỗi task đủ nhỏ để một subagent xử lý gọn trong một context window mà không bị overload.
4. Execute (/gsd:execute-phase N): Parallel wave execution - nhiều subagents chạy đồng thời, mỗi cái với fresh context. Đây là bước GSD tỏa sáng nhất so với cách làm thông thường.
5. Verify (/gsd:verify-work N): User acceptance testing kết hợp automated debugging. GSD yêu cầu bạn chủ động verify thay vì tin tưởng mù quáng vào output AI.
6. Complete (/gsd:complete-milestone): Archive milestone, tag release, chuẩn bị cho version tiếp theo. Mỗi milestone có state riêng, không bị lẫn lộn với nhau.

Tính Năng Đáng Chú Ý

Ngoài workflow 6 bước, GSD có thêm một số command tiện ích:

• /gsd:quick: Ad-hoc task nhỏ với GSD guarantees - không cần chạy full workflow, hữu ích cho bug fix nhanh hoặc refactor nhỏ.
• /gsd:map-codebase: Phân tích brownfield codebase trước khi bắt đầu feature mới. Đặc biệt hữu ích khi join một project đã có sẵn và cần nắm cấu trúc nhanh.
• /gsd:debug: Systematic debugging với fresh context, tránh bị ảnh hưởng bởi session history dài và các giả định sai từ trước đó.
• /gsd:progress: Track trạng thái project, xem phase nào đang chạy, task nào pending.

Framework còn tích hợp security layer: prompt injection scanning, secret detection, và write-access controls. Khi dùng AI coding agent trên production codebase, đây là tính năng không thể thiếu.

Một điểm khéo là configurable model profiles: bạn có thể dùng model mạnh hơn (và đắt hơn) cho Plan phase, và model nhẹ hơn cho Execute phase. Cân bằng giữa quality và cost tùy theo nhu cầu cụ thể.

Giới Hạn và Khi Nào Không Nên Dùng

GSD không phải tool dành cho mọi trường hợp:

• Chi phí token cao hơn: Do spawn nhiều subagents, chi phí token tổng có thể tăng đáng kể so với dùng Claude Code trực tiếp. Ước tính khoảng $100-200/tháng với regular usage.
• Không phù hợp cho task nhỏ: Bug fix đơn giản, prototyping nhanh, hoặc khi budget token eo hẹp - tốt nhất dùng thẳng Claude Code mà không cần GSD overhead.
• Learning curve từ Discuss phase: Nhiều developer muốn nhảy thẳng vào code, bỏ qua Discuss phase. GSD docs khuyến cáo đây là sai lầm tốn kém nhất - skip discussion đồng nghĩa với phải iterate lại nhiều lần sau khi đã code xong.
• Không tự động giải quyết architectural problem: GSD là framework orchestration, không phải tool thiết kế architecture. Bạn vẫn phải biết mình muốn build gì trước khi GSD có thể giúp build nó hiệu quả hơn.

Câu Chuyện Phía Sau: Từ Viral Đến Controversy

Đây là phần thú vị nhất của GSD - không phải về technical, mà về câu chuyện cộng đồng.

GSD được tạo bởi TÂCHES, một organization trên GitHub. Sau khi ra mắt cuối năm 2025, repo tăng trưởng cực kỳ nhanh với hàng trăm contributors và hàng chục releases được ship liên tục. Cộng đồng xây dựng plugin, documentation, và integration cho nhiều runtime khác nhau.

Rồi mọi thứ thay đổi. Vài tháng sau khi ra mắt, maintainer TÂCHES ngừng hoạt động - không phản hồi issue, không commit mới, tài khoản mạng xã hội liên kết biến mất. Điều khiến cộng đồng thực sự lo ngại là sự xuất hiện của $GSD token - một meme coin được liên kết với project, và sau đó là dấu hiệu của rug-pull: bơm giá rồi exit, để lại người mua tay trắng.

Không ai biết chắc chuyện gì đã xảy ra với TÂCHES - account bị compromise, bị lừa, hay chủ động exit scam? Fork maintainer Trek-e thẳng thắn thừa nhận tình huống: "Absence of news is not evidence either way."

Phản ứng của cộng đồng khá nhanh và có tổ chức: toàn bộ code được fork bit-for-bit, giữ nguyên commit history và attribution của tất cả contributors, sang open-gsd/gsd-core. Project rebrand thành "Git, Ship, Done!" và tiếp tục phát triển dưới license MIT với package mới get-shit-done-redux và @gsd-redux/sdk.

Repo gốc gsd-build/get-shit-done hiện là read-only. Nếu bạn muốn dùng GSD hôm nay, fork community tại open-gsd/gsd-core là lựa chọn phù hợp hơn - active maintenance, không có dependency risk vào một maintainer duy nhất.

Kết

GSD giải quyết một vấn đề thực sự mà developer dùng Claude Code gặp phải - context rot không phải myth, nó xảy ra và ảnh hưởng rõ ràng đến chất lượng output trong long session. Cách tiếp cận của GSD với parallel subagents và fresh context là sound về mặt kỹ thuật và đã được cộng đồng validate qua thực tế.

Nếu bạn đang làm dự án phức tạp, multi-phase với Claude Code và thấy chất lượng output giảm dần qua các session, GSD - bản fork community tại open-gsd/gsd-core - đáng để thử. Bắt đầu từ /gsd:quick cho task nhỏ trước khi commit vào full workflow để cảm nhận cách framework hoạt động.

Drama xung quanh maintainer gốc là bài học về dependency risk trong open source - nhưng cũng là minh chứng rằng một community đủ mạnh có thể giữ project sống sót qua khủng hoảng. via open-gsd/gsd-core