[CLAUDE] Docs: adopt Harness-15-v2 (Tang-1 hot-feed-lon + L2/L3 bo-tran + %-print + role-boundary, S82)
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 4m45s

- token_governor v2: L1 12K -> hot-feed per-role (lead 60K/sub 20K/wf 16K); L2/L3 6K/4K -> NO-CAP
- engine G.4 + session-start 2.1.6 + session-end L.b(c): %-print 2-dau-phien
- role-boundary: con-so = quyen chu-du-an (anh), AI thuc-thi + bao-%; sua framing lead-authority S81
- mark H-15 v2-delta anh-confirm RC-pqhuy1987-21-06-2026-01-58-01
- 2-process: IMPLEMENT em-main D9 + REVIEW wf_04667b25-5fa 3/3 PASS (3 MINOR fixed)
- check-email STAGE 1+2 (notify verify ok) + email AI_INFRA (a749bb6bd1be)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
pqhuy1987
2026-06-21 02:02:05 +07:00
parent 700e4c951b
commit aa3f0fefb4
9 changed files with 193 additions and 13 deletions

View File

@ -0,0 +1,71 @@
# adap-report — Harness-15-v2 (Tầng-1 hot-feed LỚN + L2/L3 bỏ-trần + %-print + ranh-giới vai-trò)
- **id:** 2026-06-21-Governance-harness-15-v2-hot-feed-update
- **source broadcast:** `ai_infra/broadcasts/outbox/all/2026-06-20-Governance-harness-15-v2-hot-feed-update.md` (`type: update` · `status: 🟢 ADOPT` · `supersedes_scope: tier-1-sizing-and-L2-L3-caps-only` · `content_sha256: e028537b…` · `reviewer_gate: PASS`)
- directed notify: `outbox/se/2026-06-20-ai_infra-to-se-harness-15-v2-notify.md` (inbox verify ✓ whole-file `0b92b3ed` + body `2e609781` MATCH)
- **adopted by:** se (SOLUTION_ERP) · **session:** S82 · **date:** 2026-06-21
- **protocol (Harness-9 PART-2):** IMPLEMENT em-main single-writer (D9) + REVIEW Workflow tách-biệt + report-with-run-id
- REVIEW `wf_04667b25-5fa` (3 free-text lane: floor-completeness · faithfulness · honesty-regression — KHÔNG ép-schema, bài học S73)
- **project-fit:** ✅ FIT — SE đã có Harness-15 gốc (S81): `token_governor` 3-tầng + `harness_floor` + `value_protect` + work-state block. v2 = delta tinh-chỉnh trên cái SE THẬT có.
## VERDICT: ✅ ADOPTED (delta) — re-verify CHỈ phần đổi, KHÔNG adopt lại từ đầu
H15-v2 chồng lên H15 gốc (mark Active-High `RC-…23-07-37` vẫn binding), `supersedes_scope = tier-1-sizing + L2/L3-caps ONLY`. Các sàn-chức-năng gốc (§G.1-G.3: đo-SÀN + 6 floor a-e + value_protect) **KHÔNG đổi**.
### 4 phần đổi đã áp (đối-chiếu broadcast §2-§6)
| # | v2 delta | SE áp (file:locus) | Nấc |
|---|---|---|---|
| 1 | **Tầng-1 = HOT-FEED LỚN** per-role, nạp-đầy 4 bucket | `memory-budget.json:token_governor.tier1_hotfeed_tokens` — lead **60K** / agent-ký-ức **20K** / agent-workflow **16K** (thay flat 12K) | executed-file |
| 2 | **L2/L3 BỎ TRẦN** (on-demand, no artificial tier-cap) | `token_governor.l2_ondemand`/`l3_rag` = `"NO-CAP"` (gỡ 6K/4K) | executed-file |
| 3 | **%-print 2 đầu-phiên** (composition + Headroom) | `session-start.md §2.1.6` (đầu) + `session-end.md §L.b(c)` (cuối) + `token_governor.pct_print` | executed-file (runtime mỗi phiên) |
| 4 | **Ranh-giới vai-trò** — con-số = quyền CHỦ-DỰ-ÁN/anh, AI thực-thi + báo-% | `token_governor.role_boundary_note` + engine `§G.4(4)` + 2 cmd-doc | executed-file |
| — | engine canonical | `harness-11-engine.md §G.4` (4 delta) + §G.1-line cập-nhật + bảng row + adopt-note S82 | executed-file |
| — | mark accuracy | `ACTIVE-MARKS.md` H-15 What-cell refine (giữ tier Active-High + RC-sig + tiêu-chí; chỉ đổi số literal stale) | executed-file |
### Tailored (FORM tự-do) — con-số SE tự-đo, KHÔNG mượn 220/60/50
- **🔴 Con-số bên-phát (lead 220K / mem-sub 60K / wf-sub 50K) = số HỌ tự-đo trên model+federation-scale của HỌ — SE KHÔNG áp cứng.** SE tự-đo-estimate theo scale riêng (single-project, Opus 4.8 1M window, sub MEMORY.md byte-capped 30720B): **lead 60K · agent-ký-ức 20K · agent-workflow 16K**. Nhỏ hơn AI_INFRA vì SE = 1 dự-án (không 6-project federation). Đây là **estimate có-chủ-đích KHÔNG byte-đo-cục-bộ-được**; %-print 2-đầu-phiên là cái cho composition THẬT để anh chỉnh.
- **SÀN-kiến-trúc (bắt-buộc):** Tầng-1 hot-feed-lớn (nạp 4 bucket, đừng mỏng) + L2/L3 on-demand bỏ-trần. **Con-số = tự-do theo scale.**
### Ranh-giới vai-trò — sửa framing S81 (điểm governance đáng-chú-ý)
S81 ghi "Numbers = LEAD-AUTHORITY hard-cap... NO AI may re-optimize". v2 §6 làm rõ: con-số = **quyền CHỦ-DỰ-ÁN (anh)**, KHÔNG phải AI-lead. Đã reframe: con-số = anh đặt; em-main (i) thực-thi đúng-số + (ii) báo-% 2-đầu-phiên cho anh quyết; em-main KHÔNG tự-tinh-chỉnh-số. Cùng tinh-thần mark `RC-…10-29-09` (AI = neo-lý-tính, anh quyết) + report-before-stamp DACI.
### Mark-update honest-flag (cần anh biết)
Mark Active-High `RC-…23-07-37` (H-15) có số literal "L1 12K/L2 6K/L3 4K" → stale sau v2. Em cập-nhật **tối-thiểu** What-cell (→ hot-feed-lớn per-role + bỏ-trần + anh-authority, ghi rõ "refine v2 §G.4 S82") + refresh volume "~42K" → **GIỮ NGUYÊN** tier Active-High + RC-signature + objective-criteria. KHÔNG mint RC-sig mới, KHÔNG đổi cấp (v2 = delta TRONG mark cũ, không phải quyết-định-governance MỚI). **Status cell flag "v2-delta S82 pending anh-confirm @session-end"** (honest: v2 adopt qua mandate AI_INFRA, chờ anh ký-duyệt P4 — KHÔNG present S82 là đã-anh-confirm). Hiển-thị + anh-confirm ở session-end §L.b(h).
## Honest nấc (G-011) + mechanized-vs-convention
- **executed-file** mọi edit (config + doc + cmd). **runtime** = %-print + hot-feed-fill chứng-minh mỗi phiên kế (§2.1.6 chạy từ phiên sau — ⚠️ command `.md` no hot-reload → **VERIFIED-pending-restart** cho phần cmd-doc; config JSON live ngay).
- **Nấc cơ-chế:** (1)(2) = **config mechanized** (token_governor số tách) · (3)(4) = **convention** (kỷ-luật người+AI: em-main nạp-đủ + báo-% + anh-quyết-số — KHÔNG công-cụ-ép). KHÔNG nhận "mechanized" cho kỷ-luật.
- **đánh-đổi honest (v2 §5):** Tầng-1 lớn = rot CAO HƠN trên always-loaded — chấp-nhận có-chủ-đích (quên-việc tệ hơn rot), KHÔNG "rot biến mất".
## Fan-out diff reconciliation (S82) — `/adap-apply all` 29 broadcast vs 22 adap-report
9 không-khớp exact-id → verify từng cái: **1 MỚI THẬT = H15-v2 (báo-cáo này).** 7 còn lại = đã-phủ (verify-not-redo):
- `checklist-harness-11` = verify-aid H11 (adopt S75) · `checklist-harness-9-10-v2` + `h10-flat-detector-refine` = S72 `harness-10-flat-refine-checklist-v2` · `checklist-harness-all` = verify-aid H6→H13 (rải S63-S79) · `harness-all-update-v-2-0` = PLAN-ANNOUNCE visibility-only (harness-14 report ghi SKIP n-a) · `checklist-harness-14` = harness-14 report ref `e96930da` · `harness-14-adopt` = source của `harness-14.md` (chỉ khác tên-file).
- `checklist-harness-15` = verify-aid của H15 (adopt S81, dùng làm completeness-gate) — dùng lại trong review v2 này.
## REVIEW verdict (Workflow `wf_04667b25-5fa`) — ✅ 3/3 lane PASS
3 reviewer độc-lập (free-text, agentType: reviewer):
- **floor-completeness: PASS** (1 MINOR, 0 CRIT/MAJOR) — cả 4 v2 delta PRESENT + WIRED; old key `l1_always/l2=6000/l3=4000/headline=42000` **REMOVED-confirmed** (grep 0); §G.1-G.3 byte-intact. *"genuine PASS, not a courtesy one."*
- **faithfulness: PASS** (1 MINOR) — số 220/60/50 KHÔNG mượn (label estimate SE-riêng); role-boundary reframe đầy-đủ (old "lead-authority" replaced, không giữ ngầm); honest_caveat khớp v2 §5; JSON valid.
- **honesty-regression: PASS** (0 CRIT/MAJOR) — mark RC-sig + tier + objective-criteria **preserved** (NO new-mint, NO tier-change); §G.2 6-floor + value_protect byte-identical; (1)(2)=config-mechanized · (3)(4)=convention **honest** (KHÔNG overclaim); session-start 2.1.5→2.1.6→2.2 sạch + session-end 8-item (a)-(h) nguyên.
**3 MINOR → ĐÃ FIX (review→fix loop):**
1. `ACTIVE-MARKS:18` volume "~42K" stale → refresh "SÀN 30K + Tầng-1 hot-feed per-role" (giữ luận-điểm volume).
2. Mark status "(anh-confirm S81)" mang nội-dung S82 → append "**v2-delta S82 pending anh-confirm @session-end**" (honest report-before-stamp: v2 adopt qua mandate, chờ anh ký-duyệt).
3. `_index` pending + inbox untracked → **STAGE 2 done** (move `inbox/ai_infra/` + flip processed).
**Reviewer memory-note (harvest):** `broadcasts/_index.md` sha = notify's **self-declared `content_sha256`** (frontmatter), KHÔNG recompute full-file → đừng flag "mismatch" trước khi đọc frontmatter field.
## Self-check (broadcast §"Dành cho dự-án")
- [x] re-verify CHỈ phần đổi (1)(2) + tool (3)(4) — KHÔNG làm lại sàn-chức-năng gốc H15
- [x] 2-process: IMPLEMENT (em-main D9) + REVIEW (workflow tách-biệt run-id)
- [x] con-số tự-đo theo scale SE (KHÔNG mượn 220/60/50)
- [x] kiến-trúc = SÀN, con-số = tự-do (honest)
- [x] tự ký-duyệt: anh-confirm S82 `RC-pqhuy1987-21-06-2026-01-58-01` (report-before-stamp ✓)

