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`.