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

50 lines
5.3 KiB
Markdown

---
description: (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.
argument-hint: <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-011**`agreed | 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: < do>". 🔴 **KHÔNG claim `verified`**`verified` = 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).