feat(casan): add native plugin facade

README.md

@@ -87,6 +87,33 @@ multi-project, RBAC tập trung, approvals và fleet operations.
 - Windows: PowerShell 5.1+, Python 3 và Git for Windows/Git Bash.
 - Client tương ứng nếu cần: Claude Code, Codex hoặc VS Code.
 
+### Native plugin façade — tùy chọn
+
+Repository root đồng thời là marketplace source cho Codex và Claude Code. Plugin
+chỉ cung cấp skill `$casan` để agent biết cách adopt, diagnose và verify CASAN;
+nó **không** tự bật hook, không tự cài runtime và không thay thế bước trust của
+client.
+
+Từ một checkout đã được tổ chức phê duyệt:
+
+```bash
+# Codex
+codex plugin marketplace add /absolute/path/to/CASAN
+codex plugin add casan@casan
+```
+
+Trong Claude Code:
+
+```text
+/plugin marketplace add /absolute/path/to/CASAN
+/plugin install casan@casan
+```
+
+Sau khi cài plugin, mở session mới và gọi `$casan`. Runtime production vẫn được
+cài một lần bằng `install.sh`/`install.ps1`, sau đó mỗi repository phải chạy
+`casan init`. Không cài chồng native plugin và một bản skill copy thủ công vào
+cùng client.
+
 ### 1. Cài DevKit một lần trên máy
 
 Từ checkout hoặc release bundle đã được duyệt:
@@ -611,6 +638,8 @@ Dùng explicit route `@casan <prompt>` và kiểm tra
 
 | Path | Trách nhiệm |
 |---|---|
+| `.codex-plugin/`, `.claude-plugin/` | Native marketplace manifests; không tự bật enforcement |
+| `skills/casan/` | Operator skill façade dùng chung cho Codex và Claude Code |
 | `bin/casan` | CLI entrypoint |
 | `install.sh`, `install.ps1` | Global installers |
 | `packages/casan-harness/` | Runtime controls, adapters, policies, evidence và source tests |