Tổ chức dài hạn — Epic tree, template, persona, archive

Đối tượng: Tech Lead / member tổ chức công việc nhiều tháng.

Epic tree

1. Tạo task loại epic cho một mảng lớn (ví dụ "Payment Platform").
2. Tạo story bên dưới, rồi task bên dưới story.
3. Vào Tree View để thấy toàn bộ cây và quan hệ phụ thuộc cắt ngang; đếm tiến độ theo taskCounts từng nhánh.

Auto-retro khi Epic xong

Đủ 3 điều kiện thì hệ thống tự soạn draft Retrospective: <Tên Epic> lên Arkon Wiki (trạng thái chờ duyệt, không publish thẳng):

1. Epic có ≥1 task hậu duệ (mọi tầng dưới nó).
2. Mọi hậu duệ đều ở done (kích hoạt khi 1 task vừa sang done, hệ thống lần ngược lên Epic gần nhất).
3. Epic chưa từng có retro (đã có draft là thôi; request đồng thời cũng chỉ ghi 1 nhờ khóa trong-process).

Draft gồm 4 mục: Deliverables Summary, Execution Metrics (số item, loại, số rework, tổng runtime agent), Key Learnings & Blockers, Next Steps / Tech Debt. Danh tính soạn là @architect (contributor — không tự duyệt); người duyệt là human ở hàng đợi gộp (lọc Knowledge).

Arkon/LLM chết không chặn Epic

Epic vẫn done. Hệ thống chỉ ghi 1 activity epic_retro cảnh báo trên chính Epic (Arkon vắng / LLM lỗi / draft bị từ chối).

Sweep bù chạy định kỳ: mặc định 15 phút (AGENTBOARD_AUTO_RETRO_SWEEP_MS, sàn 30s) quét Epic đã đủ điều kiện mà lỡ retro; dedupe theo outcome — cảnh báo trùng outcome không ghi thêm dòng mới.

Template

Lưu bộ mô tả + acceptance criteria + agent type dùng lại nhiều lần (GET·POST /api/templates). Hữu ích cho việc lặp: "Thêm endpoint CRUD", "Viết migration", "Sửa bug từ Sentry".

Persona (5 vai trò mỗi Space)

Mỗi Space có đúng 5 persona sinh tự động lúc provisioning:

Persona	Thiên về
@architect	Thiết kế
@coder	Viết code (mặc định)
@reviewer	Thẩm định — luôn khác persona viết code, không tự review chính mình
@qa	Test
@devops	Vận hành

Mỗi persona có MCP token riêng bên Arkon nên phân quyền tri thức tách bạch được.

Archive thay Delete

PATCH /api/tasks/:id/archive để dọn Board mà không mất dữ liệu. Bật Show Archived trên Header để xem lại. Xoá task rồi không lấy lại được — dùng Archive khi chỉ muốn dọn.