Spec Workspace
Spec Workspace giúp bạn tổ chức những thay đổi lớn trong dự án theo quy trình rõ ràng — viết proposal, thiết kế, danh sách task, triển khai, rồi lưu trữ — trước khi gộp vào codebase.
Cấu trúc một Change
Mỗi change là một thư mục có proposal, design, tasks, và tuỳ chọn specs cho từng module.
| File | Vai trò |
|---|---|
| proposal.md | Đề xuất: vấn đề, giải pháp, lý do |
| design.md | Thiết kế chi tiết: kiến trúc, API, edge case |
| tasks.md | Danh sách task có checkbox để tick |
| specs/ | (Tuỳ chọn) Spec mới hoặc cập nhật cho từng module |
Spec Viewer & Tasks
Mở tab loại "Spec" từ pane "+". Click vào một change để mở Spec Viewer với các tab: Proposal, Design, Tasks, Specs. Tab Tasks là nơi bạn tick / untick để theo dõi tiến độ. Mọi thay đổi lưu xuống file ngay.
Apply & Verify
Khi sẵn sàng làm, dùng slash command apply (/apply <tên-change> hoặc tương tự). AI đọc tasks.md, làm từng task, tick xong từng cái. Sau đó dùng /verify để một AI khác review xem implementation có khớp với spec không.
Archive
Khi change hoàn thành và verify pass, dùng /archive <tên-change>. Spec ADE đổi tên thư mục thành archive/YYYY-MM-DD-<tên>/. Change rời khỏi Active Changes, vào Archive — nguồn tham khảo lịch sử.