update skill and docs

.claude/skills/REAME-SAD.md

@@ -174,6 +174,10 @@ Claude sẽ tự chạy `intake`, hỏi bạn nếu thiếu thông tin, rồi l
 | Runner (thực thi 1 activity) | `ba-stage-runner` | `sa-stage-runner` |
 | Output | `ba-output/<PROJECT>/` | `sa-output/<PROJECT>/` |
 
+**Lớp bàn giao dev (mới):** sa-2 có thêm ba activity `dom` (class diagram theo bounded context), `ctr` (file OpenAPI 3.1/AsyncAPI 3.0 thật trong `02-architecture/contracts/`, thắng mọi bảng mô tả API) và `pdm` (schema vật lý đủ cột + DDL/migration có rollback trong `02-architecture/schema/`); sa-3 có `handoff` (gói bàn giao dev: mục lục đường dẫn thật + checklist đủ/thiếu + dev ký đã nhận, chạy ngay khi AG2 ký). AG2 chặn khi còn "contract dự kiến" hoặc thực thể chưa có bảng. Kiểm bằng máy: `sa-2-architecture/scripts/contract-check.mjs`, `sa-3-enablement/scripts/handoff-check.mjs`.
+
+**Sơ đồ — chuẩn Archify (mọi pipeline):** mỗi sơ đồ = spec JSON Archify (`diagrams/*.<type>.json`, `quality_profile: showcase`, `archify validate` 0 lỗi) + mermaid có marker `<!-- archify: … -->` + bảng đi kèm; SAD-pipeline ghi spec vào `docs/diagrams/`, proposal/bid nhúng `<svg>` từ HTML Archify đã deliver thay vì render lại Mermaid. Gói Archify đã nhúng ở `.claude/skills/archify/`; quy tắc ở `ba-lifecycle/references/diagram-rules.md`; kiểm bằng `ba-lifecycle/scripts/diagram-check.mjs`.
+
 **Liên kết BA ↔ SA:** Gate G2 của BA cần Gate AG1 của SA đã qua (Tech Lead ký "khả thi" dựa trên phương án kiến trúc). `QAS`/`ICD`/`SEC` của SA "thắng" `NFR`/`API`/`RBAC` do BA đề xuất — khi có lệch, quay lại BA sửa `specification` với ghi chú tương ứng.
 
 **Đọc thêm:** `.claude/skills/README-BA.md` và `README-SA.md` giải thích chi tiết triết lý của hai bộ skill gốc (PROFILE 3 trục PRODUCT×LIFECYCLE×RIGOR, hệ ID RQ/BR/ADR/OQ...) — nên đọc trước khi dùng `ba-pipeline`/`sa-pipeline` lần đầu.