vuthuonghai-steve/task-planner

Task Planner

Tong quan

Skill nay giup phan tach yeu cau hoac tai lieu nghien cuu thanh bo tai lieu task planning co cau truc, bao gom:

• Phase: Cac giai doan lon cua du an/tinh nang
• Task: Cac cong viec cu the trong moi phase
• Subtask: Cac buoc nho trong moi task

Nguyen tac cot loi: Tai lieu output KHONG CHUA CODE MAU. Chi tap trung mo ta logic, nghiep vu, va cac buoc can thuc hien.

---

Workflow

Buoc 1: Thu thap Context

Khi skill duoc goi, thuc hien thu thap thong tin:

1.1 Xac dinh nguon input

| Nguon | Hanh dong | |-------|-----------| | File tai lieu | Doc file bang Read tool, phan tich noi dung | | Yeu cau truc tiep | Ghi nhan yeu cau tu nguoi dung | | URL/link | Su dung WebFetch neu can |

1.2 Hoi thong tin can thiet

Su dung AskUserQuestion de hoi:

1. Thu muc output - Noi luu cac file tai lieu plan
2. Ten du an/tinh nang - De dat ten cho bo tai lieu
3. Pham vi - Xac dinh ranh gioi cua yeu cau

1.3 Nghien cuu codebase

Su dung Task tool voi subagent_type=Explore de:

• Tim hieu cau truc du an hien tai
• Xac dinh cac file/module lien quan
• Hieu cac pattern dang duoc su dung

---

Buoc 2: Phan tich va Phan chia

2.1 Phan tich yeu cau

Doc ky input va xac dinh:

• Muc tieu chinh can dat duoc
• Cac thanh phan/module can xay dung
• Cac phu thuoc va rang buoc

2.2 Chia thanh Phase

Moi phase nen:

• Co muc tieu ro rang
• Co the demo/kiem tra doc lap
• Thoi gian hop ly (khong qua lon/nho)

Quy tac chia phase:

Phase 1: Nen tang (setup, config, schema)
Phase 2: Core logic (business logic chinh)
Phase 3: Integration (ket noi cac phan)
Phase 4: Polish (UI, UX, optimization)
Phase 5: Testing & Documentation

2.3 Chia thanh Task trong moi Phase

Moi task nen:

• Hoan thanh duoc trong 1 session lam viec
• Co input/output ro rang
• Co tieu chi hoan thanh cu the

2.4 Chia thanh Subtask

Moi subtask nen:

• La 1 don vi cong viec nho nhat
• Mo ta duoc logic can thuc hien
• Co the verify ket qua

---

Buoc 3: Hoi Clarification

Truoc khi tao tai lieu final, su dung AskUserQuestion de:

1. Xac nhan pham vi - "Toi da xac dinh {N} phase, {M} task. Day co phu hop khong?"
2. Lam ro mo ho - Hoi ve cac diem chua ro trong yeu cau
3. Xac nhan uu tien - "Phase nao can uu tien truoc?"
4. Kiem tra rang buoc - "Co rang buoc nao ve tech stack/pattern khong?"

---

Buoc 4: Tao Bo Tai lieu

4.1 Doc format guidelines

Tham khao file references/document-format.md de dam bao format dung chuan.

4.2 Tao cau truc thu muc

{output-path}/
├── INDEX.md
├── phase-01-{slug}/
│   ├── PHASE.md
│   ├── task-01-{slug}.md
│   └── task-02-{slug}.md
└── phase-02-{slug}/
    ├── PHASE.md
    └── ...

4.3 Viet noi dung

Thu tu viet:

1. Viet INDEX.md truoc (tong quan)
2. Viet PHASE.md cho tung phase
3. Viet task-{so}-{slug}.md cho tung task

Noi dung moi file:

• INDEX.md: Tong quan, muc tieu, danh sach phase
• PHASE.md: Muc tieu phase, danh sach task, phu thuoc
• task-*.md: Logic xu ly, subtasks, edge cases, DoD

4.4 Tich hop TodoWrite

Sau khi tao tai lieu, su dung TodoWrite de tao todo list tu cac task:

- Phase 1: {ten}
  - Task 1.1: {ten}
  - Task 1.2: {ten}
- Phase 2: {ten}
  - Task 2.1: {ten}
  ...

---

Nguyen tac Viet Tai lieu

KHONG lam

1. KHONG chen code mau - Khong snippet, khong example code
2. KHONG copy syntax - Khong dan syntax tu docs
3. KHONG qua chi tiet implementation - Khong mo ta tung dong code
4. KHONG gia dinh - Hoi neu chua ro

NEN lam

1. Mo ta logic ro rang - "Kiem tra dieu kien A, neu thoa thi thuc hien B"
2. Liet ke edge cases - "Truong hop input rong, xu ly bang cach..."
3. Chi ro phu thuoc - "Can hoan thanh Task 1 truoc khi bat dau"
4. Dinh nghia DoD - "Task hoan thanh khi: checklist..."

---

Vi du Mo ta Logic (KHONG code)

SAI (co code):

// Tao function validate email
function validateEmail(email) {
  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)
}

DUNG (mo ta logic):

## Logic validate email

1. Kiem tra input khong rong
2. Kiem tra format co dang: {text}@{domain}.{extension}
3. Kiem tra domain hop le (khong chua ky tu dac biet)
4. Tra ve true neu hop le, false neu khong

### Edge cases
- Email rong -> tra ve false
- Email khong co @ -> tra ve false
- Email co nhieu @ -> tra ve false

---

Resources

references/

• document-format.md - Huong dan chi tiet ve format cac file tai lieu

assets/templates/

• INDEX.template.md - Template cho file INDEX.md
• PHASE.template.md - Template cho file PHASE.md
• TASK.template.md - Template cho file task

---

Checklist Hoan thanh

Truoc khi ket thuc, dam bao:

• [ ] Da tao INDEX.md voi day du thong tin
• [ ] Da tao PHASE.md cho moi phase
• [ ] Da tao task-*.md cho moi task
• [ ] Tat ca file khong chua code mau
• [ ] Moi task co Definition of Done
• [ ] Da tao TodoWrite list tu cac task
• [ ] Da thong bao nguoi dung ve vi tri thu muc output