failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/vi/configuration.mdx

@@ -0,0 +1,268 @@
+---
+---
+title: Cấu hình
+description: "Định dạng tệp cấu hình, hệ thống ba phạm vi, và quy tắc hợp nhất"
+icon: gear
+---
+
+failproofai sử dụng các tệp cấu hình JSON để kiểm soát những chính sách nào hoạt động, cách chúng hoạt động và vị trí tải các chính sách tùy chỉnh. Cấu hình được thiết kế dễ dàng để chia sẻ với nhóm của bạn - cam kết nó vào kho của bạn và mọi nhà phát triển sẽ nhận được lưới an toàn agent giống nhau.
+
+---
+
+## Phạm vi cấu hình
+
+Có ba phạm vi cấu hình, được đánh giá theo thứ tự ưu tiên:
+
+| Phạm vi | Đường dẫn tệp | Mục đích |
+|---------|---------------|---------|
+| **dự án** | `.failproofai/policies-config.json` | Cài đặt theo kho, được cam kết vào kiểm soát phiên bản |
+| **cục bộ** | `.failproofai/policies-config.local.json` | Ghi đè cục bộ cá nhân theo kho, được gitignore |
+| **toàn cục** | `~/.failproofai/policies-config.json` | Giá trị mặc định cấp người dùng trên tất cả các dự án |
+
+Khi failproofai nhận một sự kiện hook, nó tải và hợp nhất cả ba tệp tồn tại cho thư mục làm việc hiện tại.
+
+### Quy tắc hợp nhất
+
+**`enabledPolicies`** - sự hợp nhất của tất cả ba phạm vi. Một chính sách được bật ở bất kỳ mức nào là hoạt động.
+
+```text
+project:  ["block-sudo"]
+local:    ["block-rm-rf"]
+global:   ["block-sudo", "sanitize-api-keys"]
+
+resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← hợp nhất được khử trùng
+```
+
+**`policyParams`** - phạm vi đầu tiên xác định tham số cho một chính sách nhất định sẽ thắng hoàn toàn. Không có hợp nhất sâu của các giá trị trong tham số của chính sách.
+
+```text
+project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
+global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
+
+resolved: { allowPatterns: ["sudo apt-get update"] }   ← dự án thắng, toàn cục bị bỏ qua
+```
+
+```text
+project:  (không có mục block-sudo)
+local:    (không có mục block-sudo)
+global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
+
+resolved: { allowPatterns: ["sudo systemctl status"] }  ← rơi xuống toàn cục
+```
+
+**`customPoliciesPaths` / `customPoliciesPath`** - phạm vi đầu tiên xác định bất kỳ dạng nào sẽ thắng.
+
+**`disabledCustomPolicies`** - sự hợp nhất trên tất cả các phạm vi. Bảng điều khiển ghi một ID được xác định nguồn ở đây khi bạn tắt một chính sách riêng lẻ từ một tệp chính sách rõ ràng hoặc quy ước. Các chính sách không được liệt kê vẫn được bật theo mặc định; ID bao gồm tệp nguồn để các chính sách cùng tên trong nhiều tệp có thể được kiểm soát độc lập.
+
+**`llm`** - phạm vi đầu tiên xác định nó sẽ thắng.
+
+---
+
+## Định dạng tệp cấu hình
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-push-master",
+    "sanitize-api-keys",
+    "sanitize-jwt",
+    "block-env-files",
+    "block-read-outside-cwd"
+  ],
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    },
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "prod"]
+    },
+    "block-rm-rf": {
+      "allowPaths": ["/tmp"]
+    },
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company"]
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  },
+  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
+}
+```
+
+---
+
+## Tham chiếu trường
+
+### `enabledPolicies`
+
+Loại: `string[]`
+
+Danh sách tên chính sách để bật. Tên phải khớp chính xác với các định danh chính sách được hiển thị bởi `failproofai policies`. Xem [Built-in Policies](/vi/built-in-policies) để xem danh sách đầy đủ.
+
+Các chính sách không có trong `enabledPolicies` không hoạt động, ngay cả khi chúng có các mục trong `policyParams`.
+
+### `policyParams`
+
+Loại: `Record<string, Record<string, unknown>>`
+
+Ghi đè tham số theo chính sách. Khóa ngoài là tên chính sách; các khóa bên trong là cụ thể cho chính sách. Mỗi chính sách ghi lại các tham số khả dụng của nó trong [Built-in Policies](/vi/built-in-policies).
+
+Nếu một chính sách có tham số nhưng bạn không chỉ định chúng, thì các giá trị mặc định tích hợp của chính sách sẽ được sử dụng. Người dùng không cấu hình `policyParams` hoàn toàn sẽ nhận được hành vi giống hệt các phiên bản trước.
+
+Các khóa không xác định bên trong khối tham số của chính sách được bỏ qua im lặng tại thời điểm kích hoạt hook nhưng được đánh dấu là cảnh báo khi bạn chạy `failproofai policies`.
+
+#### `hint` (liên quan)
+
+Loại: `string` (tùy chọn)
+
+Một thông báo được nối thêm vào lý do khi một chính sách trả về `deny` hoặc `instruct`. Sử dụng nó để cung cấp hướng dẫn có thể hành động cho Claude mà không cần sửa đổi chính sách.
+
+Hoạt động với bất kỳ loại chính sách nào — tích hợp sẵn, tùy chỉnh (`custom/`), quy ước dự án (`.failproofai-project/`), hoặc quy ước người dùng (`.failproofai-user/`).
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Try creating a fresh branch instead."
+    },
+    "block-sudo": {
+      "allowPatterns": ["sudo apt-get"],
+      "hint": "Use apt-get directly without sudo."
+    },
+    "custom/my-policy": {
+      "hint": "Ask the user for approval first."
+    }
+  }
+}
+```
+
+Khi `block-force-push` từ chối, Claude sẽ thấy: *"Force-pushing is blocked. Try creating a fresh branch instead."*
+
+Các giá trị không phải chuỗi và chuỗi trống được bỏ qua im lặng. Nếu `hint` không được đặt, hành vi không thay đổi (tương thích ngược).
+
+### `customPoliciesPath`
+
+Loại: `string` (đường dẫn tuyệt đối)
+
+Đường dẫn đến tệp JavaScript chứa các chính sách hook tùy chỉnh. Điều này được đặt tự động bởi `failproofai policies --install --custom <path>` (đường dẫn được phân giải thành tuyệt đối trước khi lưu trữ).
+
+Tệp được tải mới trên mỗi sự kiện hook - không có bộ nhớ đệm. Xem [Custom Policies](/vi/custom-policies) để biết chi tiết viết tác.
+
+### Chính sách dựa trên quy ước
+
+Ngoài `customPoliciesPath` rõ ràng, failproofai sẽ tự động khám phá và tải các tệp chính sách từ các thư mục `.failproofai/policies/`:
+
+| Mức | Thư mục | Phạm vi |
+|-----|---------|--------|
+| Dự án | `.failproofai/policies/` | Chia sẻ với nhóm thông qua kiểm soát phiên bản |
+| Người dùng | `~/.failproofai/policies/custom-policies/` | Cá nhân, áp dụng cho tất cả các dự án |
+
+<Note>
+  Thư mục cấp người dùng đã di chuyển xuống một mức trong tái tổ chức thư mục chính.
+  Các tệp để lại ở vị trí cũ `~/.failproofai/policies/` sẽ được di chuyển tự động
+  vào `custom-policies/` lần đầu tiên bạn chạy bất kỳ lệnh `failproofai` nào sau khi nâng cấp,
+  và lệnh sẽ cho bạn biết những tệp nào đã được di chuyển.
+</Note>
+
+**Khớp tệp:** Chỉ các tệp khớp `*policies.{js,mjs,ts}` được tải (ví dụ: `security-policies.mjs`, `workflow-policies.js`). Các tệp khác trong thư mục sẽ bị bỏ qua.
+
+**Không cần cấu hình:** Các chính sách quy ước không yêu cầu bất kỳ mục nào trong `policies-config.json`. Chỉ cần thả các tệp vào thư mục và chúng sẽ được nhặt trên sự kiện hook tiếp theo.
+
+**Tải kết hợp:** Cả thư mục quy ước dự án và người dùng đều được quét. Tất cả các tệp khớp từ cả hai mức đều được tải (không giống `customPoliciesPath` sử dụng phạm vi thắng đầu tiên).
+
+Xem [Custom Policies](/vi/custom-policies) để biết thêm chi tiết và ví dụ.
+
+### `llm`
+
+Loại: `object` (tùy chọn)
+
+Cấu hình máy khách LLM cho các chính sách thực hiện các cuộc gọi AI. Không bắt buộc cho hầu hết các thiết lập.
+
+```json
+{
+  "llm": {
+    "model": "claude-sonnet-4-6",
+    "apiKey": "sk-ant-..."
+  }
+}
+```
+
+---
+
+## Quản lý cấu hình từ CLI
+
+Các lệnh `policies --install` và `policies --uninstall` ghi vào tệp cài đặt hook của CLI agent của bạn (các điểm vào hook), trong khi `policies-config.json` là tệp bạn quản lý trực tiếp. Hai cái này là riêng biệt:
+
+- **Cài đặt Agent CLI** — yêu cầu agent gọi `failproofai --hook <event>` trên mỗi lần sử dụng công cụ:
+  - **Claude Code**: `~/.claude/settings.json` (người dùng), `<cwd>/.claude/settings.json` (dự án), `<cwd>/.claude/settings.local.json` (cục bộ)
+  - **OpenAI Codex**: `~/.codex/hooks.json` (người dùng), `<cwd>/.codex/hooks.json` (dự án) — Codex không có phạm vi `local`
+  - **GitHub Copilot CLI _(beta)_**: `~/.copilot/hooks/failproofai.json` (người dùng), `<cwd>/.github/hooks/failproofai.json` (dự án) — Copilot không có phạm vi `local`. Các mục hook sử dụng các trường lệnh `bash`/`powershell` được đặt khóa OS của Copilot với `timeoutSec`; tệp mang một đánh dấu cấp cao nhất `version: 1`. Hỗ trợ Copilot CLI là **beta** trong khi chúng tôi xác minh lược đồ bản ghi `events.jsonl` (không được chỉ định trong tài liệu công cộng) so với các phiên thực tế hơn. **Chế độ đại lý VS Code Copilot Chat (Xem trước)** đọc cấu hình hook từ `.github/hooks/*.json`, `~/.copilot/hooks/*.json` và `~/.claude/settings.json` (được chi phối bởi cài đặt `chat.hookFilesLocations`) sử dụng hợp đồng `{hookSpecificOutput:{permissionDecision:"deny",…}}` hình dạng Claude giống nhau — chính xác những đường dẫn mà tích hợp `copilot` và tích hợp `claude` (`~/.claude/settings.json`) đã viết, vì vậy `failproofai policies --install --cli copilot` (hoặc `--cli claude`) **đã thực thi trong chế độ đại lý VS Code** mà không cần tích hợp `vscode` riêng biệt (được xác nhận trực tiếp từ nhật ký khám phá VS Code).
+  - **Cursor Agent _(beta)_**: `~/.cursor/hooks.json` (người dùng), `<cwd>/.cursor/hooks.json` (dự án) — Cursor không có phạm vi `local`. Các mục hook sử dụng dạng `{type, command, timeout}` hình dạng Claude (không có chia nhỏ `bash`/`powershell`), nhưng được lưu trữ dưới các khóa sự kiện camelCase (`preToolUse`, `beforeSubmitPrompt`, …) trong một mảng phẳng cho mỗi [lược đồ hook](https://cursor.com/docs/hooks) của Cursor. Tệp mang một đánh dấu cấp cao nhất `version: 1`. Trình xử lý chuẩn hóa camelCase → PascalCase qua `CURSOR_EVENT_MAP` để các chính sách tích hợp sẵn hiện tại kích hoạt không thay đổi. Hỗ trợ Cursor Agent là **beta** trong khi chúng tôi xác minh định dạng bảng điểm Cursor trên đĩa (không được chỉ định trong tài liệu công cộng) so với các cài đặt thực tế hơn.
+  - **OpenCode _(beta)_**: `~/.config/opencode/opencode.json` + `~/.config/opencode/plugins/failproofai.mjs` (người dùng), `<cwd>/.opencode/opencode.json` + `<cwd>/.opencode/plugins/failproofai.mjs` (dự án) — OpenCode không có phạm vi `local`. Không giống như năm CLI khác, OpenCode **không có hệ thống hook lệnh bên ngoài**: nó tải các plugin JS/TS được xử lý trong quy trình được đăng ký rõ ràng qua mảng `plugin: []` trong `opencode.json` (tự động khám phá từ `.opencode/plugins/` **không** phải cách các plugin tải trên opencode v1.14.33). Cài đặt thả một shim plugin nhỏ được tạo ra sẽ gọi tệp nhị phân failproofai trong subprocess và dịch phản hồi JSON hình dạng Claude của tệp nhị phân trở lại ngữ nghĩa plugin: `throw new Error()` cho lần từ chối sự kiện công cụ (hủy bỏ lệnh gọi công cụ), `client.session.prompt(...)` cho lệnh **và** cho từ chối `Stop` / `SubagentStop` (gửi lý do từ chối làm thông báo người dùng tiếp theo — kênh buộc thử lại duy nhất vì `session.idle` chỉ là thông báo và ném từ nó là nó không hoạt động), và không hoạt động cho phép. Shim chuẩn hóa cả tên công cụ (chữ thường → PascalCase qua `OPENCODE_TOOL_MAP`) và khóa đối số đầu vào công cụ (camelCase → snake_case qua `OPENCODE_TOOL_INPUT_MAP` cho `Read` / `Write` / `Edit`, ví dụ: `filePath` → `file_path`, `oldString` → `old_string`) trước khi chuyển tiếp đến tệp nhị phân, để kiểm tra đường dẫn các tính năng tích hợp sẵn như `block-read-outside-cwd`, `block-env-files` và `block-secrets-write` kích hoạt không thay đổi trên lệnh gọi công cụ OpenCode. Các phiên sống trong cơ sở dữ liệu SQLite của opencode tại `~/.local/share/opencode/opencode.db`; trình xem phiên của bảng điều khiển đọc chúng qua `opencode db --format json` và `opencode export <id>`. Hỗ trợ OpenCode là **beta** trong khi chúng tôi xác minh hành vi trên các phiên bản và so với các phiên thực tế hơn. Xem [tài liệu plugin OpenCode](https://opencode.ai/docs/plugins/).
+  - **Pi _(beta)_**: `~/.pi/agent/settings.json` (người dùng), `<cwd>/.pi/settings.json` (dự án) — Pi không có phạm vi `local`. Pi tải các gói mở rộng TypeScript tại khởi động; tệp cài đặt là mảng chuỗi phẳng `{"packages": ["./relative/path", …]}`. failproofai ghi một mục mảng gói duy nhất trỏ đến thư mục `pi-extension/` được đóng gói của nó. Phần mở rộng nội bộ đăng ký cho các sự kiện `tool_call` / `user_bash` / `input` / `session_start` của Pi và lệnh shell đến `failproofai --hook <Event> --cli pi`; trình xử lý chuẩn hóa snake_case lower case dấu gạch dưới → PascalCase qua `PI_EVENT_MAP` để các chính sách tích hợp sẵn hiện tại kích hoạt không thay đổi. Các đối số đầu vào công cụ cũng được chuẩn hóa qua `PI_TOOL_INPUT_MAP` (Pi's Read / Write / Edit cung cấp `path` thay vì `file_path`; ánh xạ khóa cấp cao nhất cho phép `block-env-files` và `block-secrets-write` kích hoạt — `block-read-outside-cwd` đã có sự dự phòng `path`). Hỗ trợ Pi là **beta** trong khi API mở rộng Pi và bố cục nhật ký phiên ổn định.
+  - **Hermes (hermes-agent)**: `~/.hermes/config.yaml` (**chỉ phạm vi người dùng** — Hermes không có cấu hình dự án/cục bộ). Hermes là **cổng** Slack/Telegram, vì vậy một cài đặt chặn các cuộc gọi công cụ từ mọi nền tảng (Slack/Telegram/cli/cron) **và** các tác nhân con bên trong. Các mục hook là cặp `{command, timeout}` (thời chờ tính bằng **giây**) dưới bản đồ `hooks:` được khóa bởi các sự kiện snake_case của Hermes (`pre_tool_call` / `post_tool_call` / `on_session_start` / `on_session_end` / `subagent_stop`); trình xử lý chuẩn hóa sự kiện qua `HERMES_EVENT_MAP` và tên công cụ qua `HERMES_TOOL_MAP` để các chính sách tích hợp sẵn kích hoạt không thay đổi. Cấu hình được chỉnh sửa thông qua vòng lặp `Document` YAML bảo toàn comment để các cài đặt khác của toán tử sống sót, và cài đặt `hooks_auto_accept: true` để cổng không đầu (không TTY) chạy các hook mà không nhắc yêu cầu sự đồng ý. Người đánh giá phát ra hợp đồng `{"decision":"block","reason"}` stdout của Hermes (Hermes bỏ qua mã thoát). **Hạn chế:** Hermes không có sự kiện `Stop` cuối lượt, vì vậy các tính năng tích hợp sẵn `require-*-before-stop` không bao giờ kích hoạt cho nó (không áp dụng, không bị hỏng); `instruct` giảm xuống cho phép với ghi chú đã ghi (không có kênh ngữ cảnh bổ sung); và redaction bí mật đầu ra (`sanitize-*`) không thể viết lại đầu ra công cụ trên hợp đồng hook shell. Hermes cũng là một nguồn kiểm toán **ngoại tuyến** — bảng điều khiển đọc các phiên cổng của nó trực tiếp từ `~/.hermes/state.db`.
+  - **OpenClaw (openclaw gateway)**: `~/.openclaw/openclaw.json` (**chỉ phạm vi người dùng** — OpenClaw không có cấu hình dự án/cục bộ). Giống như Hermes, OpenClaw là **cổng** đa kênh tự lưu trữ, vì vậy một cài đặt chặn các cuộc gọi công cụ từ mọi kênh và các tác nhân con bên trong của nó. Thực thi chạy qua **các hook plugin được xử lý trong quy trình** của OpenClaw (các hook dựa trên tệp nội bộ của nó chỉ được quan sát và không thể chặn), vì vậy — giống như OpenCode/Pi — failproofai gửi một gói `openclaw-plugin/` tĩnh sẽ async-spawn tệp nhị phân failproofai và dịch phán quyết. Cài đặt đăng ký thư mục plugin được gửi trong `openclaw.json` của `plugins.load.paths[]` và bật nó dưới `plugins.entries.failproofai` (với `hooks.allowConversationAccess: true`, bắt buộc cho các hook cuộc trò chuyện thô). Người đánh giá phát ra phán quyết phẳng `{permission, reason}` và shim ánh xạ nó vào hình dạng trả lại riêng của mỗi hook: `before_tool_call → {block:true, blockReason}` (**PreToolUse**), `before_agent_run → {outcome:"block", reason}` (**UserPromptSubmit**), và `before_agent_finalize → {action:"revise", reason}` (**Stop** — cổng cuối lượt thực sự, vì vậy các tính năng tích hợp sẵn `require-*-before-stop` **thực thi** trên OpenClaw, không giống Hermes). Các sự kiện và tên công cụ chuẩn hóa phía tệp nhị phân qua `OPENCLAW_EVENT_MAP` / `OPENCLAW_TOOL_MAP` (`exec→Bash`, `read→Read`, …) để các chính sách tích hợp sẵn kích hoạt không thay đổi; shim không thành công nếu có lỗi spawn/parse/timeout. OpenClaw cũng là một nguồn kiểm toán **ngoại tuyến** — bảng điều khiển đọc các phiên JSONL của nó tại `~/.openclaw/agents/<agentId>/sessions/<uuid>.jsonl`.
+  - **Factory Droid (`droid`)**: `~/.factory/hooks.json` (người dùng), `<cwd>/.factory/hooks.json` (dự án) — Factory không có phạm vi `local`. droid gửi hệ thống hook lệnh bên ngoài hình dạng Claude, nhưng với hai lạ được xác minh trực tiếp với droid v0.171.0: (1) tên sự kiện sống tại **mức cao nhất** của `hooks.json` — có **không có bọc `"hooks"`** (droid từ chối một); các sự kiện công cụ (`PreToolUse`/`PostToolUse`) mang `"matcher": "*"`, các sự kiện không phải công cụ bỏ qua nó. (2) Từ chối được điều hành bởi **mã thoát hook 2 + stderr**, không phải quyết định JSON — nhánh `factory` của người đánh giá trả về thoát 2 cho sự kiện công cụ/nhắc nhở và `{decision:"block", reason}` chỉ trên sự kiện cuối lượt `Stop` (kênh buộc thử lại duy nhất của droid). Các sự kiện đã là PascalCase (không có bản đồ sự kiện) và tải trọng là snake_case Claude; chỉ tên công cụ được chuẩn hóa qua `FACTORY_TOOL_MAP` (`Execute→Bash`, `Create→Write`, `FetchUrl→WebFetch`, …). Factory cũng là một nguồn kiểm toán **ngoại tuyến** — bảng điều khiển đọc các phiên JSONL trên đĩa của nó tại `~/.factory/sessions/<encoded-cwd>/<sessionId>.jsonl`.
+  - **Devin CLI (`devin`, Cognition)**: `~/.config/devin/config.json` (người dùng), `<cwd>/.devin/config.json` (dự án) — Devin không có phạm vi `local`. Devin là một **Claude-bản sao thuần túy** được xác minh trực tiếp với devin v3000.1.27: nó sử dụng lược đồ `"hooks"`-bọc Claude tiêu chuẩn (ghi giữ hợp nhất để các khóa khác của tệp cấu hình — `org_id`, `theme_mode`, … — sống sót), tên sự kiện đã là PascalCase (không có bản đồ sự kiện, không có nhánh trình xử lý) và tải trọng stdin snake_case Claude (không có chuẩn hóa). Nhánh `devin` của người đánh giá từ chối với JSON `{"decision":"block","reason"}` trên stdout tại thoát 0 cho **mọi** sự kiện (xác minh — khối ghi đè `--permission-mode dangerous`); trên sự kiện `Stop` cuối lượt lý do mang từ ngữ force-retry bắt buộc để các tính năng tích hợp sẵn `require-*-before-stop` thực thi. Chỉ tên công cụ được chuẩn hóa qua `DEVIN_TOOL_MAP` (`exec→Bash`; `tool_input.command` đã là chính tắc). Devin cũng là một nguồn kiểm toán **ngoại tuyến** — bảng điều khiển đọc các phiên SQLite của nó tại `~/.local/share/devin/cli/sessions.db` (mỗi hàng `sessions` mang một `working_directory` thực sự, vì vậy các phiên nhóm theo thư mục làm việc dự án như Claude).
+  - **Antigravity CLI (`agy`)**: `~/.gemini/config/hooks.json` (người dùng), `<cwd>/.agents/hooks.json` (dự án) — Antigravity không có phạm vi `local`. Không giống Factory/Devin, Antigravity có **hợp đồng riêng của nó** (không phải Claude-bản sao), được xác minh trực tiếp với agy v1.1.2. `hooks.json` sử dụng **lược đồ hook có tên**: khóa cấp cao nhất là một tên hook *name* (`"failproofai"`) có giá trị là bản đồ sự kiện→trình xử lý — các sự kiện công cụ (`PreToolUse`/`PostToolUse`) bọc trình xử lý trong `{matcher:"*", hooks:[…]}`, trong khi `PreInvocation`/`Stop` là **phẳng** mảng trình xử lý (các hook có tên khác được bảo tồn). Tải trọng stdin là **protojson camelCase** (`toolCall:{name,args}`, `conversationId`, `workspacePaths`, `transcriptPath`) — failproofai chuẩn hóa nó thành snake_case trước khi các chính sách chạy và ánh xạ các đối số `run_command` của PascalCase (`CommandLine`/`Cwd`) qua `ANTIGRAVITY_TOOL_INPUT_MAP`. Nhánh `antigravity` của người đánh giá sử dụng **hình dạng phản hồi riêng của Antigravity**: `{decision:"deny", reason}` chặn một công cụ/nhắc nhở (thoát 0), `{decision:"continue", reason}` trên sự kiện `Stop` cuối lượt tái nhập vòng lặp (vì vậy các tính năng tích hợp sẵn `require-*-before-stop` thực thi), và `{injectSteps:[{ephemeralMessage}]}` tiêm một hướng dẫn trên `PreInvocation` (→ `UserPromptSubmit`). Các tên công cụ chuẩn hóa qua `ANTIGRAVITY_TOOL_MAP` (`run_command→Bash`, `view_file→Read`, …). Antigravity cũng là một nguồn kiểm toán **ngoại tuyến** — bảng điều khiển đọc bản ghi phiên JSONL thô của nó tại `~/.gemini/antigravity-cli/brain/<conversationId>/.system_generated/logs/transcript_full.jsonl` (chỉ mục cuộc trò chuyện trong `conversation_summaries.db`).
+  - **Goose (codename goose, Block)**: `~/.agents/plugins/failproofai/hooks/hooks.json` (người dùng), `<cwd>/.agents/plugins/failproofai/hooks/hooks.json` (dự án) — Goose không có phạm vi `local`. Thực thi sử dụng hệ thống **hooks** của Goose, **lực đặc biệt Open Plugins** theo tiêu chuẩn: trình cài đặt chỉ thả thư mục plugin `failproofai` và Goose tự động khám phá nó tại khởi động (tự đăng ký nó vào `~/.config/goose/config.yaml`). `hooks.json` sử dụng lược đồ Open Plugins **có** bọc cấp cao nhất `"hooks"`, và các trận đấu được **bỏ qua** trên mọi sự kiện — `"*"` trần là biểu thức chính quy không hợp lệ không khớp bất cứ điều gì (xác minh trực tiếp với goose v1.43.0). Tên sự kiện đã là PascalCase (không có bản đồ sự kiện); tải trọng stdin sử dụng `event`/`working_dir`, mà trình xử lý chuẩn hóa thành `hook_event_name`/`cwd`. Nhánh `goose` của người đánh giá từ chối với JSON `{"decision":"block","reason"}` trên stdout tại thoát 0, được tôn trọng trên sự kiện **`PreToolUse`** duy nhất (được gửi trong goose ≥ v1.37.0) — kích hoạt cho công cụ shell **và bên trong các tác nhân con được ủy quyền**, vì vậy đó là điểm từ chối duy nhất đủ; lỗi hook khác bất kỳ không thành công **mở**. Goose **không có sự kiện `Stop`**, vì vậy các tính năng tích hợp sẵn `require-*-before-stop` không áp dụng (như với Hermes). Các tên công cụ chuẩn hóa qua `GOOSE_TOOL_MAP` (`shell→Bash`, `write→Write`, `todo__todo_write→TodoWrite`, …) và khóa đường dẫn qua `GOOSE_TOOL_INPUT_MAP` (`path`/`source` → `file_path`). Goose cũng là một nguồn kiểm toán **ngoại tuyến** — bảng điều khiển đọc các phiên SQLite của nó tại `~/.local/share/goose/sessions/sessions.db` (mỗi hàng `sessions` mang một `working_dir` thực sự, vì vậy các phiên nhóm theo thư mục làm việc dự án như Devin; chạy không phiên `--no-session` được lọc).
+- **`policies-config.json`** — yêu cầu failproofai chính sách nào để đánh giá và với những tham số (được chia sẻ trên tất cả CLI agent)
+
+Chuyển `--cli claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose` để nhắm đến một agent cụ thể (cách nhau bằng dấu cách hoặc lặp lại cho bất kỳ tập hợp con nào):
+
+```bash
+failproofai policies --install --cli codex --scope project
+failproofai policies --install --cli copilot --scope project
+failproofai policies --install --cli cursor --scope project
+failproofai policies --install --cli opencode --scope project
+failproofai policies --install --cli pi --scope project
+failproofai policies --install --cli hermes --scope user
+failproofai policies --install --cli openclaw --scope user
+failproofai policies --install --cli factory --scope project
+failproofai policies --install --cli devin --scope project
+failproofai policies --install --cli antigravity --scope project
+failproofai policies --install --cli goose --scope project
+failproofai policies --install --cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose
+```
+
+Khi `--cli` bị bỏ qua, `failproofai` phát hiện CLI agent nào được cài đặt (`which claude` / `which codex` / `which copilot` / `which cursor-agent` / `which opencode` / `which pi` / `which hermes` / `which openclaw` / `which droid` / `which devin` / `which agy` / `which goose`):
+
+- **Một CLI được phát hiện** — tự động chọn CLI đó mà không cần nhắc.
+- **Nhiều CLI được phát hiện** trong một thiết bị đầu cuối tương tác — hiển thị lời nhắc lựa chọn đơn lẻ bằng phím mũi tên được nhóm thành phần `Detected (N)` (với hàng tổng hợp `Install for all N detected` + mỗi CLI được phát hiện riêng biệt) và phần `Not installed (M) · install hooks ahead of time` liệt kê mọi CLI hỗ trợ không được phát hiện dưới dạng tùy chọn cài đặt chuyển tiếp (↑↓ để di chuyển, Nhập để chọn, ^C để thoát). Luồng gỡ cài đặt chỉ hiển thị phần Detected.
+- **Nhiều CLI được phát hiện** trong chạy không tương tác (CI, không TTY) — cài đặt cho tất cả CLI được phát hiện mà không cần nhắc.
+- **Không có cái nào được phát hiện** — quay lại `claude`, với cảnh báo rằng không tìm thấy tệp nhị phân agent nào trong PATH; lệnh hook vẫn được ghi để nó kích hoạt ngay khi bạn cài đặt.
+
+Bạn có thể chỉnh sửa `policies-config.json` trực tiếp bất kỳ lúc nào; các thay đổi có hiệu lực ngay lập tức trên sự kiện hook tiếp theo mà không cần khởi động lại.
+
+---
+
+## Ví dụ: cấu hình cấp dự án với giá trị mặc định nhóm
+
+Cam kết `.failproofai/policies-config.json` vào kho của bạn:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-push-master",
+    "sanitize-api-keys",
+    "block-env-files"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "hotfix"]
+    }
+  }
+}
+```
+
+Mỗi nhà phát triển sau đó có thể tạo `.failproofai/policies-config.local.json` (gitignore) cho các ghi đè cá nhân mà không ảnh hưởng đến các đồng nghiệp.

package/.next/standalone/docs-old/vi/custom-policies.mdx

@@ -0,0 +1,358 @@
+---
+title: Chính sách tùy chỉnh
+description: "Viết quy tắc của riêng bạn bằng JavaScript - thực thi các quy ước, ngăn chặn sự thay đổi, phát hiện lỗi, tích hợp với các hệ thống bên ngoài"
+icon: code
+---
+
+Chính sách tùy chỉnh cho phép bạn viết các quy tắc cho bất kỳ hành vi agent nào: thực thi các quy ước dự án, ngăn chặn sự thay đổi không mong muốn, kiểm soát các hoạt động phá hoại, phát hiện agent bị kẹt, hoặc tích hợp với Slack, quy trình phê duyệt, v.v. Chúng sử dụng cùng hệ thống sự kiện hook và các quyết định `allow`, `deny`, `instruct` như các chính sách được tích hợp sẵn.
+
+---
+
+## Ví dụ nhanh
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) {
+      return deny("Writes to production paths are blocked");
+    }
+    return allow();
+  },
+});
+```
+
+Cài đặt nó:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+---
+
+## Hai cách để tải chính sách tùy chỉnh
+
+### Tùy chọn 1: Dựa trên quy ước (khuyến nghị)
+
+Thả các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chúng sẽ được tải tự động — không cần cờ hoặc thay đổi cấu hình. Điều này hoạt động giống như git hooks: thả một tệp, nó chỉ hoạt động.
+
+```
+# Cấp độ dự án — được commit vào git, chia sẻ với nhóm
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# Cấp độ người dùng — cá nhân, áp dụng cho tất cả các dự án
+~/.failproofai/policies/my-policies.mjs
+```
+
+**Cách hoạt động:**
+- Cả hai thư mục dự án và người dùng được quét (hợp lệnh — không phải phạm vi đầu tiên thắng)
+- Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Đặt tiền tố `01-`, `02-` để kiểm soát thứ tự
+- Chỉ các tệp khớp với `*policies.{js,mjs,ts}` được tải; các tệp khác bị bỏ qua
+- Mỗi tệp được tải độc lập (fail-open trên mỗi tệp)
+- Hoạt động cùng với các chính sách `--custom` rõ ràng và các chính sách được tích hợp sẵn
+
+<Tip>
+Chính sách quy ước là cách dễ nhất để xây dựng một tiêu chuẩn chất lượng cho tổ chức của bạn. Commit `.failproofai/policies/` vào git và mỗi thành viên nhóm sẽ tự động nhận được các quy tắc giống nhau — không cần thiết lập cho từng nhà phát triển. Khi nhóm của bạn khám phá các chế độ lỗi mới, hãy thêm một chính sách và đẩy lên. Theo thời gian, những chính sách này trở thành một tiêu chuẩn chất lượng sống động không ngừng cải thiện với mỗi đóng góp.
+</Tip>
+
+### Tùy chọn 2: Đường dẫn tệp rõ ràng
+
+```bash
+# Cài đặt với tệp chính sách tùy chỉnh
+failproofai policies --install --custom ./my-policies.js
+
+# Thay thế đường dẫn chính sách tùy chỉnh
+failproofai policies --install --custom ./new-policies.js
+
+# Cấu hình nhiều tệp rõ ràng (được tải theo thứ tự cờ)
+failproofai policies --install --custom ./security.js --custom ./workflow.js
+
+# Xóa tất cả đường dẫn chính sách tùy chỉnh rõ ràng khỏi cấu hình
+failproofai policies --uninstall --custom
+```
+
+Các đường dẫn tuyệt đối được phân giải được lưu trữ trong `policies-config.json` dưới dạng `customPoliciesPaths`. Lặp lại `--custom` để cấu hình nhiều tệp. Các cấu hình hiện có sử dụng trường `customPoliciesPath` cũ tiếp tục hoạt động. Các tệp được tải mới trên mỗi sự kiện hook - không có bộ nhớ đệm giữa các sự kiện.
+
+Mỗi chính sách được đăng ký xuất hiện với bộ chuyển đổi riêng trong bảng điều khiển. Tắt chính sách sẽ ghi ID được xác định bằng nguồn của nó vào `disabledCustomPolicies`; tệp và các chính sách khác của nó tiếp tục được tải, trong khi chính sách bị tắt bị loại trừ trước khi khớp sự kiện. Tên chính sách trùng lặp trên các tệp có các bộ chuyển đổi độc lập.
+
+### Sử dụng cả hai cùng nhau
+
+Chính sách quy ước và các tệp `--custom` rõ ràng có thể coexist. Thứ tự tải:
+
+1. Các tệp `customPoliciesPaths` rõ ràng (theo thứ tự được cấu hình)
+2. Tệp quy ước dự án (`{cwd}/.failproofai/policies/`, theo thứ tự bảng chữ cái)
+3. Tệp quy ước người dùng (`~/.failproofai/policies/`, theo thứ tự bảng chữ cái)
+
+---
+
+## API
+
+### Import
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+```
+
+### `customPolicies.add(hook)`
+
+Đăng ký một chính sách. Gọi điều này nhiều lần khi cần cho nhiều chính sách trong cùng một tệp.
+
+```ts
+customPolicies.add({
+  name: string;                         // required - unique identifier
+  description?: string;                 // shown in `failproofai policies` output
+  match?: { events?: HookEventType[] }; // filter by event type; omit to match all
+  fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
+});
+```
+
+### Trợ giúp quyết định
+
+| Hàm | Hiệu ứng | Sử dụng khi |
+|----------|--------|----------|
+| `allow()` | Cho phép hoạt động im lặng | Hành động là an toàn, không cần thông báo |
+| `deny(message)` | Chặn hoạt động | Agent không nên thực hiện hành động này |
+| `instruct(message)` | Thêm ngữ cảnh mà không chặn | Cung cấp ngữ cảnh bổ sung để agent không mất hướng |
+
+`deny(message)` - thông báo xuất hiện trước Claude với tiền tố `"Blocked by failproofai:"`. Một `deny` duy nhất sẽ ngắt tất cả các đánh giá tiếp theo.
+
+`instruct(message)` - thông báo được thêm vào ngữ cảnh của Claude cho lệnh gọi công cụ hiện tại. Tất cả các thông báo `instruct` được tích lũy và gửi cùng nhau.
+
+<Tip>
+Bạn có thể thêm hướng dẫn bổ sung vào bất kỳ thông báo `deny` hoặc `instruct` nào bằng cách thêm trường `hint` trong `policyParams` — không cần thay đổi mã. Điều này hoạt động cho các chính sách tùy chỉnh (`custom/`), quy ước dự án (`.failproofai-project/`), và quy ước người dùng (`.failproofai-user/`) cũng như nhau. Xem [Cấu hình → hint](/vi/configuration#hint-cross-cutting) để biết chi tiết.
+</Tip>
+
+### Thông báo allow thông tin
+
+`allow(message)` cho phép hoạt động **và** gửi một thông báo thông tin trở lại Claude. Thông báo được gửi dưới dạng `additionalContext` trong phản hồi stdout của trình xử lý hook — cơ chế tương tự như `instruct`, nhưng có ý nghĩa khác: đó là một bản cập nhật trạng thái, không phải cảnh báo.
+
+| Hàm | Hiệu ứng | Sử dụng khi |
+|----------|--------|----------|
+| `allow(message)` | Cho phép và gửi ngữ cảnh tới Claude | Xác nhận một kiểm tra đã vượt qua, hoặc giải thích tại sao kiểm tra bị bỏ qua |
+
+Các trường hợp sử dụng:
+- **Xác nhận trạng thái:** `allow("All CI checks passed.")` — cho Claude biết mọi thứ là xanh lá cây
+- **Giải thích fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — cho Claude biết tại sao kiểm tra bị bỏ qua để nó có ngữ cảnh đầy đủ
+- **Nhiều thông báo tích lũy:** nếu nhiều chính sách mỗi thông báo trả về `allow(message)`, tất cả thông báo được nối với dòng mới và gửi cùng nhau
+
+```js
+customPolicies.add({
+  name: "confirm-branch-status",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    const cwd = ctx.session?.cwd;
+    if (!cwd) return allow("No working directory, skipping branch check.");
+
+    // ... check branch status ...
+    if (allPushed) {
+      return allow("Branch is up to date with remote.");
+    }
+    return deny("Unpushed changes detected.");
+  },
+});
+```
+
+### Các trường `PolicyContext`
+
+| Trường | Loại | Mô tả |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string \| undefined` | Công cụ được gọi (ví dụ: `"Bash"`, `"Write"`, `"Read"`) |
+| `toolInput` | `Record<string, unknown> \| undefined` | Các tham số đầu vào của công cụ |
+| `payload` | `Record<string, unknown>` | Trọng tải sự kiện thô đầy đủ từ Claude Code |
+| `session` | `SessionMetadata \| undefined` | Ngữ cảnh phiên (xem bên dưới) |
+
+### Các trường `SessionMetadata`
+
+| Trường | Loại | Mô tả |
+|-------|------|-------------|
+| `sessionId` | `string` | Định danh phiên Claude Code |
+| `cwd` | `string` | Thư mục làm việc của phiên Claude Code |
+| `transcriptPath` | `string` | Đường dẫn tệp bản ghi JSONL của phiên |
+
+### Các loại sự kiện
+
+| Sự kiện | Khi nó xảy ra | Nội dung `toolInput` |
+|-------|--------------|----------------------|
+| `PreToolUse` | Trước khi Claude chạy một công cụ | Đầu vào của công cụ (ví dụ: `{ command: "..." }` cho Bash) |
+| `PostToolUse` | Sau khi công cụ hoàn thành | Đầu vào của công cụ + `tool_result` (đầu ra) |
+| `Notification` | Khi Claude gửi một thông báo | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hooks phải luôn trả về `allow()`, chúng không thể chặn thông báo |
+| `Stop` | Khi phiên Claude kết thúc | Rỗng |
+
+---
+
+## Thứ tự đánh giá
+
+Chính sách được đánh giá theo thứ tự này:
+
+1. Chính sách được tích hợp sẵn (theo thứ tự định nghĩa)
+2. Chính sách tùy chỉnh rõ ràng từ `customPoliciesPath` (theo thứ tự `.add()`)
+3. Chính sách quy ước từ dự án `.failproofai/policies/` (tệp theo thứ tự bảng chữ cái, `.add()` thứ tự trong)
+4. Chính sách quy ước từ người dùng `~/.failproofai/policies/` (tệp theo thứ tự bảng chữ cái, `.add()` thứ tự trong)
+
+<Note>
+Lệnh `deny` đầu tiên sẽ ngắt tất cả các chính sách tiếp theo. Tất cả các thông báo `instruct` được tích lũy và gửi cùng nhau.
+</Note>
+
+---
+
+## Nhập bắc cầu
+
+Các tệp chính sách tùy chỉnh có thể nhập các mô-đun cục bộ bằng đường dẫn tương đối:
+
+```js
+// my-policies.js
+import { isBlockedPath } from "./utils.js";
+import { checkApproval } from "./approval-client.js";
+
+customPolicies.add({
+  name: "approval-gate",
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const approved = await checkApproval(ctx.toolInput?.command, ctx.session?.sessionId);
+    return approved ? allow() : deny("Approval required for this command");
+  },
+});
+```
+
+Tất cả các nhập tương đối có thể truy cập được từ tệp mục nhập được phân giải. Điều này được thực hiện bằng cách viết lại các nhập `from "failproofai"` thành đường dẫn dist thực tế và tạo các tệp `.mjs` tạm thời để đảm bảo tính tương thích ESM.
+
+---
+
+## Lọc loại sự kiện
+
+Sử dụng `match.events` để giới hạn khi nào chính sách được kích hoạt:
+
+```js
+customPolicies.add({
+  name: "require-summary-on-stop",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    // Only fires when the session ends
+    // ctx.session.transcriptPath contains the full session log
+    return allow();
+  },
+});
+```
+
+Bỏ qua `match` hoàn toàn để kích hoạt trên mọi loại sự kiện.
+
+---
+
+## Xử lý lỗi và chế độ lỗi
+
+Chính sách tùy chỉnh là **fail-open**: các lỗi không bao giờ chặn các chính sách được tích hợp sẵn hoặc làm hỏng trình xử lý hook.
+
+| Lỗi | Hành vi |
+|---------|----------|
+| `customPoliciesPath` không được đặt | Không có chính sách tùy chỉnh rõ ràng chạy; chính sách quy ước và các chính sách được tích hợp sẵn tiếp tục bình thường |
+| Tệp không tìm thấy | Cảnh báo được ghi vào `~/.failproofai/hook.log`; các chính sách được tích hợp sẵn tiếp tục |
+| Lỗi cú pháp/nhập (rõ ràng) | Lỗi được ghi vào `~/.failproofai/hook.log`; chính sách tùy chỉnh rõ ràng bị bỏ qua |
+| Lỗi cú pháp/nhập (quy ước) | Lỗi được ghi; tệp đó bị bỏ qua, các tệp quy ước khác vẫn tải |
+| `fn` ném ở runtime | Lỗi được ghi; hook đó được coi là `allow`; các hook khác tiếp tục |
+| `fn` mất nhiều hơn 10 giây | Timeout được ghi; được coi là `allow` |
+| Thư mục quy ước bị thiếu | Không có chính sách quy ước chạy; không có lỗi |
+
+<Tip>
+Để gỡ lỗi các lỗi chính sách tùy chỉnh, hãy xem tệp nhật ký:
+
+```bash
+tail -f ~/.failproofai/hook.log
+```
+</Tip>
+
+---
+
+## Ví dụ đầy đủ: nhiều chính sách
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+// Prevent agent from writing to secrets/ directory
+customPolicies.add({
+  name: "block-secrets-dir",
+  description: "Prevent agent from writing to secrets/ directory",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("secrets/")) return deny("Writing to secrets/ is not permitted");
+    return allow();
+  },
+});
+
+// Keep the agent on track: verify tests before committing
+customPolicies.add({
+  name: "remind-test-before-commit",
+  description: "Keep the agent on track: verify tests pass before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Verify all tests pass before committing. Run `bun test` if you haven't already.");
+    }
+    return allow();
+  },
+});
+
+// Prevent unplanned dependency changes during freeze
+customPolicies.add({
+  name: "dependency-freeze",
+  description: "Prevent unplanned dependency changes during freeze period",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    const isInstall = /^(npm install|yarn add|bun add|pnpm add)\s+\S/.test(cmd);
+    if (isInstall && process.env.DEPENDENCY_FREEZE === "1") {
+      return deny("Package installs are frozen. Unset DEPENDENCY_FREEZE to allow.");
+    }
+    return allow();
+  },
+});
+
+export { customPolicies };
+```
+
+---
+
+## Ví dụ
+
+Thư mục `examples/` chứa các tệp chính sách sẵn sàng chạy:
+
+| Tệp | Nội dung |
+|------|----------|
+| `examples/policies-basic.js` | Năm chính sách khởi đầu bao gồm các chế độ lỗi agent phổ biến |
+| `examples/policies-advanced/index.js` | Các mẫu nâng cao: nhập bắc cầu, cuộc gọi async, loại bỏ đầu ra, và hooks kết thúc phiên |
+| `examples/convention-policies/security-policies.mjs` | Chính sách bảo mật dựa trên quy ước (chặn ghi .env, ngăn viết lại lịch sử git) |
+| `examples/convention-policies/workflow-policies.mjs` | Chính sách quy trình làm việc dựa trên quy ước (nhắc nhở kiểm tra, tệp ghi kiểm tra) |
+
+### Sử dụng các ví dụ tệp rõ ràng
+
+```bash
+failproofai policies --install --custom ./examples/policies-basic.js
+```
+
+### Sử dụng các ví dụ dựa trên quy ước
+
+```bash
+# Copy to project level
+mkdir -p .failproofai/policies
+cp examples/convention-policies/*.mjs .failproofai/policies/
+
+# Or copy to user level
+mkdir -p ~/.failproofai/policies
+cp examples/convention-policies/*.mjs ~/.failproofai/policies/
+```
+
+Không cần lệnh cài đặt — các tệp được tải tự động trên sự kiện hook tiếp theo.