View File

@ -20,7 +20,7 @@
| 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 |
| PHẦN G — Harness-15 memory-budget per-agent (token) | doc này §G (SÀN floor + 3-tầng token) + `memory-budget.json` (`harness_floor` + `token_governor` + `archive_gate.value_protect`) + `session-start §2.1.5` (work-state block) | 2-governor mechanized (byte ⟂ token config) + 5/6 sàn-chức-năng = convention |
| PHẦN G — Harness-15 memory-budget per-agent (token) **+v2 §G.4** | doc này §G (SÀN floor + 3-tầng token + **§G.4 hot-feed-lớn / L2-L3-bỏ-trần / %-print / ranh-giới-vai-trò**) + `memory-budget.json` (`harness_floor` + `token_governor` v2 + `archive_gate.value_protect`) + `session-start §2.1.5`+**§2.1.6** + **`session-end §L.b(c)`** | 2-governor mechanized (byte ⟂ token config) + 5/6 sàn-chức-năng = convention; **v2 (1)(2)=config · (3)(4)=convention** |
| Canonical state (nguồn-chuẩn) | `docs/STATUS.md` CURRENT STATE table | — |
---
@ -162,12 +162,14 @@ SE đã có RAG golden-set harness (KHÔNG phải gap): `eval/golden-set-solutio
> **Adopt S81 (2026-06-20)** — AI_INFRA `2026-06-20-Governance-harness-15-memory-budget` + checklist-15 (inbox `broadcasts/inbox/ai_infra/`). Áp qua 2-process (IMPLEMENT em-main single-writer D9 + REVIEW workflow) per mandate §6. adap-report → `docs/governance/adap-reports/2026-06-20-Governance-harness-15-memory-budget.md`.
>
> **Adopt-delta S82 (2026-06-21)** — AI_INFRA `2026-06-20-Governance-harness-15-v2-hot-feed-update` (type: update · supersedes_scope = tier-1-sizing + L2/L3-caps ONLY). Re-verify CHỈ phần đổi → **§G.4** (Tầng-1 hot-feed-lớn + L2/L3 bỏ-trần + %-print 2-đầu-phiên + ranh-giới-vai-trò). Phần sàn-chức-năng gốc (§G.1-G.3) **KHÔNG đổi**. adap-report → `2026-06-21-Governance-harness-15-v2-hot-feed-update.md`.
>
> 🔑 **Cốt-lõi:** ngân-sách bộ-nhớ = **mức TẬN-DỤNG-TỐI-THIỂU phải đạt, KHÔNG phải trần để dè-xẻn.** Tiết-kiệm-token = **quên-việc** (rơi trạng-thái giữa phiên) = KHÔNG tiết-kiệm thật (làm-lại tốn HƠN — cùng họ Goodhart §F.4/§6.6). Khoảng-trống quan-sát hay rơi đúng vào **chính LEAD** (lead tự-nạp kiến-trúc/luật nhưng bỏ quên trạng-thái-công-việc) → §G.2(c) vá đúng chỗ đó.
### G.1 — Mô-hình = SÀN cố-định + 3 tầng được-quản-lý (A1/A2/A3)
- **SÀN-harness (A1, đo-được):** phần cố-định mỗi spawn = tool-schema + framing + persona/role + lead-pasted base-doc-slice + prompt. **SE TỰ đo (KHÔNG mượn số AI_INFRA):** persona đo-thật `.claude/agents/*.md` (4.3KB13.3KB ≈ 1.3K4.0K tok /3.3); tool-schema+framing harness-injected **SE ước-lượng-riêng** (trùng AI_INFRA ~21K vì **cùng-họ-toolset** Read/Write/Edit/Bash/Grep/Glob/Skill/RAG, **KHÔNG mượn-số**) → **floor ≈ 21K measured-estimate → round-up 30K (cap RIÊNG SE)** (`memory-budget.json:harness_floor`). Honest: persona = đo-thật-byte; phần harness-injected = ƯỚC-LƯỢNG (không byte-count cục-bộ được).
- **A3 tách-nhà chống-đếm-trùng:** persona + lead-docs thuộc **SÀN**, KHÔNG đếm vào L1-managed. L1-managed = own agent-memory + archive `_INDEX` + work-state block (`memory-budget.json:harness_floor._note`).
- **3 tầng managed (A2, con-số = lead hard-cap):** L1-always **12K** (MEMORY.md ~8K + `_INDEX` ~2K + work-state ~2K) · L2-ondemand **6K** (verbatim/gist + skill sections) · L3-RAG **4K** (search/query). Headline luôn-nạp = SÀN 30K + L1 12K = **~42K tok/spawn**; L2/L3 phình-theo-nhu-cầu (no context-rot). 🔑 con-số = QUYỀN-CẤP lead, **KHÔNG AI tự suy-diễn xuống** (`token_governor`).
- **3 tầng managed (A2 — cập-nhật v2 §G.4):** Tầng-1 = **HOT-FEED LỚN per-role** (lead ~60K · agent-ký-ức ~20K · agent-workflow ~16K — SE tự-đo-estimate, **KHÔNG** mượn số AI_INFRA 220/60/50; nạp đầy 4 bucket WIP·lỗi-lặp·tồn-đọng·quyết-định-chờ) · L2/L3 **BỎ TRẦN** (on-demand, no artificial tier-cap, chỉ chặn bởi cửa-sổ-ngữ-cảnh model). 🔴 con-số = **quyền CHỦ-DỰ-ÁN (anh)** — em-main THỰC-THI-đúng-số + BÁO-% (KHÔNG tự-tinh-chỉnh), xem §G.4 (`token_governor`).
### G.2 — 6 sàn-CHỨC-NĂNG bắt-buộc (🔴 — map onto SE, honest mechanized-vs-convention)
| Sàn | SE map | Nấc | Cơ-chế-hóa vs quy-ước |
@ -184,6 +186,15 @@ SE đã có RAG golden-set harness (KHÔNG phải gap): `eval/golden-set-solutio
- **Honest nấc tổng:** mechanized = chỉ **(e) 2-config byte+token** + **đo-SÀN** (qua measure script); **5/6 sàn-chức-năng = CONVENTION** (nạp-đầy · cắt-giá-trị · work-state · 3-tệp-chốt = kỷ-luật người+AI). KHÔNG nhận "mechanized" cho kỷ-luật. `value_protect.patterns` = grep-hint DRY-RUN (advisory FLAG), **KHÔNG enforced auto-exclude** (archive-gate giữ DRY-RUN, em-main quyết — D6).
- **token≈byte/3.3** (VN thật; byte/4 = cận-trên → headroom THẬT lớn hơn). Floor = đo-được không-exact (honest-note b). Agent chưa-có-archive (database-agent/investigator-api/...) → phần "`_INDEX` theo ngân-sách" moot với chúng (honest-note d).
### G.4 — Harness-15-v2 delta (S82): Tầng-1 hot-feed LỚN + L2/L3 bỏ-trần + %-print + ranh-giới vai-trò
> Delta chồng lên §G.1-G.3 (gốc KHÔNG đổi). Re-verify CHỈ 2 phần đổi + 1 tool mới. Broadcast `2026-06-20-Governance-harness-15-v2-hot-feed-update` (`supersedes_scope = tier-1-sizing + L2/L3-caps ONLY`).
- **(1) Tầng-1 = HOT-FEED LỚN (🔴 SÀN-kiến-trúc):** phần luôn-nạp phải DÀY (đừng để mỏng) — nạp đầy **4 bucket nội-dung-công-việc**: WIP work-state · lỗi-lặp/anti-pattern/gotcha (`value_protect` §G.2(b), giữ bất-kể tuổi) · tồn-đọng · quyết-định-chờ. Bằng-chứng nền: Tầng-1 mỏng → lead **bỏ quên việc nhiều phiên liên-tiếp** (đúng bệnh H15 chữa). SE tự-đo per-role: lead ~60K · agent-ký-ức ~20K · agent-workflow ~16K (`token_governor.tier1_hotfeed_tokens`) — **estimate, KHÔNG mượn 220/60/50 AI_INFRA** (model+scale khác).
- **(2) L2/L3 BỎ TRẦN (🔴 SÀN-kiến-trúc):** gỡ cap cứng L2=6K/L3=4K → on-demand kéo-về tự-do, **không hạn-mức-tầng nhân-tạo**, chỉ chặn bởi cửa-sổ-ngữ-cảnh model. on-demand nên KHÔNG chiếm-chỗ thường-trực (no always-cost).
- **(3) %-print 2 đầu-phiên (🔴 tool mới):** `session-start §2.1.6` (composition Tầng-1 theo %/bucket) + `session-end §L.b(c)` (% sau-nạp + Headroom). Ước-lượng-tỉ-lệ đủ. **Headroom > 0 mà CÒN nội-dung giá-trị-cao = under-fill (SAI)** → nạp tiếp; Headroom = cờ-báo, KHÔNG phải đích-tiết-kiệm.
- **(4) Ranh-giới vai-trò (🔴 governance):** con-số budget = **quyền CHỦ-DỰ-ÁN (anh)**, KHÔNG phải AI-lead. em-main = (i) thực-thi đúng-số (no-truncate, kéo từng bucket tới target) + (ii) báo-% 2-đầu-phiên cho anh quyết. Sửa framing S81 "lead-authority" (nhầm AI-lead ↔ chủ-dự-án). Cùng tinh-thần mark `RC-…10-29-09` (AI = neo-lý-tính, anh quyết) + report-before-stamp.
- **Honest đánh-đổi (v2 §5):** Tầng-1 lớn = rot CAO HƠN trên phần always-loaded — **chấp-nhận có-chủ-đích** (quên-việc tệ hơn rot), KHÔNG phải "rot biến mất". SÀN = **kiến-trúc** (hot-feed lớn + L2/L3 on-demand), KHÔNG phải con-số. Nấc honest: (1)(2) = config mechanized (`token_governor`) · (3)(4) = **convention** (kỷ-luật người+AI: nạp-đủ + báo-% + anh-quyết-số).
---
## CAVEAT (trung-thực — đọc trước khi tự nhận "đã tự-bảo-trì")