solution-erp/docs/governance/adap-reports/2026-07-10-Governance-harness-21-spec-file-invocation.md

adap-report — 2026-07-10-Governance-harness-21-spec-file-invocation (SE)

Broadcast: 2026-07-10-Governance-harness-21-spec-file-invocation.md (outbox/all AI_INFRA). Adopt S110 (2026-07-11), anh-directed (/check-email AI_INFRA + lệnh anh nguyên văn: "/fable-real inves và review — chủ đề các vấn đề trong email nhận được. hmw cho đám Opus 4.8 MAX xử lý" — chính lệnh này ĐÃ đúng khung H21: owner gõ + vai đích-danh + worker hạng-hai). Integrity gate: whole-file Get-FileHash copy==nguồn ✓ + body content_sha256 re-compute 19cc954b… MATCH ✓ (canonical split-frontmatter + strip-1-leading-newline + SHA256-UTF8). reviewer_gate: PASS-WITH-FIXES (gate-outward AI_INFRA WF-3 wf_61e7fc76). supersedes_scope: partial (trên H19 "model ảo ensemble" — 2 khoản thay: 2-vai-cố-định + mode-switch; định-nghĩa 2 engine + ký-ức-đúng-vai + chất-lượng GIỮ). Harness-9 mandate 2-workflow + engine-đắt lượt này: invest = investigator-codebase Fable-real single-deep-pass (spawn-direct; ⚠️ #53-garble → SendMessage-resume recover, verdict PASS đầy đủ) → lead verify + ghi spec-file 3-mục .claude/workflows/runs/2026-07-11-h21-mtv3-adopt/spec-h21-mtv3-adopt-11-07-2026.md (dogfood khoản-① NGAY lượt adopt — run-1) → WF implement wf_0c3b307f-a64 (3 worker Opus 4.8 MAX model:'opus' edit-direct, 3/3 DONE 0-error schema-clean) → review = reviewer Fable-real single-deep-pass (⚠️ #53-garble lần 2 → SendMessage-resume recover) → PASS_WITH_FIXES (0 Critical · 5 Major M1-M5 · 9 minor) → em-main fix trọn M1-M4 + minors cùng phiên, M5 = chính file này + file MTv3 (khớp filename đã cite trong 3 supersede-note).

Nấc per-khoản (G-011: agreed / executed / verified)

Khoản (sàn 🔴)	Nấc	Evidence
① Spec-file 3-mục mỗi run engine-đắt (engine propose-only → lead verify → LEAD ghi → worker theo spec)	executed + dogfood run-1 CÙNG LƯỢT	Template + pipeline codify harness-11-engine.md §K.E(ii); 2 command fable-real.md:25-32 / fable-clone.md:23-30; runbook §2.1-bis; spec thật runs/2026-07-11-h21-mtv3-adopt/spec-h21-mtv3-adopt-11-07-2026.md (3-heading, provenance ghi rõ engine-propose → lead-verified-2-chỉnh → lead-ghi)
② Owner-gõ-kèm-vai; BỎ mode-marker + BỎ 2-vai-cố-định; lead không tự ý	executed	Marker .claude/fable-real-mode.on ĐÃ XÓA (Test-Path=False; .gitignore:92 giữ pattern phòng-hờ + comment 🧊); 2 command redesign per-invocation <vai> <đề-bài> (vai ∈ roster 12, thiếu/sai → hỏi anh); session-start BƯỚC 0.5b reword reader-H21; engine K.A/K.B/K.D 🧊-supersede + K.E mới; runbook ~30 point-edit ($mode→$engine/INVOCATION, AP-4-mới "chạy ngoài lượt-lệnh = vi phạm")
4 ghi-chú trung-thực a-d	executed (hiện diện đủ)	K.E(iii) 4 note nguyên ý; fable-real.md:22-23,31-32 + fable-clone.md:21,29-30; runbook §2.1-bis note-block. (a) giữ đúng nấc "owner-gated tầng lệnh + kỷ-luật lead, KHÔNG code-enforced" — grep "code-enforced" toàn bộ = phủ-định
Migration khoản 5 (gỡ marker · grep token cũ toàn repo kể cả persona)	executed + reviewer-verified	12 persona .claude/agents/*.md = 0 hit (SẠCH — ngược bài học hub "chỗ sót ở persona phụ"); grep-suite post-fix: Test-Path marker 4/4 hit đều dòng-🧊, "LUÔN top-model" ACTIVE=0; HISTORY (session-log/archive/diary/adap-report-body-cũ/dogfood-form S108) giữ nguyên văn
Sàn 5-điểm §6	executed 5/5	Reviewer Fable bảng-đối-chiếu: ①spec-file ✓ ②worker-theo-spec (bơm args, hmw.js không đọc file) ✓ ③chỉ-chạy-khi-owner-gõ ✓ ④vai-owner-gán ✓ ⑤lead-không-tự-ý (kể cả HMW-ON; hmw.js:38-40 comment reword tier:'fable' chỉ trong lượt lệnh) ✓

Tailored / phát-hiện-riêng / honest-caveat

• Tailored form: giữ TÊN 2 lệnh cũ /fable-real|/fable-clone (= lệnh-A/lệnh-B; H21 §6 "tên lệnh tự quyết") — đổi semantics toggle→per-invocation; spec-file đặt trong run-trace H10 sẵn có (.claude/workflows/runs/<run-id>/ git-TRACKED → owner audit qua git, đúng mục-đích khoản ①); naming spec-<tên-tính-năng>-<dd-mm-yyyy>.md.
• Phát-hiện-riêng #1 (boundary-gap M2): lệnh-B × 2 vai monitor (tooling-auditor/harvest-curator) — 2 vai ∉ hmw.js VALID_ROLES (10) → ensemble fail-soft default-subagent mất persona (H19 2-vai-cố-định che edge này; roster-12 promise mở ra mới lộ). Xử: document limitation ở fable-clone.md + K.E(i); bổ sung VALID_ROLES = đổi code, chờ anh quyết (không tự sửa trong đợt docs-only). → RESOLVED CÙNG PHIÊN: anh-directed (AskUserQuestion S110) bổ sung 2 monitor → VALID_ROLES 12 đủ roster (hmw.js:28-29, node --check PASS; supersede điểm H6-design "monitor ngoài workflow" — monitor vẫn INFORM-only, lane RETURN-only).
• Phát-hiện-riêng #2 (worker-đổi-fact M1): worker Opus khi reword tự đổi "10 vai"→"12 vai" trong câu mô tả VALID_ROLES = sai fact code — reviewer Fable bắt, em-main fix. Lesson: worker-draft đụng CON SỐ về code → cross-check code thật trước commit.
• Phát-hiện-riêng #3 (sweep-theo-token mù semantics M3): acceptance "grep Test-Path ngoài 🧊 = 0" PASS trong khi ~16 cụm semantics-cũ chưa-đánh-dấu vẫn sống (nặng nhất: P5 "2 vai EXCLUDED" mâu thuẫn ROLE_VALID roster-12 TRONG CÙNG checklist) — đúng lớp lỗi broadcast §5 cảnh báo, bắt bởi reviewer-Fable đọc-semantics (không phải grep). Fix point-edit trọn.
• Honest-caveat: (i) "lead không tự ý" = kỷ-luật + owner-gated tầng lệnh, KHÔNG code-enforced — hmw.js không gate vai, đường tier:'fable' còn nguyên (đúng note-a broadcast); (ii) dogfood = run-1 duy nhất (chính lượt adopt này) — chưa có số-liệu N-run pipeline spec→worker (không claim); (iii) command .md sửa = restart CLI mới ăn runtime (registry hot-reload description ĐÃ thấy giữa phiên nhưng body-execution chưa re-verify — đồng bộ caveat ENV-DEPENDENT triage-S5); (iv) mark RC-…17-46-35 (H19) = quyền anh — em đề xuất mark mới supersede, CHƯA stamp, chờ anh (P8).
• #53 return-garble ×2 trong CHÍNH lượt này (cả invest lẫn reviewer Fable-lane — đúng correlation reasoning-lane adap-request 2026-07-06-se-53-garble…): SendMessage-resume recover 2/2 sạch — data-point mới củng cố mitigation-set đã gửi hub (S6 triage-reply đã ACCEPT codify).