# Plan Manager Workflow
<!-- Trigger: /plan -->

Quản lý kế hoạch dự án Canifa qua thư mục `backend/plan/`.
Mỗi task = 1 file markdown. Di chuyển qua 3 giai đoạn: ideas → doing → done.

---

## Cấu trúc thư mục

```
backend/plan/
├── ideas/     ← Ý tưởng chưa quyết làm
├── doing/     ← Đang làm, có checklist cụ thể
└── done/      ← Xong, tên file có date prefix
```

---

## Các lệnh bro có thể gõ

| Lệnh | Ý nghĩa |
|------|---------|
| `/plan status` | Xem tổng quan tất cả tasks |
| `/plan add idea [tên] [mô tả]` | Thêm ý tưởng mới vào ideas/ |
| `/plan start [tên]` | Chuyển idea → doing, thêm checklist |
| `/plan done [tên]` | Chuyển doing → done, thêm ngày hoàn thành |
| `/plan show [tên]` | Xem chi tiết 1 task |
| `/plan edit [tên]` | Mở file task để chỉnh sửa |

---

## Khi user gõ `/plan status`

1. Dùng `list_dir` để đọc `backend/plan/ideas/`, `backend/plan/doing/`, `backend/plan/done/`
2. Với mỗi file trong `doing/`, đọc metadata (Priority, Started)
3. Hiển thị bảng tổng quan như sau:

```
💡 IDEAS ([N] ý tưởng)
  • tên-task-1 — mô tả ngắn
  • tên-task-2 — mô tả ngắn

🔨 DOING ([N] đang làm)
  • tên-task — [HIGH] — X ngày
  • tên-task — [MED]  — Y ngày

✅ DONE ([N] đã xong)
  • 2026-04-16 — tên-task
  • 2026-04-15 — tên-task
```

---

## Khi user gõ `/plan add idea [tên] [mô tả]`

1. Tạo file `backend/plan/ideas/[tên].md` với nội dung:

```markdown
# 💡 [Tên task]

**Status:** idea  
**Added:** [ngày hôm nay]  
**Priority:** —

## Mô tả
[mô tả]

## Tại sao cần làm?
—

## Notes
—
```

2. Báo confirm: `✅ Đã thêm idea: [tên]`

---

## Khi user gõ `/plan start [tên]`

1. Đọc file từ `ideas/[tên].md`
2. Thêm/cập nhật các fields:
   - `Status: doing`
   - `Started: [ngày hôm nay]`
   - Thêm section `## Checklist` nếu chưa có
3. Move file → `doing/[tên].md`
4. Xóa file cũ trong `ideas/`
5. Báo confirm

---

## Khi user gõ `/plan done [tên]`

1. Đọc file từ `doing/[tên].md`
2. Cập nhật:
   - `Status: done`
   - `Completed: [ngày hôm nay]`
3. Move file → `done/[YYYY-MM-DD]-[tên].md`
4. Xóa file cũ trong `doing/`
5. Báo confirm: `✅ Xong! [tên] → done/`

---

## Template file chuẩn (doing)

```markdown
# 🔨 [Tên task]

**Status:** doing  
**Priority:** high | medium | low  
**Started:** YYYY-MM-DD  
**Owner:** —

## Mục tiêu
[Mô tả ngắn gọn cần đạt được gì]

## Checklist
- [ ] Bước 1
- [ ] Bước 2
- [ ] Test
- [ ] Deploy / review

## Context & Notes
[Link, code path, DB table liên quan...]

## Blockers
—
```

---

## Lưu ý thực thi

- Tất cả files nằm tại: `D:\cnf\chatbot-canifa-feedback\backend\plan\`
- Dùng `write_to_file` để tạo/cập nhật file
- Dùng `list_dir` để đọc danh sách
- Dùng `view_file` để đọc nội dung
- Khi move: tạo file mới + xóa file cũ (dùng PowerShell `Remove-Item`)
- Date format: `YYYY-MM-DD` (VD: `2026-04-16`)
