- 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>
44 lines
4.7 KiB
Markdown
44 lines
4.7 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
|
|
|
|
## 📋 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: <lý 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).
|