solution-erp/docs/governance/adap-reports/2026-06-18-Governance-harness-10-flat-refine-checklist-v2.md

adap-report — Harness-10 flat-refine + checklist-v2 (re-audit + fix) — SE

• id: 2026-06-18-Governance-harness-10-flat-refine-checklist-v2
• from: se · date: 2026-06-18 (S72)
• broadcasts adopted: 2026-06-18-Governance-checklist-harness-9-10-v2 + 2026-06-18-Governance-h10-flat-detector-refine (kèm re-audit fidelity Harness-8/9/10)
• mandate: Harness-9 PART-2 (2-workflow IMPLEMENT + REVIEW tách biệt + run-id) — anh giao "double check hết Harness-8/9/10/10-refine + checklist + hmw, lấy đầy đủ thông tin, điều chỉnh lại, report trung thực".
• run-ids (B3 evidence): audit wf_13868efb-ea7 · implement wf_ac43b5ff-7d1 · review wf_d482e10d-5dd
• reviewer_gate: ✅ PASS sau-fix (R3 PASS + R1/R2 PASS-with-concerns → 1 major + 4 minor TẤT CẢ fixed)

Bối cảnh (trung thực)

Anh chỉ ra SE chưa theo kịp Harness-10 flat-refine ("các project khác làm tốt, mỗi SE thiếu"). SE re-audit toàn bộ qua 3-stage workflow. Baseline đo = canonical spec (ground-truth) — cross-project-status.md đã stale (05-22, RAG Layer A), KHÔNG dùng để "chứng minh sisters ahead" (honest).

Nấc thật per checklist-v2 (đo vs canonical)

PART A — memory L2 (proposal/tailorable): substantially LANDED. A1-A7 + A9 ok (executed-file / runtime / convention-met). A8 (sleep-compress command) ĐÃ port — trước đó SE thiếu (chỉ nén ad-hoc). Watch: frontend-designer + test-specialist sát cap 25.6KB nhưng chưa có archive.

PART B — adap 2-workflow (MANDATORY): LANDED. B1/B2/B2.5/B3 = runtime (chính report này + 3 run-id = bằng chứng). B4 = convention-met (codified adap-apply.md:38, chưa có runtime instance của task-ngắn-cần-confirm).

PART C + refine (MANDATORY): WAS BEHIND → NOW MIGRATED. C1/C8/refine-a: run-trace SUBFOLDER→FLAT done (hmw.js:103 + workflows/README + runs/README + session-start/end + agents/README; 5 run cũ S71 GIỮ subfolder, close-gate dual-accept). C2-C7 ok. refine-b detector: TAILORED-OUT (documented, anh chốt).

Gap found → fixed

gap (audit)	fix	nấc
run-trace subfolder (canonical=flat)	hmw.js + 5 docs → flat; 5 old runs keep subfolder	runtime (node --check OK + 2 new runs flat)
/sleep-recovery-memory-l2 absent (A8)	ported tailored SE-only (137 dòng, floor intact, scope SE)	executed-file + live skill
2 broadcast 06-18 unadopted	adopted (checklist-v2 + h10-refine)	runtime
detector refine-b	tailored-OUT + documented reasoning	convention (honest N/A)
hmw.js meta stale H4.5 two-tier	→ H8 all-inherit (bonus doc-drift)	executed-file
B3 report imprecision (S71)	corrected (path + count, xem dưới)	runtime

Giá trị REVIEW tách biệt (dogfood B2 — mandate đúng)

Workflow REVIEW độc-lập bắt 2 lỗi mà workflow IMPLEMENT tự-chấm bỏ sót:

1. hmw.js:52 — schema subMdPath description còn ghi path cũ sub-md/ (operative path :103 đã flat, nhưng bản-sao path trong schema-desc chưa đổi) → fixed.
2. sleep-cmd auto-check ≥7d trigger UN-WIRED — command tuyên bố session-start/end đọc last_sleep_at nhưng grep cả 2 file = 0 (overclaim) → WIRED thật: memory-budget.json +last_sleep_at + session-start:78 + session-end:48 INFORM step (grep-verified present sau fix).

→ Bằng chứng sống: 1-workflow-tự-chấm SẼ ship 2 lỗi này; review-workflow RIÊNG bắt TRƯỚC commit. PART-2 mandate hoạt động.

Reverse-findings (B2.5) → AI_INFRA

