okr-track

name	okr-track
description	Cập nhật progress, review sâu, inbox, closure, external sync.

OKR Track: Track + Review + Inbox Processing

Ghi progress fields, log, archive. KHÔNG sửa cấu trúc. Khi xử lý inbox thought cross-cutting, có thể tạo context/<slug>.md và entry context/index.md với owner = okr-track.

Modes

Mode	Trigger	Flow chi tiết
light	Daily tracking	references/flow-light.md
deep	Review sâu, milestone, at-risk	references/flow-deep.md
inbox-only	Xử lý inbox, skip progress	references/flow-inbox.md
closure	Tổng kết khi hết period	references/flow-closure.md

Shared logic (dashboard, mode detection, rules): references/flow-shared.md

SOT quyền ghi

File	Fields
objective.md	KR.current, KI.current
plan.md	counters, last_track_date, last_review_date
actions/*.md	status, ## Output/Deliverable section
log/*.md	Append entries
inbox/*.md	Status transition (pending → processed/discarded)
context/*.md	Tạo file context từ inbox thought cross-cutting
context/index.md	Thêm/cập nhật entry owner = okr-track
actions/archive/	Move done actions

Subset của bảng canonical ../okr-shared/references/sot-ownership.md. Sửa canonical trước, bảng này theo sau.

KHÔNG được sửa: Objective text, KR target, action title/deadline/deps. Đề xuất → áp dụng qua okr-init/okr-plan (pre-confirmed).

Nguyên tắc

• Dashboard TRƯỚC khi hỏi update.
• Confirm trước ghi. Light ≤2 field → 1 dòng, ≥3 → bảng.
• Preload Contract Tier 1 (../okr-shared/references/preload.md): trước khi thao tác, đảm bảo nền Tier 1 đã nạp (objective/plan frontmatter, resources.md full body, 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 khi đề xuất điều chỉnh (deep). 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): ghi đè ## Output/Deliverable PHẢI giữ/cập nhật dòng Path: (không làm đứt link). Nâng inbox item thought (tri thức cross-cutting) thành file context/ + entry context/index.md (owner = okr-track) kèm dòng confirm gate. Áp dụng "Áp dụng context" khi xử lý action.
• Deep: trình bày + tinh chỉnh root cause (analyze deep tính ≥3 lần "tại sao?"). Đề xuất, không tự sửa cấu trúc.
• Append-only log. Không ghi đè.
• External sync: pull trước, confirm, push sau. Fail → skip, không block.
• Cuối flow đề xuất next action (xem okr-shared action-priority).

Schema

• references/data-format.md: schema log, progress fields, inbox processing rules
• Metrics (KR%, KI status, trend, period overdue, action health): ../okr-shared/references/metrics.md (canonical, dùng chung với okr-analyze)