Progress & Reporting Framework

1. Reporting Objectives

• Nhìn được tiến độ theo Feature/Module/Phase.
• Nhìn được blocker, risk, debt để quyết định nhanh.
• Không lệch giữa trạng thái docs và code thực tế.

2. Status Taxonomy

• NOT_STARTED
• SPEC_READY
• IN_PROGRESS
• BLOCKED
• REVIEW
• DONE
• ROLLED_BACK

3. Reporting Cadence

1. Daily: update WORKITEM_BOARD.md.
2. Weekly: tổng hợp theo module vào section Weekly Snapshot bên dưới.
3. Sprint end: cập nhật FEATURE_STATUS_MATRIX.md toàn cục.

4. Weekly Snapshot Template

YYYY-MM-DD

Completed

• [Feature Key] Title — PR/Commit ref — Owner

In Progress

• [Feature Key] Title — ETA — Owner

Blocked

• [Feature Key] Block reason — Needed decision

Risks

• Risk description — Impact — Mitigation

Next Week Focus

• Priority 1
• Priority 2

5. KPI Dashboard (Manual)

Theo dõi tối thiểu:

1. Done Rate: số feature DONE / sprint target.
2. Lead Time: từ SPEC_READY đến DONE.
3. Reopen Rate: số task mở lại sau review.
4. Docs Drift: số task code xong nhưng docs chưa update.

6. Blocker Escalation Rule

• Blocker > 24h phải được ghi vào snapshot.
• Blocker kiến trúc phải mở Decision entry mới.
• Không cho phép kéo dài BLOCKED qua 2 daily update mà không có action owner.