okr-plan

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