failproofai 0.0.6-beta.0 → 0.0.6-beta.2

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

@@ -1,10 +1,10 @@
 ---
 title: Chính sách tùy chỉnh
-description: "Viết các quy tắc của riêng bạn bằng JavaScript - thực thi các quy ước, ngăn chặn độ dịch, phát hiện lỗi, tích hợp với các hệ thống bên ngoài"
+description: "Viết các quy tắc của riêng bạn bằng JavaScript - thực thi quy ước, ngăn chặn sự trôi dạt, 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 quy ước dự án, ngăn chặn độ dịch, hạn chế các phép toán có tính chất phá hoại, phát hiện các agent bị kẹt, hoặc tích hợp với Slack, quy trình phê duyệt, và nhiều hơn nữa. 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 tích hợp sẵn.
+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 nào của agent: thực thi quy ước dự án, ngăn chặn sự trôi dạt, kiểm soát các hoạt động tàn phá, phát hiện agent bị mắc kẹt, hoặc tích hợp với Slack, quy trình phê duyệt, và nhiều hơn nữa. Chúng sử dụng cùng một hệ thống hook event và các quyết định `allow`, `deny`, `instruct` như các chính sách tích hợp.
 
 ---
 
@@ -39,12 +39,12 @@ 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 (được khuyên dùng)
+### Tùy chọn 1: Dựa trên quy ước (đượ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.
+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ó sẽ hoạt động.
 
 ```
-# Cấp độ dự án — được cam kết với git, được chia sẻ với nhóm
+# 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
 
@@ -52,21 +52,21 @@ Thả các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chú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 (liên hợp — không phải first-scope-wins)
-- 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ố với `01-`, `02-` để kiểm soát thứ tự
+**Cách nó hoạt động:**
+- Cả thư mục dự án và thư mục người dùng đều được quét (kết hợp — không phải first-scope-wins)
+- Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Sử dụng 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` tường minh và chính sách tích hợp sẵn
+- Mỗi tệp được tải độc lập (fail-open cho mỗi tệp)
+- Hoạt động cùng với các chính sách `--custom` rõ ràng và chính sách tích hợp
 
 <Tip>
-Chính sách quy ước là cách dễ nhất để chia sẻ chính sách trên toàn nhóm. Cam kết `.failproofai/policies/` với git và mỗi thành viên nhóm sẽ nhận được chúng tự động.
+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 tương tự — không cần thiết lập trên mỗi nhà phát triển. Khi nhóm của bạn khám phá ra các chế độ lỗi mới, hãy thêm một chính sách và push. Theo thời gian, những quy tắc này trở thành một tiêu chuẩn chất lượng sống động liên tục cải thiện với mỗi đóng góp.
 </Tip>
 
-### Tùy chọn 2: Đường dẫn tệp tường minh
+### 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
+# Cài đặt với một tệp chính sách tùy chỉnh
 failproofai policies --install --custom ./my-policies.js
 
 # Thay thế đường dẫn tệp chính sách
