[CLAUDE] Docs: adopt User-Mark (H-12/13 canonical §P) + Harness-14 + RC-signature (S79)

Áp canonical §P đầy-đủ (P1-P10) khi anh gõ /user-mark-active-high "áp đầy-đủ chính-xác nhất theo AI_INFRA". 0 production code. - 4 lệnh /user-mark-{active-high,active,medium,disable} (DACI report-before-stamp) - ledger .claude/governance/ACTIVE-MARKS.md (4 cấp Active-High/Active/Medium/Disable + display-filter) + 3 mark Active-High stamped anh-confirm (RC-pqhuy1987-20-06-2026-10-29-09/10/11 = objective-criteria/User-Mark/time-age) - harness-11-engine.md §E (P1-P10) + §F (Harness-14 3-mức maturity honest) - rules.md §6.6 objective-criteria (KHÔNG quy-mô-đội / KHÔNG thời-gian-tuổi) - session-start §2.1.4 + session-end §L.b(h) mark-display - 4 Workflow: invest wf_82337f7f-95c + review wf_a7cbe93e-912 + align-re-review wf_9d3beebb-a95 (§P 10/10) + H14-review wf_4d4eba6f-8a0 (§F 6/6) - completeness-gate H-6→H-13 ĐẠT (H-8 11/11 inherit no-[1m]) - 3 adap-report + email ai_infra (7b8615b3) + check-email STAGE 2 State THẬT GIỮ NGUYÊN: Mig 57 · 88 bảng · 354 test · gotcha 71 · bundle CsJetgZH/BVS0ApIm. Restart CLI để activate 4 lệnh + session-cmd (no hot-reload). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-20 10:53:23 +07:00
parent f0e616fd5a
commit 33d519eda0
21 changed files with 519 additions and 6 deletions
--- a/.claude/commands/session-end.md
+++ b/.claude/commands/session-end.md
@ -42,7 +42,7 @@ Em main PHẢI echo **TOÀN BỘ nội dung command body này** (đầy đủ Ph

 **§L.a — Deterministic detect (scan action-signature, KHÔNG để AI tự-phán):** quét session theo bảng **AS-1..AS-9** trong error-ledger. Mỗi hit → 1 RCA entry blameless (5-why + fix + guard). **Bug-production = lỗi KÉP → 2 fix** (vá code **VÀ** vá guard/eval-case). List AS mở — gặp class mới thì thêm.

-**§L.b — 7-step auto-maintain (đủ 7, KHÔNG skip — thiếu = ledger thối). (d)(f) = H2 harvest-curator · (g) = H1 tooling-auditor (2026-06-07 Harness 1):**
+**§L.b — 8-step auto-maintain (đủ 8, KHÔNG skip — thiếu = ledger thối). (d)(f) = H2 harvest-curator · (g) = H1 tooling-auditor (2026-06-07 Harness 1) · (h) = User-Mark H-12/13 (S79):**
 - **(a) summary-index** += 1 dòng/session vào `STATUS.md` Recently Done (pointer, KHÔNG full-log).
 - **(b) Active-Guards** (error-ledger): promote guard **2-strike** (episodic→procedural) · mark `verified` nếu held qua session · retire theo **net-effect** (hại>lợi → gỡ).
 - **(c) chore-flag:** agent L1 >~30KB → archive L2 · error-ledger open-entry quá ngưỡng · **0-byte memory check (AS-8)** · **🌙 sleep-check (Harness-10b, S72):** `last_sleep_at` null hoặc ≥7d (`memory-budget.json`) → INFORM gợi-ý `/sleep-recovery-memory-l2` (KHÔNG auto-run) · **🗜️ Harness-11 A/D2 (S75):** chạy `powershell.exe -ExecutionPolicy Bypass -File scripts/memory-archive-gate.ps1` (DRY-RUN) → đề-xuất dồn-archive sub over-cap (A4 hysteresis 0.85 + A5 keep-floor 5 + A6 2-strike) + A7 NO-API L1-eval (pointer-resolve + byte-0-loss). Engine → [`docs/governance/harness-11-engine.md`](../../docs/governance/harness-11-engine.md). DRY-RUN báo kế-hoạch; MOVE thật do em-main (D5 AUTO semantic-null sau khi xem).
@ -50,6 +50,7 @@ Em main PHẢI echo **TOÀN BỘ nội dung command body này** (đầy đủ Ph
 - **(e) pending-request audit:** request anh CHƯA-thực-thi đã log SPECIFICS chưa (KHÔNG placeholder).
 - **(f) 🌾 harvest-integrity GATE (⬜ harvest-curator H2 — 5-trục, Harness 1+2):** verify spawn-record (d) đủ+đúng mọi sub TRƯỚC khi đóng — **Coverage** (0 silent-miss) · **Completeness** (đủ 4-field) · **Placement** (delta đúng `agent-memory/X`) · **Corruption** (moved-not-cut, no-mojibake/shell-baked) · **Fidelity-FLAG** (nghi bịa/on-behalf → escalate 🟥 reviewer, KHÔNG tự phán). + **🌊 close-gate C5 Layer3 (Harness-10, thay B5 wave-gom):** với MỌI `runs/<run-id>/` của session → **VERIFY per-turn harvest đã xong** (em-main đã viết `runs/<run-id>/<stage>-synthesis.md` phẳng h10-refine — run cũ S71: `harvest/*.md` — NGAY sau mỗi fan-out turn = C4 Layer1) + `_ledger.md` mọi run đã CLOSE-beat (closed≠⏳). 🔴 **IDEMPOTENT — close-gate chỉ VERIFY, KHÔNG re-APPEND** (per-turn đã APPEND rồi → re-APPEND = DUPLICATE-HARVEST). 5-trục GATE giữ làm **backstop**. GATE = run còn `*-synthesis.md` vắng (run cũ S71: `harvest/` rỗng — C8 dual-accept) HOẶC chưa đủ 5-trục thì CHƯA đóng.
 - **(g) 🔌 tooling-freshness CHỐT (🟫 tooling-auditor H1 — Harness 1):** spawn → chốt 4-mặt (skill·sub-role·plugin·docs) đổi gì session này + **new-alloc audit** (skill/plugin MỚI chưa phân-bổ → đề-xuất gán em main + sub phù-hợp vai) + flag doc-drift/roster-lệch/count-stale. Propose → em main APPEND/sửa doc (single-writer). 🔴 G-015: 2 monitor = propose-only, em main VERIFY trước APPEND (Bash residual → KHÔNG "read-only enforced").
+- **(h) 🔏 User-Mark CHỐT cuối phiên (H-12/13 canonical §P/P7, S79 — `harness-11-engine.md §E`):** đọc [`.claude/governance/ACTIVE-MARKS.md`](../governance/ACTIVE-MARKS.md) → (i) **hiển-thị** status-filtered (Active-High/Active hiện · Medium tóm-tắt · Disable ẩn) cho anh đọc lại (đối-xứng `session-start §2.1.4`); (ii) nếu session này có **quyết-định cấp-governance MỚI** (scope-check P6: đổi CANONICAL §-rule/authority) → chạy `/user-mark-<cấp>` DACI: adjust-gov → double-check → **report-trước-đóng-dấu 3-7 tiêu-chí khách-quan (P4)** → anh confirm → stamp `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss`; (iii) supersede/disable mark cũ (P5) → con-trỏ-xuôi + Active-High cần anh-confirm RIÊNG. 🔴 **KHÔNG tự đóng dấu / đổi cấp trước khi báo (P4/P8).** 0 quyết-định-mới → "n-a, chỉ hiển-thị".

 ## Phase 2 — WRITE (update MD/RAG)

--- a/.claude/commands/session-start.md
+++ b/.claude/commands/session-start.md
@ -87,6 +87,14 @@ Em main xác nhận **lead model resolve được** đầu session. Lead SE = **
 - Chạy `powershell.exe -ExecutionPolicy Bypass -File scripts/governance-detectors.ps1` → báo cờ: **C1** con-trỏ-gãy (gotcha#/wikilink) · **C2/B3** derived-doc stale vs `docs/STATUS.md` canonical (mig#/test#/gotcha#/table#) · **C3** vocab-fork (1-khái-niệm-nhiều-tên). NO-API, **DÒ+NÊU-CỜ-only KHÔNG tự sửa** (D6 tầng). Cờ → em-main soạn bản sửa (gated B4).
 - Nấc: detector = LƯỚI giảm-sót (khoảng-mù giữa 2 nhịp), count-token soft-net có false-pos (sev LOW khi |lệch|<10) → đọc cờ bằng phán-đoán, KHÔNG auto-fix. **Light/hỏi-đáp session → có thể skip; governance/doc-heavy session → nên chạy.**

+### 2.1.4 User-Mark display — hiển-thị sổ-cái mark ĐẦU phiên (H-12/13 canonical §P/P7, S79)
+
+> Floor User-Mark (🔴 P7 `harness-11-engine.md §E.4`): danh-sách quyết-định-mark hiển-thị đầu + cuối mỗi phiên cho anh đọc lại. Canonical sổ-cái → [`.claude/governance/ACTIVE-MARKS.md`](../governance/ACTIVE-MARKS.md). INFORM-only.
+
+- Đọc `.claude/governance/ACTIVE-MARKS.md` → **báo status-filtered (P7):** 🔴 **Active-High** + 🟢 **Active** HIỆN rõ (ID + what gọn) · 🟡 **Medium** tóm-tắt (1 dòng đếm) · 📦 **Disable/superseded** ẨN. Mục-đích: anh thấy lại các LỆNH governance đã ký ("vì quan-trọng").
+- Mark cấp Active-High = LỆNH (P3 binding); vi-phạm → `error-ledger.md §L.a` RCA (P9). KHÔNG tự đóng dấu / đổi cấp (P4/P8 — chờ anh confirm).
+- **Light/hỏi-đáp session → có thể skip; governance session → nên chạy.**
+
 ### 2.2 Skill registry (6 skill)
 - Liệt kê: `contract-workflow` · `form-engine` · `permission-matrix` · `dependency-audit-erp` · `ef-core-migration` · `iis-deploy-runbook`
 - Dùng skill khi task khớp (KHÔNG tự suy luận lại). Phân bổ per agent: xem README skill matrix.
--- a/.claude/commands/user-mark-active-high.md
+++ b/.claude/commands/user-mark-active-high.md
@ -0,0 +1,21 @@
+---
+description: User-Mark cấp Active-High (bắt-buộc phải làm; vi-phạm → error-ledger §L.a RCA) — DACI report-before-stamp (canonical §P/H-12). Adopt S79.
+argument-hint: <quyết-định governance + §-target SE>
+---
+
+# /user-mark-active-high — neo quyết-định governance cấp CAO NHẤT
+
+> Chữ-ký quyết-định **GOVERNANCE** cấp **Active-High** (canonical §P, cơ-chế → [`docs/governance/harness-11-engine.md §E`](../../docs/governance/harness-11-engine.md)). Cặp: `/user-mark-active` · `/user-mark-medium` · `/user-mark-disable`. Ledger = `.claude/governance/ACTIVE-MARKS.md`.
+
+**Quyết-định anh nêu:** $ARGUMENTS
+
+## Quy trình (§P/H-12 DACI — report-before-stamp, P4) — em-main thực-thi:
+
+1. **Scope-check (P6):** quyết-định trên có đổi CANONICAL §-rule (rules.md / harness-11-engine / authority-routing) không? **KHÔNG** → đây là work-flow/task, **KHÔNG mark** → dừng + báo anh.
+2. **Adjust-Gov (P4):** soạn thay-đổi governance tương-ứng — **em-main single-writer (engine D9)**, KHÔNG fan-out memory/governance.
+3. **Double-check (P4):** quét `harness-11-engine.md §A-§E` + `error-ledger.md` Active-Guards + `ACTIVE-MARKS.md` tìm mâu-thuẫn (cross-harness contradiction · vocab-fork C3).
+4. **🔴 BÁO-CÁO anh TRƯỚC khi stamp (P4):** trình brief gồm `{thay-đổi · 3–7 tiêu-chí KHÁCH-QUAN (điểm-đau/khối-lượng/chất-lượng — rules §6.6, KHÔNG cảm-tính/quy-mô-đội/thời-gian-tuổi) · §-target · supersedes? · mâu-thuẫn-nếu-có}`. **CHỜ anh confirm. KHÔNG stamp trước báo-cáo.**
+5. **Stamp (anh confirm):** tạo `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` (timestamp lúc anh sign-off, lấy `date +'%d-%m-%Y-%H-%M-%S'`) → ghi `ACTIVE-MARKS.md` mục 🔴 Active-High + áp §-change vào canonical (rules.md/engine).
+6. **Lifecycle (P5):** supersede mark cũ → `supersedes:` con-trỏ-xuôi 1-chiều + cập-nhật status mark-cũ. 🔴 supersede mark **Active-High** cũ = anh-confirm RIÊNG (KHÔNG auto-downgrade).
+
+**Nghĩa cấp (H-13 deterministic):** Active-High = **bắt-buộc phải làm; vi-phạm → error-ledger §L.a RCA** (behavioral→MD+RCA · tool-action→`.claude/settings*.json` permission-deny, KHÔNG hook vì hook fails-open — E-006/AS-10). Binding (P3): stamp = LỆNH.
--- a/.claude/commands/user-mark-active.md
+++ b/.claude/commands/user-mark-active.md
@ -0,0 +1,21 @@
+---
+description: User-Mark cấp Active (follow + nhắc-lại xuyên-suốt) — DACI report-before-stamp (canonical §P/H-12). Adopt S79.
+argument-hint: <quyết-định governance + §-target SE>
+---
+
+# /user-mark-active — neo quyết-định governance cấp Active
+
+> Chữ-ký quyết-định **GOVERNANCE** cấp **Active** (canonical §P, cơ-chế → [`docs/governance/harness-11-engine.md §E`](../../docs/governance/harness-11-engine.md)). Cặp: `/user-mark-active-high` · `/user-mark-medium` · `/user-mark-disable`. Ledger = `.claude/governance/ACTIVE-MARKS.md`.
+
+**Quyết-định anh nêu:** $ARGUMENTS
+
+## Quy trình (§P/H-12 DACI — report-before-stamp, P4) — em-main thực-thi:
+
+1. **Scope-check (P6):** có đổi CANONICAL §-rule / authority-routing không? KHÔNG → work-flow, KHÔNG mark → dừng + báo anh.
+2. **Adjust-Gov (P4):** soạn thay-đổi governance — em-main single-writer (engine D9).
+3. **Double-check (P4):** quét `harness-11-engine.md §A-§E` + `error-ledger.md` + `ACTIVE-MARKS.md` tìm mâu-thuẫn.
+4. **🔴 BÁO-CÁO anh TRƯỚC khi stamp (P4):** brief `{thay-đổi · 3–7 tiêu-chí KHÁCH-QUAN (rules §6.6) · §-target · supersedes?}`. CHỜ anh confirm. KHÔNG stamp trước.
+5. **Stamp (anh confirm):** `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` → ghi `ACTIVE-MARKS.md` mục 🟢 Active + áp §-change.
+6. **Lifecycle (P5):** supersede mark cũ → `supersedes:` + cập-nhật status mark-cũ.
+
+**Nghĩa cấp (H-13 deterministic):** Active = **follow + nhắc-lại xuyên-suốt** (HIỆN @session-start §2.1.4 / session-end §L.b(h)). Nhẹ hơn Active-High (KHÔNG mandate RCA-tự-động), nhưng vẫn deterministic-follow. Binding (P3): stamp = LỆNH.
--- a/.claude/commands/user-mark-disable.md
+++ b/.claude/commands/user-mark-disable.md
@ -0,0 +1,20 @@
+---
+description: User-Mark-Disable — tắt/thu-hồi một mark đang active (reversible; canonical §P/H-12 P5 lifecycle). Adopt S79.
+argument-hint: <RC-id HOẶC mô-tả mark cần tắt>
+---
+
+# /user-mark-disable — tắt một User-Mark (reversible)
+
+> Thu-hồi/tắt một mark đang active trong `.claude/governance/ACTIVE-MARKS.md` (canonical §P/H-12 P5). **Reversible** (KHÔNG xóa audit-trail — chuyển status, giữ lịch-sử). Cơ-chế → [`docs/governance/harness-11-engine.md §E`](../../docs/governance/harness-11-engine.md). Cặp: `/user-mark-active-high` · `/user-mark-active` · `/user-mark-medium`.
+
+**Mark cần tắt:** $ARGUMENTS
+
+## Quy trình (§P/H-12 P5 lifecycle) — em-main thực-thi:
+
+1. **Locate:** tìm mark trong `ACTIVE-MARKS.md` khớp `$ARGUMENTS` (RC-id hoặc mô-tả). KHÔNG khớp / mơ-hồ → hỏi anh rõ mark nào.
+2. **🔴 BÁO-CÁO anh TRƯỚC khi tắt:** trình `{mark · cấp hiện-tại · §-target · lý-do tắt · hệ-quả nếu §-rule đang dựa vào nó}`. CHỜ anh confirm.
+   - 🔴 Nếu mark là **Active-High** → BẮT BUỘC anh-confirm RIÊNG (cấp cao nhất, KHÔNG auto-disable — P5).
+3. **Disable (anh confirm):** chuyển mark → mục 📦 SUPERSEDED/DISABLED (status `Disable`, giữ RC-id + nội-dung). Nếu mark đã codify §-rule → cân-nhắc revert/giữ §-rule (báo anh tách-bạch "tắt-mark ≠ revert-rule").
+4. **Reversible:** mark Disable có thể re-stamp lại sau (re-activate) — giữ nguyên audit-trail con-trỏ.
+
+**Nguyên-tắc (P5):** KHÔNG freeze-immutable — anh được đổi-ý/tắt qua re-stamp; git-history = audit-trail thật. Disable ≠ xóa (giữ để debate/trace sau).
--- a/.claude/commands/user-mark-medium.md
+++ b/.claude/commands/user-mark-medium.md
@ -0,0 +1,21 @@
+---
+description: User-Mark cấp Medium (neo quyết-định chưa-rõ; follow nhưng skippable) — DACI report-before-stamp (canonical §P/H-12). Adopt S79.
+argument-hint: <quyết-định governance chưa-chốt-hẳn + §-target SE>
+---
+
+# /user-mark-medium — neo quyết-định governance cấp Medium (chưa-rõ)
+
+> Chữ-ký quyết-định **GOVERNANCE** cấp **Medium** (canonical §P) — dùng khi anh muốn NEO MỐC một hướng chưa-chốt-hẳn (follow nhưng skippable). Cơ-chế → [`docs/governance/harness-11-engine.md §E`](../../docs/governance/harness-11-engine.md). Cặp: `/user-mark-active-high` · `/user-mark-active` · `/user-mark-disable`. Ledger = `.claude/governance/ACTIVE-MARKS.md`.
+
+**Quyết-định anh nêu:** $ARGUMENTS
+
+## Quy trình (§P/H-12 DACI — report-before-stamp, P4) — em-main thực-thi:
+
+1. **Scope-check (P6):** có đổi CANONICAL §-rule / authority-routing không? KHÔNG → work-flow, KHÔNG mark → dừng + báo anh.
+2. **Adjust-Gov (P4):** soạn thay-đổi (nếu có) HOẶC chỉ neo-mốc-không-codify (Medium thường chưa-đổi-rule cứng) — em-main single-writer (engine D9).
+3. **Double-check (P4):** quét `harness-11-engine.md §A-§E` + `error-ledger.md` + `ACTIVE-MARKS.md` tìm mâu-thuẫn.
+4. **🔴 BÁO-CÁO anh TRƯỚC khi stamp (P4):** brief `{hướng-neo · 3–7 tiêu-chí KHÁCH-QUAN (rules §6.6) · §-target nếu có · cái-gì-chưa-rõ}`. CHỜ anh confirm. KHÔNG stamp trước.
+5. **Stamp (anh confirm):** `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` → ghi `ACTIVE-MARKS.md` mục 🟡 Medium + ghi rõ "chưa-rõ phần X".
+6. **Lifecycle (P5):** khi anh chốt-rõ → re-stamp lên Active/Active-High (con-trỏ-xuôi `supersedes:`).
+
+**Nghĩa cấp (H-13 deterministic):** Medium = **neo quyết-định chưa-rõ; follow nhưng SKIPPABLE** (tóm-tắt @session display). KHÔNG mandate. Binding (P3): stamp = đã-neo (chưa phải lệnh-cứng như Active-High).