Files
solution-erp/.claude/commands/adap-report.md
pqhuy1987 a3776eaac4 [CLAUDE] Docs: thi hanh tron plan adap dot-2 (P2/P3/P5/P7i + W4 + khoan 5/6)
Chu du an chot 6 cau @S181; so quyet-dinh o
runs/2026-08-07-S180-adap-upgrade-pack-phased/owner-decisions-07-08-2026-dot-2.md

- P2=PB-2 sua luat da ratify du 2 SITE (tiep.md §3-bis canonical + pause.md
  b6 chi TRO). Cau cam san-3 GIU NGUYEN, chi them ranh REQUEST ⟂ TASK.
- W4: docs/governance/so-yeu-cau-chu-du-an.md 3 khoi, ma YC/ST/PN vinh vien.
  Config: tiep_reload.sources 8->9 + owner_request_verbatim_char_cap.
  nhip-no-probe ve-5 "so-yc treo/nhac2+", fault-inject 5/5, phan biet
  chua-co-du-lieu ⟂ treo 0. Ky luat ghi-NGAY + A5 cam CLAUDE.md + rules.md §6.0.
- P5: ACTIVE-MARKS §LT3 luat tu-tri 3 bac + mark RC-...-07-08-2026-20-57-48.
- P7(i): docs/governance/expensive-runs-view.md derive-view 5 cot.
- P3=B: niem phong _sealed_P3B_S181 (forward-only). Phep thu A10 da co rang
  (fault-inject: class tu che => exit 2; class hop le => exit 0).
- Khoan 6: scripts/naming-baseline.json = NGUON, script chi doc.
  Fault-inject 6/6 hai chieu. 7/7 baseline xanh. 0 byte non-ASCII.
- Khoan 5: broadcasts/_index.md +cot "ap" cuoi hang, backfill 42/4/23 = 69.
- W3 acceptance 6/6 dong + va defect con-tro bang-19-cua (view-stale-status).

Con treo: P8/W4b, W5, P7 ve (ii), VK-5, P3 hoi-to hay forward-only.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-07 21:25:50 +07:00

5.3 KiB

description, argument-hint
description argument-hint
(SISTER-side) Tổng hợp adoption-state repo MÌNH qua các broadcast đã applied → ghi/update docs/governance/adap-reports/<id>.md theo REPORT-FORMAT LOCK (nấc G-011 + evidence + tailored/skip + honest-caveat). AI_INFRA /adap-audit đọc cross-repo. KHÔNG copy-paste. <id | all-applied>

/adap-report — formalize adoption-state (SISTER-side)

Cặp AI_INFRA-side /adap-audit ( Đợt 2). Chạy TRONG session sister (hoặc auto ở /session-end bước report — TRƯỚC khi sister tự-broadcast). Đồng-bộ-hoá kết quả /adap-apply thành report chuẩn để AI_INFRA verify cross-repo. Protocol: AI_INFRA broadcasts/README.md. Install 1 lần/sister (bootstrap): copy file này → <SISTER-repo>\.claude\commands\adap-report.md (vd D:\Dropbox\CONG_VIEC\BENHVIEN_A_AU\SOURCE_CODDE\.claude\commands\). 🔴 Restart Claude Code / /reload-skills sau copy (command .md no hot-reload). Sau đó self-sustaining, KHÔNG copy-paste nữa.

ID/scope: $ARGUMENTS

BƯỚC 0 — TIỀN KIỂM ĐẦU CỬA (chỉ đọc, chi phí ~0, KHÔNG chặn)

🔴 Chạy TRƯỚC mọi việc khác: powershell.exe -ExecutionPolicy Bypass -File scripts/tien-kiem-cua.ps1 -Cua adap-report → in 1 dòng TIEN-KIEM: …. 🔴 KHÔNG CHẶN — lỗi ⇒ tien-kiem loi (khong chan) → đi tiếp; máy luôn exit 0 (cổng chặn = W3b, chưa chốt). 🔸 Chọn cửa bằng dấu thời gian TRONG tệp, không tin mtime. THIEU-TAP = 0/2 nguồn đọc được, cấm đọc thành "sạch". Nhãn bước lệch: docs/governance/ritual-labels.md.

📋 REPORT-FORMAT (LOCK — khớp /adap-audit reader)

