# Okr Plan

> Tạo/sửa plan, milestones, actions, dependencies, deadline, external_ids.

- Skill: `hoangvantuan/okr-plan` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add hoangvantuan/okr-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangvantuan/okr-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: hoangvantuan (https://skillmd.com/u/hoangvantuan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangvantuan/okr-plan

---


# 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/<slug>.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`