Chuyển sang GSD-2

GSD-2 được thiết kế để tương thích ngược với các dự án Get Shit Done Framework hiện có. Phần lớn quá trình chuyển đổi chỉ đơn giản là thêm các trường cấu hình mới - không cần thay đổi cấu trúc thư mục, không cần viết lại milestone hay slice đã hoàn thành. Phần này hướng dẫn từng bước để chuyển một dự án Get Shit Done Framework sang GSD-2 một cách an toàn.

Cơ sở Dữ liệu

GSD-2 sử dụng cùng file SQLite .gsd/gsd.db như Get Shit Done Framework. Schema được thiết kế tương thích tiến (forward-compatible): gsd-pi tự động áp dụng các migration schema cần thiết khi khởi chạy lần đầu sau khi nâng cấp, không yêu cầu bất kỳ thao tác thủ công nào từ người dùng. Toàn bộ dữ liệu milestone, slice, task, decision, và memory đều được giữ nguyên.

Nếu bạn muốn tạo backup trước khi nâng cấp, chỉ cần sao chép file .gsd/gsd.db sang vị trí an toàn - đây là nguồn dữ liệu duy nhất cần được bảo toàn.

Cấu hình

Mở file .gsd/settings.json hoặc .gsd/PREFERENCES.md trong dự án hiện tại và thêm các trường đặc thù của GSD-2. Hai trường quan trọng nhất là phases (kiểm soát tính năng mới như escalation giữa task và auto-commit) và taskIsolation (bật phân lập worktree nếu cần). Tất cả trường mới đều có giá trị mặc định an toàn, vì vậy bạn chỉ cần thêm những gì bạn muốn kích hoạt.

Nếu dự án của bạn không có file cấu hình, GSD-2 vẫn hoạt động bình thường với toàn bộ giá trị mặc định - việc thêm cấu hình chỉ cần thiết khi bạn muốn bật các tính năng nâng cao.

# Trước (Get Shit Done Framework - settings.json tối thiểu)
{
  "model": "claude-sonnet-4-5",
  "unique_milestone_ids": true
}

# Sau (thêm các trường GSD-2)
{
  "model": "claude-sonnet-4-5",
  "unique_milestone_ids": true,
  "phases": {
    "mid_execution_escalation": true,
    "auto_commit": true
  },
  "taskIsolation": {
    "mode": "worktree"
  }
}

Agent Prompts

Nếu dự án GSD cũ của bạn có agent tùy chỉnh trong .gsd/agents/, hãy cập nhật system prompt của chúng để tham chiếu đến tên công cụ GSD-2. GSD-2 đổi tên một số công cụ để nhất quán hơn - ví dụ, tên canonical hiện là gsd_task_complete thay vì alias cũ. Agent dùng tên cũ vẫn hoạt động thông qua alias, nhưng nên cập nhật để rõ ràng hơn.

<!-- .gsd/agents/my-executor.md - cập nhật cho GSD-2 -->
# My Executor (GSD-2)

Sử dụng các công cụ GSD-2 khi hoàn thành task:
- gsd_task_complete  (thay vì gsd_complete_task cũ)
- gsd_slice_complete (thay vì gsd_complete_slice cũ)
- gsd_save_gate_result để lưu kết quả quality gate

Tên công cụ GSD-2 dùng dấu gạch dưới, không dùng dấu gạch ngang.

Bước Tiếp theo

Trình tự nâng cấp được khuyến nghị là bắt đầu với chế độ Step (thủ công) trước để xác minh rằng mọi thứ hoạt động đúng, sau đó dần dần bật auto-mode theo từng slice. Cách tiếp cận này giảm thiểu rủi ro vì bạn có thể quan sát hành vi của GSD-2 trước khi trao toàn quyền cho agent.

1. Cập nhật gsd-pi lên phiên bản GSD-2 mới nhất.
2. Chạy /gsd status để xác nhận database được migrate thành công.
3. Thêm các trường GSD-2 vào settings.json theo nhu cầu.
4. Thực thi một slice nhỏ ở chế độ Step để kiểm tra luồng hoàn chỉnh.
5. Bật phases.mid_execution_escalation: true và thử auto-mode với một slice.
6. Sau khi tự tin, bật phases.auto_commit: true và cấu hình queue nếu cần.