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)
1---2name: okr-track3description: Cập nhật progress, review sâu, inbox, closure, external sync.4---56# OKR Track: Track + Review + Inbox Processing78Ghi 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`.910## Modes1112| Mode | Trigger | Flow chi tiết |13| ------------ | ------------------------------ | ---------------------------- |14| `light` | Daily tracking | `references/flow-light.md` |15| `deep` | Review sâu, milestone, at-risk | `references/flow-deep.md` |16| `inbox-only` | Xử lý inbox, skip progress | `references/flow-inbox.md` |17| `closure` | Tổng kết khi hết period | `references/flow-closure.md` |181920Shared logic (dashboard, mode detection, rules): `references/flow-shared.md`2122## SOT quyền ghi2324| File | Fields |25| ---------------- | ------------------------------------------------- |26| objective.md | KR.current, KI.current |27| plan.md | counters, last_track_date, last_review_date |28| actions/*.md | status, `## Output/Deliverable` section |29| log/*.md | Append entries |30| inbox/*.md | Status transition (pending → processed/discarded) |31| context/*.md | Tạo file context từ inbox `thought` cross-cutting |32| context/index.md | Thêm/cập nhật entry owner = okr-track |33| actions/archive/ | Move done actions |3435> Subset của bảng canonical `../okr-shared/references/sot-ownership.md`. Sửa canonical trước, bảng này theo sau.3637**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).3839## Nguyên tắc4041- Dashboard TRƯỚC khi hỏi update.42- Confirm trước ghi. Light ≤2 field → 1 dòng, ≥3 → bảng.43- 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`.44- **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.45- 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.46- Append-only log. Không ghi đè.47- External sync: pull trước, confirm, push sau. Fail → skip, không block.48- Cuối flow đề xuất next action (xem `okr-shared` action-priority).4950## Schema5152- `references/data-format.md`: schema log, progress fields, inbox processing rules53- Metrics (KR%, KI status, trend, period overdue, action health): `../okr-shared/references/metrics.md` (canonical, dùng chung với okr-analyze)
hoangvantuan