[CLAUDE] Skill: adopt Harness 7 (writing-quality floor) via adap-apply + email ai_infra

O1/O2/O3 outward-facing writing-quality floor: rules.md s1.1 + reviewer Category 6 (verified-pending-restart) + README Upgrade S64. PROJECT-FIT 6/6 applied fully. adap-report + email se->ai_infra (body-hash 7e4f91f1 self-verified MATCH). Broadcast content_sha256 a4580ea9 verified-MATCH (false-mismatch was local PS5.1 UTF-8 mis-decode gotcha #61 - NOT mis-stamp).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
pqhuy1987
2026-06-15 22:17:38 +07:00
parent 8e3c360411
commit 6afde19f9c
6 changed files with 106 additions and 1 deletions

View File

@ -0,0 +1,41 @@
# 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).

View File

@ -14,6 +14,15 @@
| Commit message | English hoặc Việt — preferred English |
| Doc MD (docs/) | **Tiếng Việt** (audience là người Việt) |
### 1.1 Chất lượng viết — hướng ra ngoài vs nội bộ (Harness-7, adopt S64 2026-06-15)
> Adopt từ AI_INFRA broadcast `2026-06-15-Governance-harness-7-writing-quality` (body-hash `a4580ea9…` đã verify khớp). Đây là **sàn chất lượng văn bản**, chỉ áp cho **văn xuôi** và chỉ cho phần **hướng ra ngoài**. Sàn chỉ được nâng, không được hạ; không mâu thuẫn quyền tự quyết hình thức (bảng/văn xuôi/độ dài/emoji/tên mục).
- **O1 — 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.** Bốn nhóm "hướng ra ngoài": ① nội dung email cross-project (`/send-email`, `/check-email`); ② broadcast và adap-report gửi AI_INFRA (`broadcasts/outbox/`, `docs/governance/adap-reports/`); ③ tài liệu chia sẻ cho sister; ④ **câu trả lời của em main (lead) gửi cho anh trong hội thoại**. Viết để người đọc hiểu trọn ý ngay, không viết kiểu điện tín cụt ngủn.
- **O2 — Ranh giới bất đối xứng (KHÔNG áp vào nội bộ).** Phần nội bộ — `docs/STATUS.md`, `docs/HANDOFF.md`, `docs/gotchas.md`, agent-memory (`.claude/agent-memory/`), spawn-record, `error-ledger.md`, suy luận nội bộ — **giữ lối viết nén** theo §6.4 và §6.5 (KEEP-vs-CUT), miễn là vẫn rõ nghĩa, đúng chính tả và không lỗi mã hóa (mojibake). Lý do bất đối xứng: hướng ra ngoài cần người ngoài hiểu trọn, còn nội bộ cần gọn để chống loãng context.
- **O3 — Thực thi = cổng reviewer hướng ra ngoài + tự kiểm.** Reviewer thêm trục "chất lượng viết" {câu hoàn chỉnh · dấu câu · ngữ pháp · rõ nghĩa} khi review nội dung hướng ra ngoài (xem `.claude/agents/reviewer.md` Category 6). Em main tự đọc lại một lượt trước khi gửi email, adap-report, hoặc trả lời anh, bảo đảm từng câu đứng vững một mình.
- **Token kỹ thuật giữ nguyên:** đường dẫn file, tham chiếu `§`, định danh, mã hash, đoạn code, tên riêng tiếng Anh — KHÔNG dịch. Luật chỉ áp cho câu và đoạn văn xuôi.
## 2. Backend — .NET 10
### 2.1 Clean Architecture dependency rule