@@ -76,13 +76,13 @@ failproofai policies --install --custom ./new-policies.js
 failproofai policies --uninstall --custom
 ```
 
-Đường dẫn tuyệt đối đã được phân giải được lưu trữ trong `policies-config.json` dưới dạng `customPoliciesPath`. Tệp được tải lại trên mỗi sự kiện hook - không có bộ đệm ẩm giữa các sự kiện.
+Đường dẫn tuyệt đối đã giải quyết được lưu trữ trong `policies-config.json` dưới dạng `customPoliciesPath`. Tệp được tải mới trên mỗi hook event - không có bộ nhớ đệm giữa các sự kiện.
 
 ### Sử dụng cả hai cùng nhau
 
-Chính sách quy ước và tệp `--custom` tường minh có thể cùng tồn tại. Thứ tự tải:
+Chính sách quy ước và tệp `--custom` rõ ràng có thể coexist. Thứ tự tải:
 
-1. Tệp `customPoliciesPath` tường minh (nếu được cấu hình)
+1. Tệp `customPoliciesPath` rõ ràng (nếu đượ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)
 
@@ -90,7 +90,7 @@ Chính sách quy ước và tệp `--custom` tường minh có thể cùng tồn
 
 ## API
 
-### Nhập
+### Import
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -98,7 +98,7 @@ import { customPolicies, allow, deny, instruct } from "failproofai";
 
 ### `customPolicies.add(hook)`
 
-Đăng ký một chính sách. Gọi nhiều lần nếu cần cho nhiều chính sách trong cùng một tệp.
+Đăng ký một chính sách. Gọi hàm này bao nhiêu lần tùy ý cho nhiều chính sách trong cùng một tệp.
 
 ```ts
 customPolicies.add({
@@ -109,34 +109,34 @@ customPolicies.add({
 });
 ```
 
-### Trợ giúp quyết định
+### Các trợ giúp quyết định
 
-| Hàm | Hiệu ứng | Sử dụng khi |
+| Hàm | Tác dụng | Sử dụng khi |
 |----------|--------|----------|
-| `allow()` | Cho phép hoạt động im lặng | Hành động an toàn, không cần tin nhắn |
+| `allow()` | Cho phép hoạt động im lặng | Hành động là an toàn, không cần tin nhắn |
 | `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 ở đúng track |
+| `instruct(message)` | Thêm ngữ cảnh mà không chặn | Cung cấp cho agent ngữ cảnh bổ sung để giữ đúng hướng |
 
-`deny(message)` - tin nhắn xuất hiện với Claude với tiền tố `"Blocked by failproofai:"`. Một `deny` duy nhất sẽ làm ngắn mạch tất cả đánh giá tiếp theo.
+`deny(message)` - tin nhắn xuất hiện cho Claude với tiền tố `"Blocked by failproofai:"`. Một `deny` duy nhất sẽ ngắn mạch tất cả đánh giá tiếp theo.
 
-`instruct(message)` - tin nhắn được thêm vào ngữ cảnh của Claude cho cuộc gọi công cụ hiện tại. Tất cả các tin nhắn `instruct` được tích lũy và gửi cùng nhau.
+`instruct(message)` - tin nhắn đượ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 tin nhắn `instruct` được tích lũy và cung cấp cùng nhau.
 
 <Tip>
-Bạn có thể thêm hướng dẫn bổ sung vào bất kỳ tin nhắn `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 vậy. Xem [Configuration → hint](/vi/configuration#hint-cross-cutting) để biết chi tiết.
+Bạn có thể thêm hướng dẫn bổ sung vào bất kỳ tin nhắn `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 với 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 vậy. Xem [Configuration → hint](/vi/configuration#hint-cross-cutting) để biết thêm chi tiết.
 </Tip>
 
-### Tin nhắn allow mang tính thông tin
+### Tin nhắn cho phép thông tin
 
-`allow(message)` cho phép hoạt động **và** gửi lại một tin nhắn mang tính thông tin cho Claude. Tin nhắn được gửi dưới dạng `additionalContext` trong phản hồi stdout của trình xử lý hook — cùng một cơ chế được sử dụng bởi `instruct`, nhưng khác nhau về mặt ngữ nghĩa: đó là một bản cập nhật trạng thái, không phải một cảnh báo.
+`allow(message)` cho phép hoạt động **và** gửi một tin nhắn thông tin trở lại Claude. Tin nhắn được cung cấp dưới dạng `additionalContext` trong phản hồi stdout của trình xử lý hook — cơ chế tương tự được sử dụng bởi `instruct`, nhưng về mặt ngữ nghĩa khác: nó là một cập nhật trạng thái, không phải một cảnh báo.
 
-| Hàm | Hiệu ứng | Sử dụng khi |
+| Hàm | Tác dụng | Sử dụng khi |
 |----------|--------|----------|
-| `allow(message)` | Cho phép và gửi ngữ cảnh cho Claude | Xác nhận kiểm tra đã vượt qua, hoặc giải thích tại sao kiểm tra bị bỏ qua |
+| `allow(message)` | Cho phép và gửi ngữ cảnh cho Claude | Xác nhận một kiểm tra đã vượt qua, hoặc giải thích tại sao một kiểm tra bị bỏ qua |
 
-Trường hợp sử dụng:
-- **Xác nhận trạng thái:** `allow("All CI checks passed.")` — cho Claude biết tất cả đều xanh
-- **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ó bối cảnh đầy đủ
-- **Nhiều tin nhắn tích lũy:** nếu nhiều chính sách trả về `allow(message)`, tất cả các tin nhắn được nối với dòng mới và gửi cùng nhau
+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ứ đều ổn
+- **Giải thích fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — cho Claude biết tại sao một kiểm tra bị bỏ qua để nó có bối cảnh đầy đủ
+- **Nhiều tin nhắn tích lũy:** nếu nhiều chính sách mỗi cái trả về `allow(message)`, tất cả các tin nhắn được kết hợp với ngắt dòng và cung cấp cùng nhau
 
 ```js
 customPolicies.add({
@@ -157,30 +157,30 @@ customPolicies.add({
 
 ### Các trường `PolicyContext`
 
-| Trường | Kiểu | Mô tả |
+| Trường | Loại | Mô tả |
 |-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string \| undefined` | Công cụ đang được gọi (ví dụ: `"Bash"`, `"Write"`, `"Read"`) |
+| `toolName` | `string \| undefined` | Công cụ đang đượ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>` | Tải trọng sự kiện thô đầy đủ từ Claude Code |
-| `session` | `SessionMetadata \| undefined` | Ngữ cảnh phiên (xem bên dưới) |
+| `session` | `SessionMetadata \| undefined` | Ngữ cảnh phiên làm việc (xem bên dưới) |
 
 ### Các trường `SessionMetadata`
 
-| Trường | Kiểu | Mô tả |
+| Trường | Loại | Mô tả |
 |-------|------|-------------|
-| `sessionId` | `string` | Định danh phiên Claude Code |
+| `sessionId` | `string` | Định danh phiên làm việc Claude Code |
 | `cwd` | `string` | Thư mục làm việc của phiên Claude Code |
-| `transcriptPath` | `string` | Đường dẫn đến tệp bản ghi JSONL của phiên |
+| `transcriptPath` | `string` | Đường dẫn đến tệp bảng điểm JSONL của phiên |
 
 ### Các loại sự kiện
 
-| Sự kiện | Khi nó xảy ra | Nội dung `toolInput` |
+| Sự kiện | Khi nó kích hoạt | 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 một công cụ hoàn tất | Đầu vào của công cụ + `tool_result` (đầu ra) |
-| `Notification` | Khi Claude gửi thông báo | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - các hook 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 | Trống |
+| `PreToolUse` | Trước khi Claude chạy 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` (kết quả) |
+| `Notification` | Khi Claude gửi 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 |
 
 ---
 
@@ -188,20 +188,20 @@ customPolicies.add({
 
 Chính sách được đánh giá theo thứ tự này:
 
-1. Chính sách tích hợp sẵn (theo thứ tự định nghĩa)
-2. Chính sách tùy chỉnh tường minh từ `customPoliciesPath` (theo thứ tự `.add()`)
+1. Chính sách tích hợp (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, thứ tự `.add()` bên 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, thứ tự `.add()` bên trong)
 
 <Note>
-`deny` đầu tiên làm ngắn mạch tất cả các chính sách tiếp theo. Tất cả các tin nhắn `instruct` được tích lũy và gửi cùng nhau.
+`deny` đầu tiên sẽ ngắn mạch tất cả các chính sách tiếp theo. Tất cả các tin nhắn `instruct` được tích lũy và cung cấp cùng nhau.
 </Note>
 
 ---
 
-## Nhập khẩu Transitive
+## Imports truyền bá
 
-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 cách sử dụng đường dẫn tương đối:
+Các tệp chính sách tùy chỉnh có thể import các mô-đun cục bộ sử dụng đường dẫn tương đối:
 
 ```js
 // my-policies.js
@@ -218,13 +218,13 @@ customPolicies.add({
 });
 ```
 
-Tất cả các nhập khẩu tương đối có thể đạt được từ tệp mục nhập được phân giải. Điều này được triển khai bằng cách viết lại các nhập `from "failproofai"` đến đường dẫn dist thực tế và tạo tệp `.mjs` tạm thời để đảm bảo tính tương thích ESM.
+Tất cả các nhập tương đối có thể đạt được từ tệp mục nhập đều được giải quyết. Đ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 khả năng tương thích ESM.
 
 ---
 
-## Lọc loại sự kiện
+## Lọc theo loại sự kiện
 
-Sử dụng `match.events` để hạn chế khi chính sách kích hoạt:
+Sử dụng `match.events` để giới hạn khi nào một chính sách kích hoạt:
 
 ```js
 customPolicies.add({
@@ -238,26 +238,26 @@ customPolicies.add({
 });
 ```
 
-Bỏ qua `match` hoàn toàn để kích hoạt cho mọi loại sự kiện.
+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
+## Xử lý lỗi và chế độ hỏng
 
-Chính sách tùy chỉnh là **fail-open**: lỗi không bao giờ chặn các chính sách tích hợp sẵn hoặc làm xảy ra sự cố trình xử lý hook.
+Chính sách tùy chỉnh **fail-open**: lỗi không bao giờ chặn chính sách tích hợp 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 tường minh chạy; chính sách quy ước và 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`; tích hợp sẵn tiếp tục |
-| Lỗi cú pháp/nhập (tường minh) | Lỗi được ghi vào `~/.failproofai/hook.log`; chính sách tùy chỉnh tường minh 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 lỗi ở thời gian chạy | Lỗi được ghi; hook đó được coi là `allow`; các hook khác tiếp tục |
-| `fn` mất thời gian lâu hơn 10 giây | Hết thời gian được ghi; được coi là `allow` |
+| `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à tích hợp 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`; tích hợp tiếp tục |
+| Lỗi Syntax/import (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 Syntax/import (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 khi chạy | Lỗi được ghi; hook đó được coi là `allow`; các hook khác tiếp tục |
+| `fn` mất quá lâ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 theo dõi tệp nhật ký:
+Để gỡ lỗi lỗi chính sách tùy chỉnh, hãy theo dõi tệp nhật ký:
 
 ```bash
 tail -f ~/.failproofai/hook.log
@@ -328,17 +328,17 @@ 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 động 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 khẩu transitive, cuộc gọi không đồng bộ, scrubbing đầu ra, và các hook khi 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 chặ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, kiểm toán ghi tệp) |
+| `examples/policies-advanced/index.js` | Các mẫu nâng cao: nhập truyền bá, lệnh gọi async, scrubbing đầu ra, và hook 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 công việc dựa trên quy ước (nhắc nhở kiểm tra, tệp ghi kiểm toán) |
 
-### Sử dụng ví dụ tệp tường minh
+### Sử dụng các ví dụ tệp rõ ràng
 
 ```bash
 failproofai policies --install --custom ./examples/policies-basic.js
 ```
 
-### Sử dụng ví dụ dựa trên quy ước
+### Sử dụng các ví dụ dựa trên quy ước
 
 ```bash
 # Copy to project level
@@ -350,4 +350,4 @@ 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 nhặt lên tự động trên sự kiện hook tiếp theo.
+Không cần lệnh cài đặt — các tệp được nhận diện tự động trên hook event tiếp theo.

package/.next/standalone/docs/vi/examples.mdx

@@ -1,16 +1,17 @@
 ---
+---
 title: Ví dụ
 description: "Cách thiết lập hooks cho Claude Code và Agents SDK"
 icon: book-open
 ---
 
-Các ví dụ sẵn sàng sử dụng cho các tình huống phổ biến. Mỗi ví dụ cho thấy cách cài đặt và những gì bạn có thể mong đợi.
+Các ví dụ sẵn sàng sử dụng cho các tình huống phổ biến. Mỗi ví dụ cho thấy cách cài đặt và những gì mong đợi.
 
 ---
 
 ## Thiết lập hooks cho Claude Code
 
-Failproof AI tích hợp với Claude Code thông qua [hệ thống hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) của nó. Khi bạn chạy `failproofai policies --install`, nó sẽ đăng ký các lệnh hook trong `settings.json` của Claude Code để kích hoạt trên mỗi lệnh gọi công cụ.
+Failproof AI tích hợp với Claude Code thông qua [hệ thống hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Khi bạn chạy `failproofai policies --install`, nó sẽ đăng ký các lệnh hook trong `settings.json` của Claude Code, được kích hoạt trên mỗi lệnh gọi công cụ.
 
 <Steps>
   <Step title="Cài đặt failproofai">
@@ -23,7 +24,7 @@ Failproof AI tích hợp với Claude Code thông qua [hệ thống hooks](https
     failproofai policies --install
     ```
   </Step>
-  <Step title="Xác minh rằng hooks đã được đăng ký">
+  <Step title="Xác minh hooks đã được đăng ký">
     ```bash
     cat ~/.claude/settings.json | grep failproofai
     ```
@@ -35,7 +36,7 @@ Failproof AI tích hợp với Claude Code thông qua [hệ thống hooks](https
     claude
     ```
 
-    Các chính sách giờ đây chạy tự động trên mỗi lệnh gọi công cụ. Hãy thử yêu cầu Claude chạy `sudo rm -rf /` - nó sẽ bị chặn.
+    Các chính sách hiện chạy tự động trên mỗi lệnh gọi công cụ. Hãy thử yêu cầu Claude chạy `sudo rm -rf /` - nó sẽ bị chặn.
   </Step>
 </Steps>
 
@@ -43,7 +44,7 @@ Failproof AI tích hợp với Claude Code thông qua [hệ thống hooks](https
 
 ## Thiết lập hooks cho Agents SDK
 
-Nếu bạn đang xây dựng bằng [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), bạn có thể sử dụng hệ thống hook tương tự theo cách lập trình.
+Nếu bạn đang xây dựng với [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), bạn có thể sử dụng cùng một hệ thống hook theo cách lập trình.
 
 <Steps>
   <Step title="Cài đặt failproofai trong dự án của bạn">
@@ -52,25 +53,25 @@ Nếu bạn đang xây dựng bằng [Agents SDK](https://docs.anthropic.com/en/
     ```
   </Step>
   <Step title="Cấu hình hooks trong agent của bạn">
-    Truyền các lệnh hook khi tạo quy trình agent của bạn. Các hooks kích hoạt giống như trong Claude Code - thông qua JSON stdin/stdout:
+    Truyền các lệnh hook khi tạo quy trình agent của bạn. Các hooks được kích hoạt theo cách tương tự như trong Claude Code - thông qua stdin/stdout JSON:
 
     ```bash
-    failproofai --hook PreToolUse   # được gọi trước mỗi công cụ
-    failproofai --hook PostToolUse  # được gọi sau mỗi công cụ
+    failproofai --hook PreToolUse   # called before each tool
+    failproofai --hook PostToolUse  # called after each tool
     ```
   </Step>
-  <Step title="Viết một chính sách tùy chỉnh cho agent của bạn">
+  <Step title="Viết chính sách tùy chỉnh cho agent của bạn">
     ```javascript
     import { customPolicies, allow, deny } from "failproofai";
 
     customPolicies.add({
       name: "limit-to-project-dir",
-      description: "Giữ agent trong thư mục dự án",
+      description: "Keep the agent inside the project directory",
       match: { events: ["PreToolUse"] },
       fn: async (ctx) => {
         const path = String(ctx.toolInput?.file_path ?? "");
         if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
-          return deny("Agent bị hạn chế trong thư mục dự án");
+          return deny("Agent is restricted to the project directory");
         }
         return allow();
       },
@@ -86,51 +87,51 @@ Nếu bạn đang xây dựng bằng [Agents SDK](https://docs.anthropic.com/en/
 
 ---
 
-## Chặn các lệnh có tính chất phá hủy
+## Chặn các lệnh phá hủy
 
-Cấu hình phổ biến nhất - ngăn chặn agents thực hiện các thiệt hại không thể đảo ngược.
+Thiết lập phổ biến nhất - ngăn chặn các agent thực hiện các hành động không thể hoàn tác.
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
 ```
 
-Điều này làm gì:
+Điều này thực hiện:
 - `block-sudo` - chặn tất cả các lệnh `sudo`
 - `block-rm-rf` - chặn xóa tệp đệ quy
 - `block-force-push` - chặn `git push --force`
-- `block-curl-pipe-sh` - chặn ống dẫn các tập lệnh từ xa đến shell
+- `block-curl-pipe-sh` - chặn piping các kịch bản từ xa vào shell
 
 ---
 
 ## Ngăn chặn rò rỉ bí mật
 
-Dừng agents nhìn thấy hoặc rò rỉ thông tin xác thực trong kết quả đầu ra công cụ.
+Ngăn các agent nhìn thấy hoặc rò rỉ thông tin xác thực trong kết quả công cụ.
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-Những cái này kích hoạt trên `PostToolUse` - sau khi một công cụ chạy, chúng sẽ làm sạch kết quả đầu ra trước khi agent nhìn thấy.
+Những chính sách này được kích hoạt trên `PostToolUse` - sau khi công cụ chạy, chúng sẽ làm sạch kết quả trước khi agent nhìn thấy.
 
 ---
 
-## Nhận cảnh báo Slack khi agents cần chú ý
+## Nhận cảnh báo Slack khi các agent cần chú ý
 
-Sử dụng hook thông báo để chuyển tiếp cảnh báo nhàn rỗi đến Slack.
+Sử dụng hook thông báo để chuyển tiếp các cảnh báo chờ đợi đến Slack.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
 
 customPolicies.add({
   name: "slack-on-idle",
-  description: "Cảnh báo Slack khi agent đang chờ đầu vào",
+  description: "Alert Slack when the agent is waiting for input",
   match: { events: ["Notification"] },
   fn: async (ctx) => {
     const webhookUrl = process.env.SLACK_WEBHOOK_URL;
     if (!webhookUrl) return allow();
 
-    const message = String(ctx.payload?.message ?? "Agent đang chờ");
-    const project = ctx.session?.cwd ?? "không xác định";
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
 
     try {
       await fetch(webhookUrl, {
@@ -142,7 +143,7 @@ customPolicies.add({
         signal: AbortSignal.timeout(5000),
       });
     } catch {
-      // không bao giờ chặn agent nếu Slack không thể truy cập
+      // never block the agent if Slack is unreachable
     }
 
     return allow();
@@ -158,22 +159,22 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ---
 
-## Giữ agents trên một nhánh
+## Giữ các agent trên một nhánh
 
-Ngăn chặn agents từ việc chuyển đổi nhánh hoặc đẩy đến các nhánh được bảo vệ.
+Ngăn các agent chuyển đổi nhánh hoặc đẩy đến các nhánh được bảo vệ.
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
 
 customPolicies.add({
   name: "stay-on-branch",
-  description: "Ngăn chặn agent kiểm tra các nhánh khác",
+  description: "Prevent the agent from checking out other branches",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolName !== "Bash") return allow();
     const cmd = String(ctx.toolInput?.command ?? "");
     if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
-      return deny("Giữ trên nhánh hiện tại. Tạo một nhánh mới bằng -b nếu cần.");
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
     }
     return allow();
   },
@@ -184,20 +185,20 @@ customPolicies.add({
 
 ## Yêu cầu kiểm tra trước khi commit
 
-Nhắc nhở agents chạy các kiểm tra trước khi commit.
+Nhắc nhở các agent chạy các bài kiểm tra trước khi commit.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
 
 customPolicies.add({
   name: "test-before-commit",
-  description: "Nhắc nhở agent chạy các kiểm tra trước khi commit",
+  description: "Remind the agent to run tests before committing",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolName !== "Bash") return allow();
     const cmd = String(ctx.toolInput?.command ?? "");
     if (/git\s+commit/.test(cmd)) {
-      return instruct("Chạy các kiểm tra trước khi commit. Sử dụng `npm test` hoặc `bun test` trước tiên.");
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
     }
     return allow();
   },
@@ -206,9 +207,9 @@ customPolicies.add({
 
 ---
 
-## Khóa kho lưu trữ sản xuất
+## Khóa chặt kho lưu trữ production
 
-Commit một cấu hình ở cấp độ dự án để mỗi nhà phát triển trong đội của bạn nhận được các chính sách tương tự.
+Commit một cấu hình cấp dự án để mỗi nhà phát triển trong nhóm của bạn nhận được cùng các chính sách.
 
 Tạo `.failproofai/policies-config.json` trong kho lưu trữ của bạn:
 
@@ -238,16 +239,70 @@ git add .failproofai/policies-config.json
 git commit -m "Add failproofai team policies"
 ```
 
-Mỗi thành viên trong đội có failproofai được cài đặt sẽ tự động áp dụng các quy tắc này.
+Mỗi thành viên nhóm đã cài đặt failproofai sẽ tự động áp dụng các quy tắc này.
+
+---
+
+## Xây dựng tiêu chuẩn chất lượng trên toàn tổ chức với các chính sách quy ước
+
+Thiết lập có ảnh hưởng nhất: commit `.failproofai/policies/` vào kho lưu trữ của bạn với các chính sách được điều chỉnh cho dự án của bạn. Mỗi thành viên nhóm sẽ nhận được chúng tự động — không cần các lệnh cài đặt, không cần thay đổi cấu hình.
+
+<Steps>
+  <Step title="Tạo thư mục và thêm các chính sách">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Commit vào git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="Tiếp tục cải thiện">
+    Khi nhóm của bạn gặp phải các chế độ lỗi mới, thêm các chính sách và đẩy. Mọi người sẽ nhận được bản cập nhật trên `git pull` tiếp theo của họ. Những chính sách này trở thành một tiêu chuẩn chất lượng sống động phát triển cùng với nhóm của bạn.
+  </Step>
+</Steps>
 
 ---
 
-## Thêm ví dụ
+## Các ví dụ khác
 
 Thư mục [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) trong kho lưu trữ chứa:
 
-| Tệp | Những gì nó cho thấy |
+| Tệp | Nó cho thấy điều gì |
 |------|---------------|
-| `policies-basic.js` | Các chính sách khởi động - chặn ghi sản xuất, force-push, tập lệnh ống dẫn |
-| `policies-notification.js` | Cảnh báo Slack cho thông báo nhàn rỗi và kết thúc phiên |
-| `policies-advanced/index.js` | Nhập cũng từ các tệp khác, hooks không đồng bộ, làm sạch kết quả đầu ra PostToolUse, xử lý sự kiện Stop |
+| `policies-basic.js` | Các chính sách khởi động - chặn ghi production, force-push, kịch bản được piping |
+| `policies-notification.js` | Cảnh báo Slack cho các thông báo chờ đợi và kết thúc phiên |
+| `policies-advanced/index.js` | Các lần nhập chuyển tiếp, hooks không đồng bộ, làm sạch kết quả PostToolUse, xử lý sự kiện Stop |