Tổ chức công việc dài hạn

Khi công việc kéo dài nhiều tháng với Epic, template, persona và archive, trang này hướng dẫn tổ chức cây Epic, tái dùng template và dọn Board mà không mất dữ liệu.

Đối tượng: Tech Lead / member tổ chức công việc nhiều tháng. Điều kiện: bạn là member trở lên của Space; auto-retro là cờ mặc định TẮT (sysadmin bật).

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.

Cây tối đa 3 tầng (epic → story → task): gán cha vượt tầng → 400 lỗi hierarchy. Xem cây qua API: GET /api/tasks?view=tree.

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.

Auto-retro mặc định TẮT

Cờ AGENTBOARD_AUTO_RETRO vắng nghĩa là Epic xong không có gì xảy ra thêm — đúng hành vi cũ. Muốn bật, sysadmin đặt cờ rồi restart server. Tính năng này không bao giờ tự chạy agent hay tự ghi Wiki.

Template

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

curl -X POST http://<host>/api/templates \
  -H 'Content-Type: application/json' \
  -d '{"title": "Thêm endpoint CRUD", "description": "…", "acceptanceCriteria": "…"}'

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. Giá trị persona lạ (kể cả từ Planner) bị chuẩn hoá về coder; xoá gán bằng persona: null. Draft do persona đề xuất luôn ở vai contributor — không tự duyệt được (xem Duyệt Wiki draft).

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 (GET /api/tasks/archived cho danh sách đã lưu). Mở lại bằng PATCH /api/tasks/:id/unarchive. Xoá task rồi không lấy lại được — dùng Archive khi chỉ muốn dọn.

curl -X PATCH http://<host>/api/tasks/<taskId>/archive
curl -X PATCH http://<host>/api/tasks/<taskId>/unarchive

Bạn gọi	Kết quả	Vì sao
Archive task chưa xong	400 {"error": "can only archive completed or failed tasks"}	Chỉ dọn task done hoặc failed
Unarchive task không bị archive	400 {"error": "task is not archived"}	Không có gì để mở lại
Sai id	404 {"error": "task not found"}	Sai id task

Gặp lỗi? Xem Xử lý sự cố.

Đi tiếp: Duyệt và approve · Nạp tài liệu vào Wiki