Workflow /docs dùng phương pháp Internal-first: soạn thảo tài liệu trong thư mục gốc dự án trước, sau đó chuẩn bị để sao chép vào repo index.
Tổng quan Lệnh
| Hành động | Ví dụ CLI | Mô tả |
|---|---|---|
new | /docs new para-workspace | Phân tích mục tiêu dự án, soạn docs phù hợp |
review | /docs review para-workspace | Phát hiện docs thiếu hoặc lỗi thời |
update | /docs update para-workspace | Cập nhật tăng dần docs hiện tại |
publish | /docs publish para-workspace | Chuyển docs nội bộ sang định dạng repo |
Phát hiện Strategy Document (v1.6.1)
Step 3.5 kiểm tra docs/strategy/ tồn tại:
- Tồn tại → Liệt kê strategy docs trong Doc Index. Nếu lỗi thời (cũ hơn brainstorm hoặc plan gần đây), đề xuất cập nhật.
- Chưa có → Hỏi user: “Tạo tài liệu chiến lược? Đây sẽ kích hoạt mô hình lập kế hoạch 3 tầng.”
- Cập nhật Cấu hình (v1.6.3): Khi tài liệu chiến lược được tạo mới, tự động ghi nhận đường dẫn vào field
strategytrongproject.mdnhằm thiết lập liên kết Strategy → Plan.
Ecosystem project (v1.6.0+): Cho type: ecosystem, workflow ưu tiên tạo strategy docs vì ecosystem projects tập trung vào điều phối.
Template Strategy Document (v1.6.1)
# [Tên Dự Án] — Chiến lược
> [Tầm nhìn 1 dòng]
## Mục tiêu (Cái gì)
## Cách tiếp cận (Làm sao)
## Ràng buộc
## Tiêu chí Thành côngSmart Routing từ /brainstorm (v1.6.1)
Khi /brainstorm user chọn Option D (“Lưu làm project doc”), tự động chuyển sang /docs new. Nếu kết luận brainstorm mang tính chiến lược, tự động đề xuất lưu vào docs/strategy/.
Cập nhật v1.6.3. Tự động cập nhật field strategy vào project.md khi khởi tạo mới.
→ Tìm hiểu: Strategy → Plan Flow → Workflow /plan — Tạo plan triển khai → Tìm hiểu: Kiến trúc Ecosystem