AI Planner — một câu ý tưởng thành cây Epic/Task

Đối tượng: Product Owner / Tech Lead / member khi yêu cầu lớn cần phân rã. Điều kiện: Planner cần AGENTBOARD_LLM_MODE=live + key + model (ở mode replay sẽ lỗi [LLM VCR ERROR] — liên hệ sysadmin).

Luồng 2 chặng (tự động)

1. Vào Planner View → New Plan, nhập ý tưởng (ví dụ "Tích hợp cổng thanh toán VNPay qua QR Code"). Bật research codebase nếu muốn Planner đọc repo trước — chậm hơn nhưng chất lượng cao hơn nhiều.
2. Chặng 1 — nghiên cứu: server tạo một task spike ngầm (internal=true, không hiện trên Board), agent đọc cấu trúc repo và ghi báo cáo vào .board/plan-research.md.
3. Chặng 2 — phân rã: server ghép báo cáo + tài liệu tìm được từ Wiki (semantic search) rồi gọi LLM với Structured Outputs — ra cây kế hoạch Epic → Task kèm dependsOn.

Tinh chỉnh — bước quan trọng nhất

Đừng apply plan chưa đọc

Mở PlanDraftEditor và sửa: tiêu đề, mô tả, acceptance criteria, persona phụ trách (@architect / @coder / @reviewer / @qa / @devops), thêm/xoá task, sửa quan hệ phụ thuộc.

Apply Plan (một transaction duy nhất)

Bấm Apply Plan — toàn bộ diễn ra nguyên tử:

• INSERT tất cả record tasks;
• INSERT quan hệ blocks vào work_item_links;
• Sinh trang tài liệu spec/<epic-key> trên Arkon Wiki.

Lỗi ở bất kỳ bước nào → rollback sạch, Board không có task nửa vời.

Lỗi "cycle detected"?

dependsOn của bạn tạo thành vòng (A→B→A). Sửa trong PlanDraftEditor rồi apply lại.

Planner lỗi [LLM VCR ERROR] Cassette cache miss?

AGENTBOARD_LLM_MODE đang là replay (mặc định). Cần sysadmin đặt live + key + model. Xem Xử lý sự cố.

Checklist tự xác minh

• Board có đủ số thẻ; Tree View thấy đúng cấu trúc cây; tab Wiki có trang spec.
• Task phụ thuộc (ví dụ FE chờ BE) có badge blocked.
• Nạp tài liệu kiến trúc vào Arkon Wiki trước khi plan — Planner tìm semantic search trên đó. Xem Nạp tài liệu vào Wiki.