update skill and docs

.claude/agents/ba-stage-runner.md

@@ -56,7 +56,7 @@ Chỉ sửa header/Change Log/INDEX, không đổi nội dung:
 ## Tự kiểm trước khi trả kết quả
 - Chấm checklist gate của giai đoạn (`workflow.md §2`, điều chỉnh theo RIGOR) dạng ☐/✅ kèm ghi chú — đây là **tự chấm**, không phải kết luận gate.
 - Grep quét mơ hồ (W2): `nhanh|mượt|thân thiện|v\.v|phù hợp|tương ứng|nên |có thể ` và `TBD|TODO|\?\?\?` trên file vừa ghi ⇒ báo số dòng.
-- Sơ đồ Mermaid luôn kèm bảng (W13); sequence ở GĐ3 phải có nhánh lỗi.
+- **Sơ đồ theo chuẩn Archify** (W13, `.claude/skills/ba-lifecycle/references/diagram-rules.md`): sơ đồ có kiểu Archify (quy trình/điều hướng/phụ thuộc/CR → `workflow`; vòng đời → `lifecycle`; sequence → `sequence`; lineage → `dataflow`; ranh giới hệ thống → `architecture`) ⇒ ghi spec `diagrams/<ARTIFACT>_<slug>.<type>.json` (`quality_profile: "showcase"`, không `subtitle`/`visual_preset`/`legend`/`locale`, ≤ 12 node, một đường `emphasis`, ID = mã truy vết bỏ gạch) chép hình dạng trường từ `templates/diagrams/` của skill; marker `<!-- archify: <type> · diagrams/<file>.json -->` ngay trên khối mermaid (use case/ERD/2×2/5-Why ⇒ `mermaid-only`); mermaid cùng tập ID node/cạnh với spec, không `style`/`classDef`; bảng đi kèm; sequence ở GĐ3 phải có nhánh lỗi. Bạn không có Bash ⇒ liệt kê spec trong `humanInputNeeded` "chạy archify validate/deliver + diagram-check", **không** ghi "đã validate".
 
 ## Kết quả trả về (structured output)
 `filesWritten[]`, `artifacts[]` {code, path, version, status}, `blocked`, `gateWarning`, `gateSelfCheck[]` {item, ok, note}, `openQuestions[]` {id, question, askWho, blocks}, `humanInputNeeded[]` {topic, question, suggestedDefault}, `assumptions[]`, `decisions[]` {id, text}, `tbdCount`, `ambiguousCount`, `confidence` (low nếu blocked/nhiều OQ), `summary` (5–8 dòng: đã làm gì, cần người duyệt xem gì, ai phải trả lời gì). Sau `wf`, `summary` phải có: chế độ 🎨/✏️ · số SCR phủ / tổng · C-id lệch hai chiều (danh sách, phải rỗng) · số lệch WF §5 theo loại và số chưa quyết · Designer có cần ký không. Sau `ds`/`hifi`/`figma`/`dspec`: độ tin cậy visual (🟢/🟡/🔴 + nguồn) · số SCR × trạng thái × khung nhìn phủ / tổng · ID lệch hai chiều · số `data-key` lệch SRS §4.2 · số mã màu thô · nhắc người điều phối chạy `design-check.mjs` và `render-figma.sh` · Designer/PO cần ký gì.