solution-erp/docs/governance/adap-reports/2026-06-15-Governance-harness-7-writing-quality.md

# adap-report — 2026-06-15-Governance-harness-7-writing-quality

> SISTER = SOLUTION_ERP. Report-format LOCK (5 trường). Tạo ở S64 (2026-06-15), áp bởi em main solo (governance authoring là single-writer, đúng tinh thần H6.1 "trivial/governance → solo"). Báo cáo này tự nó là nội dung hướng ra ngoài, nên được viết theo đúng luật Harness-7 mà nó đang adopt.

## 1. id-broadcast

`2026-06-15-Governance-harness-7-writing-quality` (from: ai_infra · category: **Governance** · reviewer_gate: **PASS_WITH_FIXES** — 0C/2M/2m, tất cả fix đã áp pre-publish · nac: published · targets: **all-fit** · content_sha256 `a4580ea9…` đã verify khớp). Nội dung broadcast: một sàn chất lượng văn bản cho phần **hướng ra ngoài**, gồm ba điều khoản — **O1** mọi giao tiếp hướng ra ngoài phải viết tiếng Việt rõ nghĩa, câu hoàn chỉnh, đủ dấu câu, đúng ngữ pháp; **O2** ranh giới bất đối xứng, phần nội bộ vẫn giữ lối viết nén; **O3** thực thi qua cổng reviewer hướng ra ngoài cộng với việc tự đọc lại trước khi gửi.

## 2. nac G-011

**EXECUTED-FILE** cho phần ghi rule và wiring reviewer · **VERIFIED-LIVE ngay session này** cho phần lead tự kiểm · **VERIFIED-PENDING-RESTART** cho phần reviewer thực thi.

- **O1 + O2 (rule canonical)** = EXECUTED-FILE: luật đã ghi vào `docs/rules.md §1.1`, nêu rõ phạm vi chỉ hướng ra ngoài và ranh giới bất đối xứng với phần nội bộ.
- **O3 (cổng reviewer)** = EXECUTED-FILE → VERIFIED-PENDING-RESTART: đã thêm Category 6 vào `.claude/agents/reviewer.md`, nhưng agent `.md` không hot-reload nên reviewer chỉ thực thi trục mới sau khi restart CLI và được spawn cho một target hướng ra ngoài.
- **O1 (lead tự kiểm)** = VERIFIED-LIVE session này: em main đã viết các phản hồi cho anh, adap-report này, và email báo cáo AI_INFRA theo đúng chuẩn câu hoàn chỉnh — đây là phần thực thi quan sát được ngay, không chờ restart.

## 3. evidence

- **Rule canonical:** `docs/rules.md §1.1 "Chất lượng viết — hướng ra ngoài vs nội bộ"` (O1/O2/O3 + điều khoản giữ nguyên token kỹ thuật).
- **Reviewer gate:** `.claude/agents/reviewer.md` — thêm `Category 6 — Writing quality (outward-facing content ONLY)` (4 trục: câu hoàn chỉnh · dấu câu · ngữ pháp · rõ nghĩa), cập nhật dòng "Apply ALL categories" thành có điều kiện, và thêm một dòng vào bảng Report format.
- **Lineage doc:** `.claude/agents/README.md` — thêm dòng "Upgrade S64 (Harness-7 writing-quality adopt)".
- **Hash verify:** recompute `SHA256(body)` của broadcast = `a4580ea9f60a062d41d21fa3da7c8703660a73ab6d856e7d839f4cbda91b269c`, khớp đúng `content_sha256` khai báo → nội dung xác thực, không bị sửa.
- **SELF-CHECK của broadcast (5 mục) đều thỏa:** rule ghi vào nguồn canonical với phạm vi outward-only ✓ · cổng reviewer thêm trục chất lượng viết ✓ · hiểu rõ ranh giới bất đối xứng (nội bộ giữ nén theo §6.4/§6.5) ✓ · token kỹ thuật giữ nguyên ✓ · không hạ sàn nào đang có (add-only) ✓.

## 4. tailored-gì + skip-gì-vì-sao

- **FUNCTION-floor adopt ĐẦY ĐỦ:** O1, O2, O3 đều áp, không cắt giảm.
- **FORM tailored cho roster và doc thật của SE:**
  - Tham chiếu `§F1` của AI_INFRA (quy ước viết nén nội bộ) được ánh xạ sang nguồn tương đương của SE là **`docs/rules.md §6.4` (audit + compact định kỳ) và `§6.5` (consolidate KEEP-vs-CUT)** — đây chính là kỷ luật viết nén nội bộ của SE.
  - Bốn nhóm "hướng ra ngoài" được cụ thể hóa bằng đường dẫn thật của SE: `broadcasts/outbox/` cho email và broadcast, `docs/governance/adap-reports/` cho adap-report, và hội thoại của em main với anh.
  - Cổng reviewer (O3) gắn vào agent `reviewer` có sẵn trong roster 11-agent, dưới dạng một Category **có điều kiện** (chỉ kích hoạt khi target gồm nội dung hướng ra ngoài), để không can thiệp các lần review code thuần.
- **SKIP / n-a: không có.** PROJECT-FIT của broadcast là 6/6, và SOLUTION_ERP giao tiếp với anh hằng ngày cộng với gửi email cho các sister, nên luật áp trọn vẹn, không phần nào là n-a.

## 5. honest-caveat

- **Phần reviewer thực thi (O3) còn ở mức verified-pending-restart.** File đã sửa xong, nhưng vì agent `.md` không hot-reload nên trong chính session này reviewer chưa chạy với Category 6. Sẽ lên mức verified khi restart và spawn reviewer cho một target hướng ra ngoài.
- **Về chữ ký body-hash — một đính chính trung thực:** lần verify đầu của em báo "mismatch", nhưng nguyên nhân là **lỗi của chính em**, không phải AI_INFRA mis-stamp. PowerShell 5.1 đọc file UTF-8-no-BOM bằng encoding mặc định Windows-1252 nên giải mã sai ký tự tiếng Việt (đúng họ gotcha #61), khiến hash tính trên chuỗi đã hỏng. Sau khi đọc lại bằng UTF-8 tường minh, hash khớp tuyệt đối. Vì vậy **không có mis-stamp và không có tamper để báo** — khác với adap-request S63 về `eol=lf` (đó là một lớp lỗi cross-checkout có thật). Bài học cục bộ: khi verify body-hash trên Windows phải đọc UTF-8 tường minh, không tin `Get-Content` mặc định.
- **Đây là một sàn chất lượng, chỉ thêm chứ không bớt.** Harness-7 không hạ quyền tự quyết hình thức (§F4) và không hạ bất kỳ cổng nào đang có; Smart-Friend guard của reviewer vẫn nguyên.
- **Phần "lead tự kiểm" là một sàn hành vi, không phải automation cứng.** Em main thực thi bằng nếp đọc lại một lượt trước khi gửi, chứ không phải một cơ chế tự động chặn.

— se (em main, S64 2026-06-15, đang chạy Opus 4.8 (1M) do H5 fallback). Gate: **em main self-gate** (governance doc-work, low-risk, đã grep-verify các edit đã landed) — đúng precedent S56/H4 và đúng tinh thần H6.1 (governance authoring là single-writer, không fan-out).