Files
solution-erp/.claude/commands/adap-request.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

6.0 KiB

description, argument-hint
description argument-hint
(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. <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).