OKR Plan: Tạo + cập nhật plan & actions
SOT chính: plan.md và actions/. Ngoài ra, okr-plan có thể tạo/sửa context/<slug>.md và entry context/index.md khi plan sinh nội dung cross-cutting, owner của entry đó là okr-plan.
Modes
| Mode | Trigger | Flow chi tiết |
|---|---|---|
new |
Chưa có plan.md | references/flow-new.md |
update |
Sửa plan/action/milestone | references/flow-update.md |
pre-confirmed |
Áp dụng thay đổi cấu trúc từ okr-track deep | references/flow-update.md + okr-shared delegate-protocol |
SOT quyền ghi
| File | Fields |
|---|---|
| plan.md | Milestones, counters (khi tạo plan) |
| actions/*.md | title, deadline, deps, effort, priority, DoD, quality criteria, notes, external_ids |
| context/index.md | Chỉ entry do okr-plan làm owner, khi plan sinh nội dung cross-cutting |
| context/.md | Chỉ file context do okr-plan tạo cho playbook, bảng tra, hoặc dữ liệu phụ trợ |
Subset của bảng canonical
../okr-shared/references/sot-ownership.md. Sửa canonical trước, bảng này theo sau.
Điều kiện tiên quyết
objective.mdtồn tại. Thiếu → cần init trước.resources.mdnên tồn tại. Thiếu → cảnh báo cross-check fit.
Nguyên tắc
- Mỗi action BẮT BUỘC: DoD rõ ràng, Output/Deliverable, tiêu chí chất lượng.
- Action mơ hồ ("Nghiên cứu thêm" không output) → CẤM.
- Effort xl → BẮT BUỘC Checkpoints hoặc tách.
- Confirm bảng trước ghi. Render Roadmap sau ghi.
- Preload Contract Tier 1 (
../okr-shared/references/preload.md): trước khi đề xuất/ghi, đảm bảo nền Tier 1 đã nạp (objective/plan frontmatter,resources.mdfull body để check fit, actions/inbox count,lessons/index.mdtoàn bộ, + conditionalcontext/index.mdkhicontext/tồn tại) + áp dụng lesson liên quan. Idempotent: qua harness đã có, chạy lẻ tự nạp phần thiếu. Quan trọng khi chạy lẻ, không quaokr-harness. - Reachability khi ghi (
../okr-shared/references/preload.md): deliverable là file riêng → ghi dòngPath:ở đầu## Output/Deliverable(xemtask-format.md). Tạo filecontext/(playbook, bảng tra cho plan) → entrycontext/index.md(owner = okr-plan) + dòng confirm gate nhánh 2. Action vàoactions/là nhánh 1 (KHÔNG cần dòng confirm riêng, Roadmap link đã neo).
Schema
references/data-format.md: schema plan.md + action frontmatterreferences/action-guide.md: viết action chất lượng, anti-patternsreferences/task-format.md: template body action file- Roadmap format: xem
okr-sharedskillschemas.md