[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>
This commit is contained in:
35
.claude/commands/adap-apply.md
Normal file
35
.claude/commands/adap-apply.md
Normal file
@ -0,0 +1,35 @@
|
||||
---
|
||||
description: (SISTER-side) Đọc outbox AI_INFRA → áp KHUNG/pattern vào repo MÌNH (tailor form, giữ function-floor) → self-check → ghi adap-report. KHÔNG copy-paste. Federated KHUNG.
|
||||
argument-hint: <id | all-pending>
|
||||
---
|
||||
|
||||
# /adap-apply — nhận + áp pattern (SISTER-side)
|
||||
|
||||
> Cặp AI_INFRA-side `/adap-broadcast`. Chạy TRONG session sister. Đọc outbox AI_INFRA (filesystem/Dropbox), áp vào repo MÌNH. Protocol: AI_INFRA `broadcasts/README.md`.
|
||||
> **Install 1 lần/sister (bootstrap):** copy file này → `<SISTER-repo>\.claude\commands\adap-apply.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/topic:** $ARGUMENTS
|
||||
|
||||
## Flow (lead sister)
|
||||
1. **Đọc outbox AI_INFRA:** `D:\Dropbox\CONG_VIEC\AI_INFRA\broadcasts\outbox\*.md` *(base path configurable — AI_INFRA đổi path/web-migration thì sửa 1 dòng này)*. Fallback chi tiết canonical: `cross_project_search`.
|
||||
2. **Filter — broadcast `targets` gồm project này (hoặc `all-fit`) VÀ chưa-applied:**
|
||||
- **Dedup key:** tồn tại `docs/governance/adap-reports/<id>.md` ⇒ ĐÃ xử → **skip**.
|
||||
- **Cold-start:** folder `adap-reports/` chưa có ⇒ **tạo folder** + coi **mọi broadcast = chưa-applied** (lần đầu).
|
||||
- **verified-pending** vẫn = đã-applied (KHÔNG áp lại, chỉ chờ verify).
|
||||
- **`reviewer_gate ≠ PASS` ⇒ skip** (KHÔNG áp broadcast chưa qua gate).
|
||||
- `$ARGUMENTS=all-pending` → mọi cái chưa-applied; `<id>` → đúng cái đó.
|
||||
3. **Mỗi broadcast:**
|
||||
- đọc **PROJECT-FIT** → không hợp (vd `Agent`-instance "FE-designer floor" mà project KHÔNG có FE) → **SKIP = n-a** (ghi report n-a, KHÔNG phải behind).
|
||||
- else **áp FUNCTION-floor** (BẮT BUỘC) vào repo MÌNH; **tailor FORM** theo **roster THẬT của bạn** (§F4 — số sub/topology tùy bạn); quality-floor → **add-only-increase** (§F4.1, KHÔNG hạ 1 điểm floor).
|
||||
- chạy **SELF-CHECK** của broadcast.
|
||||
4. **Honest (§C5):** KHÔNG fake. Cần restart/spawn-test (agent/command `.md` no hot-reload) → nấc = **executed, VERIFIED-pending**, ghi rõ — đừng claim verified.
|
||||
5. **Ghi adap-report** vào repo MÌNH: `docs/governance/adap-reports/<id>.md`:
|
||||
- nấc **G-011** (agreed / executed / verified-pending) + **evidence** (commit/file/byte) + **tailored-gì / skip-gì-vì-sao**.
|
||||
- AI_INFRA `/adap-audit` *(⏳ Đợt 2)* đọc cross-repo (read-only) → verify 2-way. *(KHÔNG cần copy-paste report về.)*
|
||||
6. **Brutal-honest welcome:** chỗ nào không-fit → phản biện qua adap-report (lý lẽ + bằng chứng, §M). Đề xuất nâng cấp → `/adap-request` *(⏳ Đợt 2 — tạm ghi vào adap-report)*.
|
||||
|
||||
## 🔴 Guard
|
||||
- **CHỈ ghi repo MÌNH.** Đọc outbox AI_INFRA = read-only (KHÔNG sửa).
|
||||
- **Function-floor BẮT BUỘC · form tự do · quality chỉ-tăng** (§F4.1). KHÔNG hạ floor (= vi phạm §A1).
|
||||
- **Roster-AGNOSTIC:** map vào roster THẬT của project (KHÔNG giả định 4/7/8 của ai khác).
|
||||
- **Accuracy (G-015):** khi áp pattern enforcement, KHÔNG overclaim ("read-only" v.v.) — giữ nguyên câu chữ đúng từ broadcast.
|
||||
43
.claude/commands/adap-report.md
Normal file
43
.claude/commands/adap-report.md
Normal file
@ -0,0 +1,43 @@
|
||||
---
|
||||
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).
|
||||
43
.claude/commands/adap-request.md
Normal file
43
.claude/commands/adap-request.md
Normal file
@ -0,0 +1,43 @@
|
||||
---
|
||||
description: (SISTER-side) Sister đề-xuất nâng-cấp infra NGƯỢC lên AI_INFRA (phát hiện flaw / propose pattern mới) → ghi adap-requests/<id>.md repo MÌNH → tự classify (infra/product/out-of-scope). §M-gated (chỉ hợp lệ khi có lý-lẽ + bằng-chứng). KHÔNG copy-paste. Federated KHUNG.
|
||||
argument-hint: <proposal | flaw-id>
|
||||
---
|
||||
|
||||
# /adap-request — đề-xuất nâng-cấp infra (SISTER-side, chiều NGƯỢC)
|
||||
|
||||
> Chiều **NGƯỢC** của `/adap-broadcast`: sister phát hiện flaw / nghĩ ra pattern tốt hơn → đề-xuất lên AI_INFRA (em main eval → có thể thành `/adap-update` hoặc `/adap-broadcast` mới = **vòng nâng-cấp**). Cặp AI_INFRA-side `/adap-audit` (đọc cross-repo) + `/adap-update`. Protocol: AI_INFRA `broadcasts/README.md`.
|
||||
> **Charter v2 §1.1:** em main AI_INFRA **quyết cơ chế infra**; sister **phản biện project-fit** + đề-xuất ngược. Đây là kênh chính-thức cho "phản biện project-fit" + "propose nâng-cấp" — KHÔNG phải override (anh phân xử khi conflict).
|
||||
> **Install 1 lần/sister (bootstrap):** copy file này → `<SISTER-repo>\.claude\commands\adap-request.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.
|
||||
|
||||
**Proposal:** $ARGUMENTS
|
||||
|
||||
## Flow (lead sister)
|
||||
|
||||
1. **Gather đề-xuất:** `$ARGUMENTS` = 1 proposal (vd "FUNCTION-floor X làm khó project vì Y", "pattern Z tốt hơn cho RAG chunk", "broadcast `<id>` có flaw"). Nguồn: flaw gặp khi `/adap-apply`, gotcha dogfood repo mình, ý tưởng cải tiến.
|
||||
2. **§M-GATE (🔴 BẮT BUỘC — `docs/governance/CANONICAL-RULES.md` §M1):** đề-xuất **CHỈ hợp lệ khi đủ `{lý-lẽ + bằng-chứng}`**. Thiếu 1 trong 2 = **im** (chống cãi-suông VÀ chống cave-vô-căn-cứ).
|
||||
- **Lý-lẽ:** vì sao pattern hiện tại sai/thiếu, hoặc đề-xuất tốt hơn ở điểm nào.
|
||||
- **Bằng-chứng:** commit/file/byte/log/eval-number/repro cụ thể repo MÌNH (vd "áp floor X → broke build, log `…`"; "pattern Z recall@5 +12% trên golden-set mình"). KHÔNG bằng-chứng → đừng gửi (ghi nhận nội bộ, dogfood thêm).
|
||||
- **Tách authority ↔ correctness:** correctness = đúng/sai theo bằng-chứng (không theo "ai nói"); authority cuối = anh phân xử khi conflict. Brutal-honest **welcome**.
|
||||
3. **Tự classify scope** (sister phán-đoán project-fit, em main quyết cuối):
|
||||
- **`infra-scope`** — đụng cơ chế infra dùng-chung (RAG pipeline / MCP / governance KHUNG / agent-orchestration pattern / skill / broadcast format). → AI_INFRA eval, có thể thành `/adap-update` (delta) hoặc `/adap-broadcast` (pattern mới) cho cả roster.
|
||||
- **`product`** — chỉ ảnh hưởng code/BE/FE/DB/business repo MÌNH. → **KHÔNG cần adap-request**; tự quyết trong project (sister tự chủ product, charter v2). Ghi để khỏi nhầm gửi.
|
||||
- **`out-of-scope`** — không thuộc infra AI lẫn product (vd hạ tầng máy/VPN). → note + route đúng nơi, KHÔNG file request.
|
||||
- *(Phán-đoán ban đầu thôi — em main AI_INFRA re-classify khi eval; sai scope KHÔNG sao, em main route lại.)*
|
||||
4. **Honest (§C5):** KHÔNG fake. Đề-xuất MỚI = nấc **agreed** (mới gửi, chưa ai eval) — đừng claim đã-adopt. Nếu cần restart/spawn-test để chứng minh repro (agent/command `.md` no hot-reload) → ghi **verified-pending** + nói rõ caveat.
|
||||
5. **Ghi adap-request** vào repo MÌNH: `docs/governance/adap-requests/<id>.md` (folder chưa có ⇒ tạo). `<id>` = `<YYYY-MM-DD>-<category>-<slug>` (category roster-AGNOSTIC: Governance|Agent|Memory|Rag|Mcp|Cmd|Skill). Nội dung:
|
||||
- **id** + **classify** (infra-scope / product / out-of-scope) + **target broadcast** (nếu phản-biện 1 broadcast cụ thể: ghi id của nó; nếu propose mới: `new`).
|
||||
- **lý-lẽ** + **bằng-chứng** (commit/file/byte/log/eval — §M).
|
||||
- **đề-xuất cụ thể:** đổi gì / thêm gì (delta nếu sửa pattern cũ; spec nếu pattern mới).
|
||||
- **nấc G-011:** `agreed` (mặc định đề-xuất mới) hoặc `verified-pending` (cần restart chứng minh) — KHÔNG claim `executed`/`verified` (việc đó là của AI_INFRA sau khi adopt).
|
||||
- **honest-caveat:** restart-pending / repro chưa chạy / scope chưa chắc — ghi thẳng.
|
||||
6. **Đối xứng ledger:** log vào comms-ledger PHÍA MÌNH (chiều OUT của sister = request lên AI_INFRA). AI_INFRA `/adap-audit` *(Đợt 2)* đọc cross-repo (read-only) → em main eval → ghi REQUEST-IN của AI_INFRA + quyết: trigger `/adap-update` / `/adap-broadcast` / hoặc reply "n-a + lý-do". *(KHÔNG cần copy-paste request về — AI_INFRA READ cross-repo. Tạm Đợt-1: anh relay khi chưa có `/adap-audit`.)*
|
||||
|
||||
## 🔴 Guard
|
||||
|
||||
- **CHỈ ghi repo MÌNH (§J2).** Ghi `docs/governance/adap-requests/<id>.md` + comms-ledger phía mình. **TUYỆT ĐỐI KHÔNG ghi repo AI_INFRA** — em main tự đọc cross-repo + tự quyết. Vi phạm = §L1 RCA.
|
||||
- **§M-gate cứng:** thiếu lý-lẽ HOẶC bằng-chứng = **KHÔNG file** (im). Forced-evidence chống cãi-suông.
|
||||
- **Authority ↔ correctness:** đây là **đề-xuất**, KHÔNG phải override. Em main quyết cơ chế infra; conflict → anh phân xử (charter v2). Sister tự chủ phần product (không cần request).
|
||||
- **Roster-AGNOSTIC (G-014):** mô tả theo **roster THẬT của bạn** (số sub/topology tùy bạn) — KHÔNG giả định 4/7/8 sub hay tên-sub của project khác.
|
||||
- **Accuracy (G-015):** mô tả flaw/pattern KHÔNG overclaim enforcement (vd "read-only" v.v.) — bám đúng câu chữ + bằng-chứng thật.
|
||||
- **Honest nấc (§C5 · G-011):** đề-xuất mới = `agreed` (chưa eval) · cần repro = `verified-pending`. KHÔNG nhảy nấc. "đã gửi" ≠ "đã adopt".
|
||||
- Commit `adap-requests/` + comms-ledger phía mình (corruption-clean — chỉ Write-tool, KHÔNG shell-append).
|
||||
Reference in New Issue
Block a user