vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Á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>
This commit is contained in:
pqhuy1987
2026-06-20 10:53:23 +07:00
parent f0e616fd5a
commit 33d519eda0
21 changed files with 519 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/governance/adap-reports/2026-06-19-Governance-architecture-decision-rationality-rc-signature.md Normal file
View File

@ -0,0 +1,38 @@
# adap-report — Architecture-decision rationality + RC-signature (tiêu-chí khách-quan + chữ-ký niêm)
- **id:** 2026-06-19-Governance-architecture-decision-rationality-rc-signature
- **source broadcast:** `ai_infra/broadcasts/outbox/all/2026-06-19-Governance-architecture-decision-rationality-rc-signature.md` (`reviewer_gate: PASS` · `content_sha256: 4deb7876514686155c389cc8b9cf636855aae4fb0e75369de9b9947a83f32cd5`)
- **adopted by:** se (SOLUTION_ERP) · **session:** S79 · **date:** 2026-06-20
- **protocol:** Harness-9 PART-2 mandate = workflow IMPLEMENT + REVIEW tách biệt + report-with-run-id
- INVESTIGATE `wf_82337f7f-95c` (3× investigator-codebase — governance-landing map + completeness-gate H-6→H-13 + budget audit) → IMPLEMENT em-main single-writer (governance D9) → REVIEW `wf_a7cbe93e-912` (3× reviewer, floor 10/10) → **canonical-align re-REVIEW `wf_9d3beebb-a95`** (2× reviewer — §P P1-P10 fidelity PASS + drift PASS)
- **project-fit:** ✅ FIT — SE = solo-dev (chính đối-tượng dễ mắc lỗi "quá mức solo-dev") + có governance engine 11-agent cần kỷ-luật quyết-định.
## VERDICT: ✅ ADOPTED — 2 nguyên-tắc codify, mark Active-High stamped (anh-confirm S79)
Broadcast có 2 nguyên-tắc: (1) quyết-định kiến-trúc = tiêu-chí khách-quan (điểm-đau + khối-lượng + chất-lượng) KHÔNG quy-mô-đội; (2) chữ-ký niêm `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` cho mỗi rule-change. Cả 2 codify vào canonical SE + neo bằng User-Mark.
## Nấc (executed-file vs runtime · mechanized vs convention)
| Phần | Trạng-thái | Nấc |
|---|---|---|
| **Nguyên-tắc 1 — objective-criteria** | `rules.md §6.6` (bảng "Căn-cứ SAI" quy-mô-đội + AI=neo-lý-tính + thẩm-quyền cross-project) + `engine §E.5/P10` | executed-file · **convention** (kỷ-luật quyết-định) |
| **Nguyên-tắc 2 — RC-signature** | format `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` REUSE (KHÔNG redefine) ở `ACTIVE-MARKS.md` + `engine §E.1/P1` + `rules §6.6`; forward-only no-retrofit | executed-file · convention |
| **Mark Active-High** | `RC-pqhuy1987-20-06-2026-10-29-09` (objective-criteria) stamped, anh-confirm S79 via report-before-stamp | executed-file (owner-confirmed) |
## Tailoring (SE-specific)
- §-anchor SE = `rules.md §6.6` + `engine §E` (≙ AI_INFRA `§F4.2`) — notation `(≙ AI_INFRA)` giữ traceability cross-project, KHÔNG mượn §-number bên phát.
- Chữ-ký RC + objective-criteria neo qua **User-Mark canonical §P** (xem report `2026-06-19-Governance-harness-all-update`) — cùng cụm cơ-chế.
- SE stamp timestamp RIÊNG `20-06-2026-10-29-09` (P1 forward-only: mỗi dự-án ký lúc sign-off của mình), KHÔNG copy timestamp AI_INFRA.
## Honest caveats (KHÔNG nói quá)
- objective-criteria = **convention** (kỷ-luật người+AI), KHÔNG mechanized — đừng nhận "công-cụ-ép".
- RC-signature stamp = executed-file owner-confirmed (anh xác-nhận trong session qua "áp dụng đầy đủ chính xác nhất, không hỏi thêm"); chưa runtime-tested qua nhiều session.
## Reverse-findings (đề-xuất ngược AI_INFRA)
1. **2-channel enforcement ⊂ cái SE đã chứng-minh empirically** — broadcast trình "tool-action → permission-config NOT hook" như nguyên-tắc; SE đã có bằng-chứng SỐNG **E-006/AS-10** (`error-ledger.md`): hook fails-open → `store_memory` allowlist-strip = gate THẬT. Xác-nhận nguyên-tắc đúng + đã được thực-chứng ở sister.
2. **objective-criteria rule ⊃ rule team-size cũ** — SE map "time/age" (H-14) + "team-size" vào CÙNG bảng "Căn-cứ SAI" (`rules §6.6`) = trình-bày 1-họ-lỗi gọn hơn 2 rule rời. Đề-xuất AI_INFRA cân-nhắc gom trình-bày tương-tự.
## Evidence
- run-id: `wf_82337f7f-95c` (investigate) · `wf_a7cbe93e-912` (review) · `wf_9d3beebb-a95` (canonical-align re-review, §P 10/10 + drift PASS).
- Mark stamped: `ACTIVE-MARKS.md` 🔴 ACTIVE-HIGH `RC-pqhuy1987-20-06-2026-10-29-09`.
- 0 production code — governance-only. State THẬT GIỮ NGUYÊN: Mig 57 · 88 bảng · 354 test · gotcha 71 · bundle `CsJetgZH`/`BVS0ApIm`.

