Validation

Validation

Before generating issues, validate:

1. ✅ specs/prd.md exists — Product Requirements Document
2. ✅ specs/story.md exists — Task breakdown with stories

If validation fails:

❌ Missing required files!
   Please create:
   - specs/prd.md (Product Requirements Document)
   - specs/story.md (Task breakdown with format: - [ ] [number]. [title])

   See README.md for setup instructions.

---

Mục đích

Đọc file specs/story.md, tạo ra file story riêng cho từng task trong thư mục specs/issues/. Mỗi story là roadmap chi tiết của 1 task — dev review và đổi status thành approved trước khi implement.

---

Các bước thực hiện

1. Đọc source file

Đọc: specs/story.md

• Parse từng task theo format: - [ ] [number]. [title]
• Xác định number, title, labels cho mỗi task

2. Chuẩn bị thư mục

mkdir -p specs/issues

3. Với mỗi task → tạo file story

Tên file: specs/issues/[number]-[slug-title].md

Ví dụ:

001-project-setup-clone-template.md
002-ui-login-screen.md

Slug rule: lowercase, replace space → -, bỏ ký tự đặc biệt

4. Nội dung mỗi file — theo template.md

5. Sau khi tạo xong tất cả

In ra summary:

✅ Đã tạo [X] issues tại specs/issues/
...

→ Review từng file, đổi status: pending → approved để bắt đầu implement

---

Wireframe mapping

Có 2 file HTML trong specs/designs/:

• primary-screens.html — 5 màn hình chính (Login, Home, Timesheet list, Leave list, OT list, Payroll)
• forms.html — các form tạo mới (Timesheet entry, Leave Request form, OT Request form)

Task keyword	File	Màn hình
login	primary-screens.html	01 — Login
home, avatar, bottom nav	primary-screens.html	02 — Home
timesheet list, calendar	primary-screens.html	03 — Timesheet
timesheet form, nhập giờ	forms.html	03a — Nhập Timesheet
leave list, danh sách nghỉ	primary-screens.html	04 — Xin Nghỉ
leave form, tạo đơn nghỉ	forms.html	04a — Tạo Leave Request
OT list, danh sách OT	primary-screens.html	05 — OT Request
OT form, tạo OT	forms.html	05a — Tạo OT Request
payroll, bảng lương	primary-screens.html	06 — Bảng Lương
setup, navigation, theme	không có wireframe	—

---

Quy tắc quan trọng

• KHÔNG tự implement — chỉ tạo file story
• Status luôn là pending — dev tự đổi thành approved
• Mỗi task = 1 file riêng, không gộp
• Nếu file đã tồn tại → skip, không overwrite