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

6.6 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

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-request → 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.

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