47
docs/governance/adap-reports/2026-06-19-Governance-harness-all-update.md Normal file
View File

@ -0,0 +1,47 @@
# adap-report — Harness-all-update: User-Mark (H-12/13) + hợp-nhất chuỗi H-6→H-13
- **id:** 2026-06-19-Governance-harness-all-update
- **source broadcast:** `ai_infra/broadcasts/outbox/all/2026-06-19-Governance-harness-all-update.md` (`reviewer_gate: PASS` · `content_sha256: 8c5377742b45b8447952f37a537052a0d99e63bfa581d430ada924d8c76af556`) + checklist `2026-06-19-Governance-checklist-harness-all.md` (`7e6e0555…`)
- directed heads-up `outbox/se/2026-06-19-ai_infra-to-se-harness-all-notify.md` (inbox verify ✓ whole-file `a52b8d03` + body `50ec0b92`)
- **canonical spec đầy-đủ:** `ai_infra/.claude/commands/user-mark-{active-high,active,medium,disable}.md` + `.claude/governance/ACTIVE-MARKS.md` + `CANONICAL-RULES.md §P` (P1-P10) — anh trỏ qua lệnh `/user-mark-active-high`, em pull canonical áp ĐẦY-ĐỦ (KHÔNG dùng bản phỏng-theo).
- **adopted by:** se (SOLUTION_ERP) · **session:** S79 · **date:** 2026-06-20
- **protocol:** Harness-9 PART-2 = workflow IMPLEMENT + REVIEW tách biệt + report-with-run-id
- INVESTIGATE `wf_82337f7f-95c` (3× investigator-codebase) → IMPLEMENT em-main single-writer (D9) → REVIEW `wf_a7cbe93e-912` (3× reviewer, floor 10/10) → **canonical-align + re-REVIEW `wf_9d3beebb-a95`** (2× reviewer — §P P1-P10 fidelity **PASS 10/10** + drift **PASS**, M-1 resolved)
- **project-fit:** ✅ FIT.
## VERDICT: ✅ ADOPTED — User-Mark canonical §P FULL (P1-P10) + completeness-gate H-6→H-13 ĐẠT
Bản làm 2 việc: ① công-bố User-Mark (H-12/13) · ② hợp-nhất H-6→H-13 + checklist tự-verify. SE adopt User-Mark **canonical §P đầy-đủ** (anh chốt "áp đầy-đủ chính-xác nhất theo AI_INFRA, không hỏi thêm") + chạy completeness-gate.
### ① User-Mark (H-12/13) — §P P1-P10 (re-review `wf_9d3beebb-a95` PASS 10/10)
| Cấu-phần | SE artifact | Nấc |
|---|---|---|
| Cơ-chế P1-P10 | `harness-11-engine.md §E` (E.1→P1·P2·P3·P8 · E.2→P4·P6 · E.3→P9 · E.4→P5·P7 · E.5→P10) | executed-file · phần-lớn **convention** (report-trước-đóng-dấu + behavioral-enforce + neo-lý-tính), mechanized chỉ session-display + tool-deny-config |
| Ledger | `.claude/governance/ACTIVE-MARKS.md` (canonical path + schema + 4-tier section + display-filter) | executed-file |
| Interface | 4 lệnh `/user-mark-{active-high,active,medium,disable}` (tailor §-target SE) | command `.md` **verified-pending-restart** (no hot-reload — đã thấy hot-register skill-list) |
| Display | `session-start §2.1.4` + `session-end §L.b(h)` status-filtered | executed-file, pending-restart |
| 3 mark Active-High stamped | objective-criteria `RC-…10-29-09` · User-Mark `…10-29-10` · time/age `…10-29-11` — anh-confirm S79, mirror AI_INFRA 3 mark by-content, SE timestamp riêng (P1 forward-only) | executed-file (owner-confirmed) |
### ② Completeness-gate H-6→H-13 — VERDICT ĐẠT (investigate `wf_82337f7f-95c`)
Cả 8 harness ADOPTED sạch. Soi kỹ 2 cái hay-sót: **H-8 all-inherit = 11/11 sub `model: inherit`, ZERO `[1m]` trong frontmatter** (3 hit `[1m]` đều prose/comment, không phải frontmatter); **H-7 Category 6** reviewer.md real on-disk (không pending). H-9/10/11 evidence đủ.
## Tailoring (SE-specific — form-autonomy P7 location-agnostic)
- Ledger ở `.claude/governance/ACTIVE-MARKS.md` (match canonical path cho command-consistency) — interim `docs/governance/decision-marks.md` (form em tự-nghĩ ban đầu) đã GỠ khi anh trỏ canonical.
- 4 lệnh tailor §-target = `rules.md §6.6` / `engine §E` / `error-ledger.md §L.a` / SE session-phase (≙ AI_INFRA `§F4.2`/`§P`/`§J9`/`§L1`).
- §E gom vào `harness-11-engine.md` (1 engine governance hợp-nhất H-11 + §E + §F) thay doc rời — B1 một-canonical-place.
- 2-channel enforce (P9) = XÁC-NHẬN bằng-chứng SE sẵn-có (E-006/AS-10 hook-fails-open), KHÔNG novelty.
## Honest caveats (KHÔNG nói quá)
- §E phần-lớn **convention** (report-trước-đóng-dấu + behavioral-enforce + neo-lý-tính = kỷ-luật, KHÔNG công-cụ-ép). CAVEAT engine ghi rõ.
- 4 lệnh + session-wiring = **verified-pending-restart** (command/agent `.md` no hot-reload giữa phiên — anh restart CLI để runtime đầy-đủ; skill-list ĐÃ hot-register tên lệnh).
- 3 mark = owner-confirmed trong session (anh "áp dụng đầy đủ … không hỏi thêm" = confirm report-before-stamp); chưa runtime-tested qua nhiều phiên session-display.
- B1 cross-pointer label M-1 (review #1 nêu) đã RESOLVED khi gỡ decision-marks.md + align canonical.
## Reverse-findings (đề-xuất ngược AI_INFRA)
1. **Broadcast cô-đọng → canonical là spec THẬT:** broadcast mô-tả 4 cấp theo CHỨC-NĂNG (không tên); spec dùng-được = lệnh `/user-mark-*` + `ACTIVE-MARKS.md` + §P P1-P10. Sister adopt từ broadcast-mình sẽ ra FORM khác (như SE bản đầu MUST/TRACK) → đề-xuất broadcast User-Mark TRỎ thẳng canonical command-files/§P để sister align đúng tên cấp ngay (cross-project consistency = chính giá-trị objective-criteria coi trọng).
2. **report-before-stamp (P4) ⊂ owner-approve đã có ở SE (D7 engine):** SE map P4 = vận-hành-hoá D7 (KHÔNG flow song-song) → tránh C3 vocab-fork mà detector SE tự bắt. Xác-nhận P4 không chọi cơ-chế owner-approve sẵn có.
## Evidence
- run-id: `wf_82337f7f-95c` (investigate + completeness-gate ĐẠT) · `wf_a7cbe93e-912` (floor 10/10) · `wf_9d3beebb-a95` (§P 10/10 + drift PASS).
- Marks stamped: `ACTIVE-MARKS.md` 3× ACTIVE-HIGH (anh-confirm S79).
- 0 production code. State THẬT GIỮ NGUYÊN: Mig 57 · 88 bảng · 354 test · gotcha 71 · menu 54 · bundle `CsJetgZH`/`BVS0ApIm`.

45
docs/governance/adap-reports/2026-06-20-Governance-harness-14.md Normal file
View File

@ -0,0 +1,45 @@
# adap-report — Harness-14 (Eval / Budget / Outcome theo hướng "khối-lượng × chất-lượng")
- **id:** 2026-06-20-Governance-harness-14
- **source broadcast:** `ai_infra/broadcasts/outbox/all/2026-06-20-Governance-harness-14-adopt.md` (`status: 🟢 ADOPT` · `reviewer_gate: PASS` · `content_sha256: 8da7e8b1854493f6e0f84211d82c04fbd2fe915b2b5686c0ab8033107ddefc0a`) + checklist `2026-06-20-Governance-checklist-harness-14.md` (`e96930da…`)
- plan-announce tiền-thân `2026-06-19-Governance-harness-all-update-v-2-0.md` = **SKIP n-a** (visibility-only PLAN-status, content_sha256 chưa stamp, superseded bởi adopt-broadcast này — KHÔNG áp riêng)
- directed heads-up `outbox/se/2026-06-20-ai_infra-to-se-harness-14-adopt-notify.md` (inbox verify ✓ whole-file `94c533cf` + body `37ae1b19`)
- **adopted by:** se (SOLUTION_ERP) · **session:** S79 · **date:** 2026-06-20
- **protocol:** Harness-9 PART-2 = workflow IMPLEMENT + REVIEW tách biệt + report-with-run-id
- INVESTIGATE `wf_82337f7f-95c` (budget/eval audit stream) → IMPLEMENT em-main single-writer (D9) → REVIEW `wf_4d4eba6f-8a0` (2× reviewer — §F floor **6/6 MET** + maturity **HONEST** + SE-state **ACCURATE**)
- **project-fit:** ✅ FIT — SE có L1/L2/L3 memory + archive-gate + `eval/` golden-set harness + memory-budget seed-by-measure.
## VERDICT: ✅ ADOPTED — 🔴 rule-floor codify + neo Active-High · 🟡 method honest 3-mức maturity
H-14 = đo chất-lượng + định-cỡ bộ-nhớ trên nguyên-lý "mọi con-số suy từ nhu-cầu thật, KHÔNG đặt-cứng". **Phát-hiện then-chốt (investigate): SE đã ALIGNED sẵn 2/3 cơ-chế** (budget no-decay + baseline-drift canonical-anchor) — adopt = codify rule tường-minh + map method onto cái SE THẬT có + khai honest 3-mức.
## Nấc theo phần (review `wf_4d4eba6f-8a0`)
| Phần | Trạng-thái | Nấc |
|---|---|---|
| 🔴 **RULE time/age = false-proxy** (§A 4 mục floor) | `rules.md §6.6` (bảng "Căn-cứ SAI" time/age cạnh team-size) + mark `RC-…10-29-11` Active-High + `memory-budget.json` 0 núm-decay + drift canonical-anchor | floor 4/4 MET · convention (rule) + mechanized (config no-decay) |
| 🔴 **Outcome** (§D 2 mục floor) | `§F.4` + `rules §6.6` (indicator-tied-to-outcome + Goodhart tức-thì, tổng-quát H8.2 "KHÔNG hạ model") | floor 2/2 MET · convention |
| 🟡 **Eval-precision** (Mức 1) | `§F.2` map onto `eval/` harness sẵn có (golden-set 14-q + evaluator.md recall@5≥0.7 + trial-state-lock) | **executed-file + convention** (weekly-MANUAL, CHƯA mechanized-CI; RAG re-index = AI_INFRA-op) |
| 🟡 **Budget** (Mức 1 ALIGNED) | `§F.3` = seed-by-MEASURE + archive_gate hysteresis/keep-floor/2-strike, 0 decay-knob (= PHẦN A) | **mechanized ALIGNED** (config) |
| 🟡 **Budget-hit-rate + outcome-correlation** (Mức 2) | `§F.3`/`§F.4` khai rõ "có công-cụ ĐO chưa đủ data" — SE chưa có đếm-lượt-truy-cập + thu-đánh-giá có cấu-trúc | **Mức-2 tool-pending-data** (KHÔNG trình như xong) |
| ◦ **Trần nhiễu ngữ-cảnh** (Mức 3) | `§F.1` ghi-nhận sao-bắc-đẩu, KHÔNG ép số | ack-only |
**Completeness-gate:** 6/6 🔴 floor (§A×4 + §D×2) MET (review xác-nhận meta-gate "tổng 6 mục sàn"; data-gate §C KHÔNG đếm thành mục thứ-7).
## Tailoring (SE-specific)
- §F gom vào `harness-11-engine.md` (engine governance hợp-nhất) — H-14 budget = PHẦN A đã có, eval = `eval/` đã có → map-onto thay vì dựng mới.
- 🔴 rule neo qua User-Mark mark-3 (cùng cụm §P) — self-sign RC-sig của SE.
## Honest caveats (KHÔNG nói quá — chính cốt-lõi H-14)
- **3-mức maturity trung-thực:** chỉ eval-precision Mức-1 dùng-được-ngay (NHƯNG manual-weekly, KHÔNG mechanized-CI); budget-hit-rate + outcome-correlation = Mức-2 **có công-cụ chưa-ra-số** (KHÔNG bịa); trần-nhiễu = Mức-3 tạm-gác. KHÔNG nâng mức thấp lên cao.
- **eval = đã CÓ, KHÔNG phải gap mới-dựng** — `§F.2` khai đúng "SE đã có harness (KHÔNG phải gap)", map nguyên-lý onto, không claim tự-chạy.
- **budget ALIGNED là may-mắn cấu-trúc** (seed-by-measure từ Harness-9), KHÔNG phải H-14 mới làm — khai rõ.
- Con-số AI_INFRA tự-đo (cỡ golden-set, recall) = bằng-chứng của HỌ, KHÔNG mục-tiêu áp-cứng SE — SE suy số riêng từ nhu-cầu mình.
## Reverse-findings (đề-xuất ngược AI_INFRA)
1. **SE đã obey 2/3 H-14 TRƯỚC khi adopt** (budget no-decay + drift canonical-anchor) — vì Harness-9 seed-by-measure + Harness-11 detector canonical-anchor đã ép đúng hướng. Xác-nhận: H-9/H-11 là tiền-đề cấu-trúc của H-14; dự-án nào đã chắc H-9/H-11 thì H-14-budget gần như free.
2. **Eval-precision automation = gap chung khả-dĩ:** SE có harness nhưng manual-weekly (RAG re-index AI_INFRA-owned). Nếu AI_INFRA mở tooling re-index/eval-CI cho sister, Mức-1 sẽ lên mechanized — hiện là nút-thắt cross-project, KHÔNG riêng SE.
## Evidence
- run-id: `wf_82337f7f-95c` (budget/eval audit: budget ALIGNED + eval GENUINE) · `wf_4d4eba6f-8a0` (§F floor 6/6 + maturity HONEST + state ACCURATE).
- Mark stamped: `ACTIVE-MARKS.md` `RC-pqhuy1987-20-06-2026-10-29-11` Active-High.
- 0 production code. State THẬT GIỮ NGUYÊN: Mig 57 · 88 bảng · 354 test · gotcha 71 · menu 54 · bundle `CsJetgZH`/`BVS0ApIm`.

84
docs/governance/harness-11-engine.md
View File

@ -4,6 +4,8 @@
>
> 🔑 **Đây là CANONICAL cho engine governance của SE.** Doc khác (`agents/README`, `session-start/end`) **TRỎ về đây**, KHÔNG copy luật (B1 dogfood — một-chỗ-đổi).
>
> 🔭 **Phạm-vi (S79 consolidate):** doc gốc Harness-11 (PHẦN A-D) nay **gom thêm §E (User-Mark H-12/13 canonical §P)** + **§F (Harness-14 Eval/Budget/Outcome)** — 1 engine governance hợp-nhất (mirror AI_INFRA "harness-all" consolidation). Ledger mark = `.claude/governance/ACTIVE-MARKS.md`.
>
> 🔑 **Nguyên-lý lõi:** "tự-bảo-trì" = luôn-TỰ-BIẾT khi có drift (detector tự-động, NÊU-CỜ ngay) **CHỨ KHÔNG tự-viết-lại** nội-dung/luật. DÒ tự-động; SỬA do người-chủ-trì (em-main) làm trên cờ. **BAR-KHÔNG-HẠ = một-người-ghi (single-writer)** — "tự-bảo-trì" TUYỆT-ĐỐI KHÔNG miễn-trừ chốt này.
---
@ -16,6 +18,8 @@
| PHẦN B — derived→canonical + freshness | luật B1 (dưới) + `scripts/governance-detectors.ps1` (C2 staleness) | detector mechanized + fix gated qua người |
| PHẦN C — 3 grep detector | `scripts/governance-detectors.ps1` (C1/C2/C3 + C4 self-exclusion + C5 resolve-condition) | mechanized NO-API, DÒ+FLAG-only |
| PHẦN D — orchestration | doc này (3-tier + 1-direction) + `session-start.md`/`session-end.md`/`ultra-on.md` cadence + `hmw.js` checkpoint | mix mechanized + convention |
| PHẦN E — User-Mark (H-12/13, canonical §P) + RC-signature | doc này §E (cơ-chế P1-P10) + `.claude/governance/ACTIVE-MARKS.md` (sổ-cái + display) + 4 lệnh `/user-mark-*` (interface) + `session-start §2.1.4`/`session-end §L.b(h)` (display) | convention (report-trước-đóng-dấu P4) + mechanized (display gắn-lệnh-phiên + tool-deny settings P9) |
| PHẦN F — Harness-14 Eval/Budget/Outcome | doc này §F (3-mức maturity + method) + `eval/` golden-set harness (F.2) + `memory-budget.json`/`measure-agent-memory.ps1` (F.3 = PHẦN A) | eval = executed-file + convention (manual) · budget = mechanized ALIGNED · outcome-correlation/hit-rate = Mức-2 tool-pending-data |
| Canonical state (nguồn-chuẩn) | `docs/STATUS.md` CURRENT STATE table | — |
---
@ -66,7 +70,7 @@ Tất cả ở `scripts/governance-detectors.ps1` — NO-API (grep/measure only)
|---|---|---|
| **D5 — AUTO (semantic-null)** | dồn-archive ADDITIVE (byte-0-loss) · dựng-lại `_INDEX` · APPEND-chắt-lọc gist · đo-byte | tự-động OK (có A7 NO-API gate bảo-chứng) |
| **D6 — DÒ + NÊU-CỜ** | mọi thứ chạm prose/luật/con-trỏ-mục/thẩm-quyền/copy-chéo (3 detector C + monitor H1/H2) | chỉ FLAG → em-main soạn bản sửa (KHÔNG nhánh tự-ghi) |
| **D7 — OWNER-APPROVE** | đổi-luật · đổi-thẩm-quyền · ghi-lan derived · đổi-tên-khái-niệm · nâng-guard chính-thức | anh (project-owner) duyệt trước hiệu-lực |
| **D7 — OWNER-APPROVE** | đổi-luật · đổi-thẩm-quyền · ghi-lan derived · đổi-tên-khái-niệm · nâng-guard chính-thức | anh (project-owner) duyệt trước hiệu-lực — **vận-hành-hoá bởi report-trước-đóng-dấu §E.2** (đổi-luật cấp-governance đi qua quy-trình 4-bước + chữ-ký RC) |
### D.3 — Bốn chốt chống-tự-hỏng
- **D8 khoá-chiều 1-CHIỀU** 🔴 (codify mới H11) — DÒ chỉ đi **canonical → derived** (bắt derived cũ). **TUYỆT-ĐỐI KHÔNG** lấy giá-trị từ derived ghi ngược canonical. (Vd: detector đọc STATUS so root CLAUDE.md; KHÔNG bao giờ đọc root CLAUDE.md ghi vào STATUS.)
@ -76,9 +80,87 @@ Tất cả ở `scripts/governance-detectors.ps1` — NO-API (grep/measure only)
---
## PHẦN E — User-Mark (Harness-12/13) + chữ-ký RC quyết-định = canonical §P (🔴 FUNCTION-FLOOR)
> **Adopt S79 (2026-06-20)** — AI_INFRA `2026-06-19-Governance-harness-all-update` (User-Mark) + `…rc-signature` + **canonical §P** (P1-P10). Neo + cưỡng-chế **quyết-định cấp-governance** (luật/chính-sách/kiến-trúc/harness) để không-quên + không-giảm-bằng-cảm-tính. **KHÔNG** dùng cho vận-hành/tác-vụ thường-ngày (P6 scope-discriminator).
>
> 🔑 **3 cấu-phần (B1 phân-vai):** §E này = **CƠ-CHẾ** (codify §P P1-P10 cho SE) · ledger = `.claude/governance/ACTIVE-MARKS.md` (SỔ-CÁI + display, single-writer em-main) · interface = 4 lệnh `/user-mark-active-high|active|medium|disable`. Cấp do em-main gán + anh confirm (KHÔNG agent tự-phán cảm-tính — P8).
### E.1 — Chữ-ký + 4 cấp + binding (P1·P2·P3·P8)
- **P1 Chữ-ký:** mỗi mark mang `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` (REUSE format rc-signature, timestamp lúc anh sign-off). Bằng-chứng-có-niêm: minh-oan · tranh-luận-bằng-bằng-chứng (debate khi ruling mâu-thuẫn) · trách-nhiệm-2-chiều. Forward-only (no-retrofit từ 2026-06-20).
- **P2 4 cấp deterministic** (anh-instruction trực-tiếp, KHÔNG design-invention) — **trực-giao** với tầng-an-toàn D5-D8:
| Cấp | Hành-vi xác-định (P8) | Vi-phạm |
|---|---|---|
| 🔴 **Active-High** | bắt-buộc phải làm (cao nhất) | → `error-ledger.md §L.a` RCA (P9) |
| 🟢 **Active** | follow + nhắc-lại xuyên-suốt | nhắc-lại (KHÔNG mandate RCA-tự-động) |
| 🟡 **Medium** | neo quyết-định chưa-rõ; follow nhưng **skippable** | — |
| 📦 **Disable** | tắt (reversible, giữ audit-trail) | — |
- **P3 Binding nhị-phân:** **có stamp = LỆNH · không stamp = đang BÀN** (thảo-luận ≠ lệnh execute).
- **P8 No-cảm-tính:** mỗi cấp = hành-vi DETERMINISTIC, KHÔNG agent tự-phán. "Tự-skip-workflow tiết-kiệm-token" = lệch → theo rule TƯƠNG-ĐỐI H6.1 (substantive→HMW · trivial→solo), KHÔNG số-magic.
### E.2 — Flow DACI report-trước-đóng-dấu + scope-check (P4·P6 = vận-hành-hoá D7, 🔴 floor)
Đổi-luật cấp-governance đi qua **các bước, KHÔNG được tắt** (4 lệnh `/user-mark-*` thực-thi):
1. **Scope-check (P6):** "Có đổi CANONICAL §-rule / authority-routing không? KHÔNG → đây là **work-flow** → KHÔNG mark." (User-Mark = Gov-decision, KHÔNG task-execution.)
2. **Adjust-Gov (P4):** soạn nội-dung luật mới — em-main **single-writer D9**, KHÔNG fan-out.
3. **Double-check (P4):** quét `§A-§E` + `error-ledger.md` Active-Guards + `ACTIVE-MARKS.md` + `governance-detectors.ps1 C3` tìm mâu-thuẫn (cross-harness / vocab-fork).
4. **🔴 Báo anh kèm 3-7 tiêu-chí khách-quan (P4):** điểm-đau đã-xảy-ra-thật · khối-lượng · chất-lượng (KHÔNG quy-mô-đội / thời-gian-tuổi); cấp đề-xuất; §-target; supersedes?; mâu-thuẫn đã-rà. **CHỜ anh confirm. KHÔNG stamp trước báo-cáo.**
5. **Stamp (anh confirm):** `RC-pqhuy1987-dd-mm-yyyy-hh-mm-ss` → ghi `ACTIVE-MARKS.md` + áp §-change vào canonical.
> NEW vs D7-cũ = scope-check tường-minh (P6) + rà-mâu-thuẫn (bước 3) + 3-7 tiêu-chí khách-quan (P4). D7 vốn = "owner duyệt trước hiệu-lực"; §E.2 làm rõ QUY-TRÌNH, KHÔNG tạo flow song-song (tránh C3).
### E.3 — Cưỡng-chế 2-kênh, KHÔNG hook (P9 — = XÁC-NHẬN cái SE đã chứng-minh)
| Kênh | Vi-phạm | Cưỡng-chế | Bằng-chứng SE sẵn-có |
|---|---|---|---|
| **Behavioral-mark** | ghi `error-ledger.md §L.a` (AS-table) + **RCA** | convention (kỷ-luật người+AI) | §L.a 2-strike-promote đã chạy |
| **Tool-action-mark** | **permission-DENY** ở `.claude/settings*.json` (deny-absolute) — **KHÔNG hook** (hook fails-open = observability-only) | mechanized (config) — *xem D10: Bash residual chưa block cứng = gap honest* | **E-006/AS-10** (`error-ledger.md`): hook fails-open → `store_memory` allowlist-strip = gate THẬT; git-diff = backstop |
### E.4 — Lifecycle + storage/SHOW (P5·P7)
- **P5 Lifecycle:** con-trỏ-XUÔI 1-chiều (mark-mới `supersedes:` mark-cũ) + cập-nhật status/cấp mark-cũ (downgrade HOẶC →Disable). 🔴 supersede mark **Active-High** = anh-confirm RIÊNG (KHÔNG auto-downgrade). **KHÔNG freeze-immutable** (git-history audits; anh sửa/đổi-ý qua re-stamp). Disable ≠ revert-rule (tách-bạch).
- **P7 Storage + SHOW:** ledger `.claude/governance/ACTIVE-MARKS.md` (single-writer em-main B3; P7 location-agnostic). 🔴 **SHOW @session-start §2.1.4 + @session-end §L.b(h)** status-filtered: Active-High + Active HIỆN rõ · Medium tóm-tắt · Disable/superseded ẨN.
### E.5 — Objective-only + neo-lý-tính (P10 = `rules.md §6.6`, 🔴 floor)
- Adopt/giảm function bằng **điểm-đau + khối-lượng + chất-lượng KHÔNG quy-mô-đội / KHÔNG thời-gian-tuổi**; "overkill/quá-mức-solo-dev/cảm-tính/cũ-rồi-nên-bỏ" = **BÁC**.
- **AI = neo-lý-tính:** gặp quyết-định biện-minh bằng cảm-giác → em-main **nêu-cờ + bác trên cơ-sở khách-quan**, KHÔNG xoa-dịu. Thẩm-quyền phán "cần/thừa" = **tầng xuyên-dự-án (AI_INFRA)**, KHÔNG dự-án đơn-lẻ. (Bối-cảnh: rule nảy từ audit thật — 1 dự-án từ-chối chức-năng chống-lách-engine bằng "quá mức solo-dev"; điều-phối ban-đầu cũng xoa-dịu trước khi được chỉnh.)
---
## PHẦN F — Harness-14: Eval / Budget / Outcome (🟡 method TAILORED + 🔴 rule-floor)
> **Adopt S79 (2026-06-20)** — AI_INFRA `2026-06-20-Governance-harness-14-adopt` + checklist-14. Cơ-chế **đo chất-lượng + định-cỡ bộ-nhớ** trên nguyên-lý nền: **mọi con-số suy từ nhu-cầu thật, KHÔNG đặt-cứng tùy-tiện.** 🔴 rule bắt-buộc (time/age = false-proxy) đã codify ở mark `RC-…10-29-11` + `rules.md §6.6` — §F này = phương-pháp + trạng-thái-độ-chín honest.
**4 nguyên-lý nền:** ① suy-ra-từ-nhu-cầu KHÔNG đặt-cứng (cấm "số ma-thuật") · ② loại proxy-sai (time/age/quy-mô-đội) · ③ chỉ-báo phục-vụ kết-quả (tối-ưu chỉ-báo bỏ kết-quả thật = kinh-tế-giả) · ④ trung-thực về độ-chín.
### F.1 — Trạng-thái độ-chín 3 MỨC (🔴 honest — KHÔNG nâng mức thấp lên cao)
- **Mức 1 LÀM-ĐƯỢC-NGAY:** eval-precision (đo chất-lượng truy-xuất) — SE CÓ harness chạy thật (xem F.2).
- **Mức 2 ĐANG-TÍCH-LŨY (có công-cụ ĐO, CHƯA đủ data ra số):** budget-theo-hit-rate (cần nhật-ký truy-cập memory) + tương-quan-outcome (cần nhiều tuần đánh-giá). **🔴 Cổng dữ-liệu: dưới ngưỡng → DỪNG, giữ quy-ước đo-được, KHÔNG bịa số.**
- **Mức 3 TẦM-NHÌN-XA (tạm gác):** trần "nhiễu ngữ-cảnh" — không mốc-cứng đáng-tin theo nghiên-cứu → sao-bắc-đẩu định-hướng, KHÔNG ép số.
### F.2 — Eval-precision (🟡 — SE đã CÓ, map onto, honest)
SE đã có RAG golden-set harness (KHÔNG phải gap): `eval/golden-set-solution_erp.jsonl` (14 query: 11 pos + 3 neg) + `eval/evaluator.md` (Spec-A strict, recall@5 gate ≥0.7, rerank ≥0.7 **per-query confident-hit** [gate aggregate avg-rerank 0.65], Case A/B/C/D triage) + `eval/trial-state-lock.json` (baseline recall@5=1.0, chunk-drift 5%). Nguyên-lý H-14 áp:
- **Cỡ golden-set suy từ độ-chính-xác mong-muốn** (công-thức cỡ-mẫu) KHÔNG đặt-cứng — hiện 14 query là quy-ước-đo-được; khi mở-rộng → suy theo confidence-level.
- **Chống nhồi-từ-khóa:** query test KHÔNG lặp nguyên-văn từ-khóa tài-liệu đích (đo năng-lực thật, không trúng-vì-trùng-chữ).
- **Ngưỡng theo đường-nền tương-đối** (so `trial-state-lock` baseline + biên tụt nhỏ) KHÔNG mốc tuyệt-đối tự-đặt; **mẫu-số động** (tỉ-lệ theo số query thật-có).
- 🟡 **Honest nấc:** harness EXISTS + well-specified nhưng **weekly-Friday MANUAL** (`evaluator.md` chạy MCP `search_memory` tay), CHƯA automated trong `scripts/`; RAG re-index = AI_INFRA-owned op. → **executed-file + convention (manual gate)**, KHÔNG mechanized-CI. KHÔNG overclaim "tự-chạy".
### F.3 — Budget bộ-nhớ (🟡 ALIGNED — đo-thật, KHÔNG số-ma-thuật)
- **Đã ALIGNED:** `memory-budget.json` cap = **seed-by-MEASURE** (`scripts/measure-agent-memory.ps1`, `_note` "SEEDED BY MEASUREMENT NOT imagined headroom"); `archive_gate` = hysteresis 0.85 + keep-floor-5 (newest-protection) + 2-strike — **0 núm decay-theo-tuổi** (≙ mark `RC-…10-29-11`). Trần = hệ-quả (dung-lượng ÷ tốc-độ-thay-mới qua A4 hysteresis), KHÔNG retention-by-age. Cross-ref **PHẦN A**.
- 🟡 **Hit-rate sizing = Mức 2 chờ-tích-lũy:** SE chưa có công-cụ đếm-lượt-truy-cập-memory → budget giữ **quy-ước đo-được** (đo byte thật). KHÔNG trình như "đã suy từ hit-rate".
### F.4 — Outcome (🔴 floor + 🟡 tích-lũy)
- 🔴 **Chống kinh-tế-giả (Goodhart) — tức-thì:** cắt chất-lượng tiết-kiệm token → làm-lại → tốn HƠN (mark/§6.6 + H8.2 "KHÔNG hạ model"). Mỗi chỉ-báo tự-động (recall/hit-rate/byte) gắn câu hỏi "có làm anh chốt-OK sớm hơn không". Áp NGAY, không chờ data.
- 🔴 **Ground-truth = đánh-giá chủ-dự-án** (đo gián-tiếp qua số-lần-làm-lại); chỉ-báo tự-động chỉ là trung-gian.
- 🟡 **Tương-quan chỉ-báo↔đánh-giá-người = Mức 2 chờ-tích-lũy:** SE chưa có công-cụ thu-đánh-giá + đếm-rework có cấu-trúc (error-ledger §L.a RCA = mầm gần nhất) → cần nhiều tuần mới khẳng-định tương-quan. **KHÔNG bịa số tương-quan "đẹp".**
> **Tổng nấc §F (honest, checklist-14):** 🔴 floor (loại proxy time/age 4 mục + outcome 2 mục) = ĐẠT qua mark + §6.6 + §F.4. 🟡 method = eval-precision **executed-file + convention** (manual, không mechanized-CI) · budget **ALIGNED mechanized** (config no-decay) · outcome-correlation + hit-rate = **Mức-2 tool-pending-data** (KHÔNG trình như xong). Các con-số AI_INFRA tự-đo (cỡ golden-set, recall) = bằng-chứng của HỌ, KHÔNG mục-tiêu áp-cứng cho SE.
---
## CAVEAT (trung-thực — đọc trước khi tự nhận "đã tự-bảo-trì")
- **No-OS-hook:** detector + gate chạy TRONG thân session-start/end body do em-main kích — KHÔNG fully-autonomous. Đúng mức: **DÒ tự-động + toàn-diện; SỬA + GÁC dựa người-chủ-trì.**
- **Auto-WRITE luật/copy = MỐI-NGUY #1, CỐ Ý CHƯA LÀM** — defer tới ≥2 sự-cố thật mà thủ-công thất-bại (hiện 0). Chọn nhánh chỉ-DÒ-NÊU-CỜ cho mọi thứ chạm luật/copy (1-sửa-sai → N-chỗ-sai + phá hash broadcast đóng-băng).
- **Single-writer bar-không-hạ** — cám-dỗ "để nó tự sửa cho nhanh" phải dừng trước chốt D9.
- **Detector = LƯỚI giảm-sót, KHÔNG khoá-cứng** — bắt @đầu/đóng-phiên (theo nhịp); giữa 2 nhịp có khoảng-mù. Phòng-thủ-nhiều-lớp, không bảo-đảm tuyệt-đối.
- **Nấc dogfood:** A2/A3/D4/D9/D11 = SE runtime-mechanized SẴN (H11 = chuẩn-hoá). C1-C3 + B3 + memory-archive-gate = MỚI build S75. D5-D8 + B1 = nhãn-hoá/codify cái ngầm-có. Phân-định 'detector viết-thành-lệnh' (executed-file) ≠ 'đã chạy-quan-sát' (runtime).
- **§E User-Mark = phần-lớn CONVENTION (S79):** report-trước-đóng-dấu (E.2/P4) + cưỡng-chế-hành-vi (E.3 behavioral) + neo-lý-tính (E.5/P10) = **kỷ-luật người+AI**, KHÔNG công-cụ-ép (đừng nhận "mechanized"). CHỈ session-display (gắn lệnh-phiên P7) + chặn-tool-ở-config (E.3 tool-action P9) = mechanized. RC-sig 3 mark Active-High đã anh-confirm-stamp S79 (`ACTIVE-MARKS.md`) = executed-file; 4 lệnh `/user-mark-*` = command `.md` verified-pending-restart (no hot-reload).