| name | okr-plan |
| description | Tạo/sửa plan, milestones, actions, dependencies, deadline, external_ids. |
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.md tồn tại. Thiếu → cần init trước.
resources.md nê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.md full body để check fit, actions/inbox count, lessons/index.md toàn bộ, + conditional context/index.md khi context/ 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 qua okr-harness.
- Reachability khi ghi (
../okr-shared/references/preload.md): deliverable là file riêng → ghi dòng Path: ở đầu ## Output/Deliverable (xem task-format.md). Tạo file context/ (playbook, bảng tra cho plan) → entry context/index.md (owner = okr-plan) + dòng confirm gate nhánh 2. Action vào actions/ 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 frontmatter
references/action-guide.md: viết action chất lượng, anti-patterns
references/task-format.md: template body action file
- Roadmap format: xem
okr-shared skill schemas.md