Mỗi report docs/governance/adap-reports/<id>.md (1 file/broadcast) gồm đúng 5 trường:

  1. id-broadcast<date>-<category>-<slug> (khớp outbox AI_INFRA).
  2. nac G-011agreed | executed | verified-pending | n-a (crosswalk: applied ≈ executed; verified = sau AI_INFRA audit, KHÔNG tự khai).
  3. evidence — commit-sha · file path · byte/dòng đổi (đo THẬT, KHÔNG ước).
  4. tailored-gì + skip-gì-vì-sao — FORM bạn đổi (giữ FUNCTION-floor) + phần SKIP=n-a + lý do project-fit.
  5. honest-caveat — restart/spawn-test pending? unpushed (git server down)? ghi rõ (§C5 no-fake).

Flow (lead sister)

  1. Quét applied: liệt kê docs/governance/adap-reports/*.md của repo MÌNH (do /adap-apply tạo). $ARGUMENTS=all-applied → mọi report; <id> → đúng cái đó.
    • Cold-start: chưa có adap-reports/ ⇒ chưa apply broadcast nào → báo "0 applied", dừng (chạy /adap-apply trước).
  2. Mỗi broadcast — tổng hợp adoption-state THẬT (đọc repo MÌNH, KHÔNG đoán):
    • đối chiếu FUNCTION-floor của broadcast (đọc lại outbox AI_INFRA read-only nếu cần) vs cái đã áp trong repo bạn.
    • đo evidence thật: git log lấy commit-sha · file path đã đổi · byte/dòng (đo, đừng khai khống).
    • xác định nấc G-011 đúng (xem bước 3).
  3. Chấm nấc G-011 (no-fake §C5):
    • agreed — đã quyết áp, CHƯA chạm file.
    • executed — đã sửa file/commit (FUNCTION-floor in repo), runtime CHƯA chứng (agent/command .md no hot-reload).
    • verified-pending — executed RỒI nhưng chờ restart/spawn-test mới runtime-proven HOẶC unpushed (git server down) → ghi rõ "VERIFIED-pending: <lý do>". 🔴 KHÔNG claim verifiedverified = AI_INFRA /adap-audit chấm cross-repo (rung 2-way), KHÔNG phải bạn tự phong.
    • n-a — SKIP vì PROJECT-FIT không hợp (KHÔNG phải behind) → ghi lý do.
  4. Ghi/update report vào repo MÌNH docs/governance/adap-reports/<id>.md theo REPORT-FORMAT LOCK (5 trường trên). Idempotent: re-run → update file cũ (cùng id), KHÔNG tạo trùng. Nếu /adap-apply đã ghi sơ → enrich đủ 5 trường (đừng ghi đè mất evidence cũ; bổ sung nấc + caveat).
  5. Đề-xuất/phản-biện (brutal-honest, §M): chỗ không-fit hoặc đề nghị nâng cấp KHUNG → ghi vào trường honest-caveat của report (lý lẽ + bằng chứng). /adap-request Đợt 2 — tạm gộp ở đây.
  6. Log COMMS-LEDGER (đối xứng): cập nhật ledger sister phía bạn (nấc + id). AI_INFRA /adap-audit đọc report cross-repo (read-only) → verify → nâng nấc verified ở phía AI_INFRA. KHÔNG cần copy-paste report về AI_INFRA.

🔴 Guard

  • CHỈ ghi repo MÌNH (§J2): report + COMMS-LEDGER của bạn. Đọc outbox AI_INFRA = read-only.
  • No-fake nấc (§C5): chưa restart/spawn-test → verified-pending, KHÔNG verified. Evidence đo THẬT (commit/byte), cấm khai khống.
  • Roster-AGNOSTIC (G-014): mô tả FORM theo roster của bạn (số sub/topology tùy bạn) — KHÔNG hardcode 4/7/8 hay tên-sub của project khác.
  • Accuracy (G-015): mô tả enforcement KHÔNG overclaim ("read-only" v.v.) — giữ nguyên câu chữ đúng từ broadcast.
  • Format-LOCK: đủ 5 trường để /adap-audit parse được; thiếu trường = report fail audit.
  • Corruption-clean: ghi report bằng tool ghi-file (KHÔNG shell-append).