Files
solution-erp/.claude/commands/adap-report.md
pqhuy1987 72bbfa56a5 [CLAUDE] Infra: adopt AI_INFRA adap-* channel + store_memory strip + frontend-designer (S47)
- Install 3 federated adoption slash-commands (/adap-apply|report|request) in .claude/commands/ (read AI_INFRA outbox read-only, apply own repo, write adap-report; AI_INFRA /adap-audit reads cross-repo)
- Broadcast #1 (Memory-store-memory-strip-global): strip store_memory from all 8 sub-agents -> lead = sole RAG-writer; 4 RAG-read retained; agents/README synced + G-015 note
- Broadcast #2 (Agent-frontend-designer-floor): frontend-designer 8th agent (pink) -- forked AI_INFRA canonical FD1-FD10 visual-verification floor, tailored SE stack + use-existing-DS + boundary vs implementer-frontend; memory seed; roster doc 7->8
- Broadcast #3 (Governance-gov-v2): already-applied S44 -- delta report (gap: no formal error-ledger/L.b checklist)
- 3 adap-reports (5-field LOCK) in docs/governance/adap-reports/ + adoption-ledger row
- All nac executed-file/verified-pending (restart + spawn-test). 0 agents spawned. No product code. Test gate 181 unchanged. CI-skip (all .md).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-02 23:34:07 +07:00

4.7 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

📋 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).