Lập kế hoạch & Hướng dẫn Backlog

Cách sử dụng /plan và /backlog cùng nhau để quản lý dự án hiệu quả.

Tổng quan

PARA Workspace cung cấp hai công cụ bổ trợ nhau để quản lý dự án:

Bạn không phải lúc nào cũng cần cả hai. Hãy sử dụng hướng dẫn này để quyết định.

Khi nào sử dụng cái gì

Quy tắc chung: Mọi dự án đều cần một backlog. Chỉ tạo một kế hoạch (plan) khi bạn cần các quyết định kiến trúc theo từng giai đoạn (phase).

Vòng đời Dự án

/new-project
     ↓
/plan create        (nếu cần — kiến trúc, phases, schemas)
     ↓
/backlog add        (tạo danh sách công việc từ các giai đoạn trong plan)
     ↓
┌──────────── Vòng lặp Hàng ngày ────────────┐
│                                             │
│  /open   → Tải ngữ cảnh + phase hiện tại    │
│     ↓                                       │
│  Lấy task → Code → Test → Commit            │
│     ↓                                       │
│  /backlog update → cập nhật trạng thái      │
│     ↓                                       │
│  /end    → lưu lại phiên làm việc + kt phase│
│                                             │
└─────────────────────────────────────────────┘
     ↓
/retro → /archive   (khi hoàn tất mọi phase)

Plan và Backlog kết nối với nhau ra sao

Kế hoạch (plan) định nghĩa các giai đoạn (phases) (sắp xếp theo sự phụ thuộc). Backlog theo dõi các hạng mục (items) (sắp xếp theo mức độ ưu tiên). Chúng kết nối với nhau thông qua bảng ánh xạ (mapping table):

Plan                              Backlog
┌──────────────────┐              ┌──────────────────┐
│ Giai đoạn 0: Setup│ ←──ánh xạ──→ │ CI-01, CI-02     │
│ Giai đoạn 1: API  │ ←──ánh xạ──→ │ CI-03, CI-04     │
│ Giai đoạn 2: Auth │ ←──ánh xạ──→ │ AU-01, AU-02     │
│ Giai đoạn 3: UI   │ ←──ánh xạ──→ │ UI-01, UI-02     │
└──────────────────┘              └──────────────────┘

Plan cho bạn biết THỨ TỰ → "Làm Giai đoạn 1 trước Giai đoạn 2"
Backlog cho bạn biết TRẠNG THÁI → "CI-03 ✅ Xong, CI-04 🔨 Đang làm"

Trường active_plan

Khi có một kế hoạch, hãy đăng ký nó trong frontmatter của project.md:

---
goal: "Mục tiêu dự án của tôi"
status: "active"
active_plan: "plans/implementation-plan.md" # ← đường dẫn tương đối từ artifacts/
---

Điều này giúp /open và /end tự động phát hiện giai đoạn hiện tại của bạn mà không cần quét toàn bộ các thư mục — giúp tiết kiệm token cho AI Agent.

Dọn dẹp: Khi plan đang hoạt động đạt 100% hoàn thành, bạn có thể chạy /end [project] done để tự động xóa field này và lưu trữ plan.

Lưu trữ Plan (v1.5.3)

Khi tất cả giai đoạn đạt 100%, /plan review tự động:

1. Chuyển plan vào artifacts/plans/done/[tên-plan].md
2. Tạo báo cáo hoàn thành tại artifacts/plans/done/[tên-plan]-review.md
3. Xóa active_plan khỏi project.md
4. Đề xuất chạy /retro để đánh giá lại dự án

Luồng làm việc Phiên Hàng ngày

Bước 1: Mở dự án (/open)

🚀 Bắt đầu: my-project | 📅 2026-02-26
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 PHIÊN TRƯỚC: Hoàn thành cấu hình API proxy
📐 GIAI ĐOẠN HIỆN TẠI: Giai đoạn 2: Xác thực     ← từ plan
   Tiến độ: 2/5 task hoàn tất
   Tiếp theo: AU-03 (Phân quyền Role), AU-04 (Đổi mật khẩu)
📥 BACKLOG: Cao: 3 | Trung bình: 4 | Thấp: 2
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 GỢI Ý: Làm AU-03 (giai đoạn hiện tại, ưu tiên cao)

Agent sẽ đọc plan của bạn (chỉ đọc các tiêu đề — không đọc toàn bộ) để hiển thị giai đoạn bạn đang thực hiện và nhiệm vụ tiếp theo là gì.

Bước 2: Làm việc

Chọn 2-3 nhiệm vụ từ giai đoạn hiện tại. Code, test, commit.

Bước 3: Cập nhật (/backlog update)

/backlog domain-pictures update
→ AU-03: ⏳ Đang chờ → ✅ Hoàn thành (2026-02-26)
→ AU-04: ⏳ Đang chờ → 🔨 Đang làm

Bước 4: Kết thúc phiên (/end)

/end domain-pictures
→ Đã lưu lại vào sessions/2026-02-26.md
→ Tiến độ Plan: Giai đoạn 2 — Hoàn tất 4/5 task
→ 🎉 Gần xong rồi! Còn 1 task ở Giai đoạn 2.

Khi tất cả nhiệm vụ trong một giai đoạn hoàn tất, agent sẽ thông báo:

🎉 Giai đoạn 2 Hoàn thành! Giai đoạn 3: Dashboard UI sẵn sàng bắt đầu.

6 Quy tắc Vàng (Golden Rules)

Đồng bộ Plan & Backlog

Sử dụng lệnh /backlog sync để giữ cả hai tài liệu thẳng hàng:

/backlog my-project sync

🔄 ĐỒNG BỘ BACKLOG ↔ PLAN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Giai đoạn | Đã ánh xạ | Thiếu |
| --------- | -------- | ------ |
| Giai đoạn 0 | 5/5    | 0       |
| Giai đoạn 1 | 4/6    | 2 ⚠️    |
| Giai đoạn 2 | 0/5    | 5 ⚠️    |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ Có 7 task ở plan chưa đưa vào backlog.
→ Tự động tạo mục trong backlog? (y/n)

Khi nào cần đồng bộ

Bảng tra cứu Lệnh Workflow

→ Lớp tiếp theo: Nhà Quản Trị (Governance)