1. rename-migration audit phải grep runtime SCHEMA/contract-description strings, không chỉ code-path + prose. Path hay bị duplicate ở (1) operative var, (2) comment, (3) schema/contract-desc — bản schema-desc dễ sót nhất vì là data không phải code engine đọc. (Bắt được hmw.js:52.)
2. ported-command §-anchor phải grep/ls-verify TRONG sister repo — port re-home path khác nguồn (SE budget ở agent-memory/, design-doc AI_INFRA-only). §-cite = claim "wiring tồn tại ở đây" → phải grep-prove như class 'wire BE' bug, áp cho governance-doc wiring.
3. run-trace path-qualify: SE runs/ ở .claude/workflows/runs/ không phải repo-root → bare git ls-files runs false-0 = kết-luận FALSE "không tracked"; luôn path-qualify + exit-branch check-ignore (negation !.claude/** last-match-wins vô-hình với text-read .gitignore). [chính là bẫy S71 report vấp]
4. Raw Workflow tool KHÔNG mang writeGuard của hmw.js: SE chạy REVIEW qua Workflow tool TRỰC-TIẾP (thay wrapper hmw.js) → KHÔNG inject anti-self-write guard → 1 sub reviewer theo charter "update MEMORY before return" tự ghi agent-memory/reviewer/MEMORY.md (+2850B → 27694 over-cap 25600; nếu N agent cùng-role = same-role-race trên 1 MEMORY). Em-main git-status containment-check post-workflow BẮT → revert (record đã nằm trong run-trace sub-review-*.md; B3 single-writer restored). Bài học: run-trace fan-out PHẢI qua hmw.js (mang writeGuard + return-delta) HOẶC replicate writeGuard trong prompt raw-Workflow. Đúng class mà hmw.js RUN-TRACE writeGuard (S71) sinh ra để chặn — tái phát khi bypass wrapper. (Đề-xuất infra: ghi rõ "raw Workflow tool ≠ project-wrapper governance" trong floor.)

Honest caveats

• Audit Part A auditor (1/4) failed no-StructuredOutput + Part C/H8 truncated → em-main self-gate ground-truth từ đĩa (git/grep/glob), disclosed — valid per feedback_agent_kill_recovery.
• Detector TAILORED-OUT (không build): SE chạy qua Anthropic Workflow tool (KHÔNG có CLI-launcher bypass-surface như node-CLI của AI_INFRA hmw.js); containment = git-diff + run-folder tracked + ledger orphan-scan (G-015). refine nói detector = "chuyện nội bộ mỗi dự án tự quyết". SE KHÔNG claim đã adopt detector — đây là quyết định tailored có lý-lẽ, không phải né.
• B3 self-correction (trung thực): report S71 của SE cite path tắt runs/ + count "14"; thật = .claude/workflows/runs (22 file, "14" đúng tại commit 8c47bd0 rồi tăng lên 22). Folder commit thật; chỉ path-string + count cũ sai → đã sửa.
• Runtime: hmw.js flat node --check PARSE-OK, nhưng RUN-TRACE runtime cần CLI restart để chạy thật (forward-looking — frontmatter/command no hot-reload).

Net

SE parity Harness-10 flat. 0 production code — state THẬT GIỮ NGUYÊN: Mig 53 · 88 bảng · 306 test · 68 gotcha · menu 54 · bundle admin BgNCjwsG/user CBvh0vtf. 3 run-trace folder (audit/implement/review) git-tracked = bằng chứng.

• also-covers-id (enrich @S149, ghi CUỐI file có chủ đích — chèn vào header sẽ dịch số dòng và làm hỏng các cite :33/:46 mà lane khác trong wave đang dùng): file này còn là report của id 2026-06-18-Governance-h10-flat-detector-refine (id đã có sẵn ở dòng :5 nhưng dạng văn xuôi; dòng này là dạng để /adap-audit parse per-id). 🔴 Errata: khoản (b) detector chống-lách-engine khai TAILORED-OUT ở :46 (mục "Detector TAILORED-OUT (không build)") hết hiệu lực từ 2026-07-03 — hub trả lời sàn-chức-năng là BẮT BUỘC, chỉ hình thức mới tự quyết (broadcasts/inbox/ai_infra/2026-07-03-ai_infra-to-se-batch13-ack-stamp-and-answers.md:27-29) — và ĐÃ ĐÓNG @S149 bằng detector C12 - raw-engine-bypass trong scripts/governance-detectors.ps1 (INFORM-only, fault-inject 2 chiều). Dòng :46 giữ nguyên làm vết lịch sử; bản mới thắng.