failproofai 0.0.6-beta.1 → 0.0.6-beta.2

package/.next/standalone/docs/vi/getting-started.mdx

@@ -1,6 +1,6 @@
 ---
 title: Bắt đầu
-description: "Cài đặt failproofai, bật các chính sách và cho phép các agent của bạn chạy một cách đáng tin cậy"
+description: "Cài đặt failproofai, kích hoạt các chính sách, và để các agent của bạn chạy một cách đáng tin cậy"
 icon: rocket
 ---
 
@@ -27,17 +27,17 @@ bun add -g failproofai
 
 ---
 
-## Bắt đầu nhanh
+## Hướng dẫn nhanh
 
 <Steps>
-  <Step title="Bật các chính sách">
-    Các chính sách là những quy tắc chạy trước và sau mỗi lời gọi công cụ của agent. Chúng bắt các lệnh có tính phá hủy, rò rỉ thông tin bí mật và các kiểu lỗi khác trước khi gây hại.
+  <Step title="Kích hoạt các chính sách">
+    Các chính sách là các quy tắc chạy trước và sau mọi lệnh gọi công cụ của agent. Chúng bắt các lệnh có tính hủy diệt, rò rỉ bí mật, và các chế độ lỗi khác trước khi gây thiệt hại.
 
     ```bash
     failproofai policies --install
     ```
 
-    Điều này ghi các mục hook vào `settings.json` của Claude Code. Bạn cũng có thể cài đặt cho một dự án duy nhất hoặc chọn các chính sách cụ thể:
+    Lệnh này viết các mục hook vào `settings.json` của Claude Code. Bạn cũng có thể cài đặt cho một dự án duy nhất hoặc chọn các chính sách cụ thể:
 
     ```bash
     failproofai policies --install --scope project
@@ -49,17 +49,17 @@ bun add -g failproofai
     failproofai policies
     ```
 
-    Hiển thị mọi chính sách, liệu nó có được bật hay không và bất kỳ tham số nào được cấu hình.
+    Hiển thị mọi chính sách, liệu nó có được bật hay không, và bất kỳ tham số được cấu hình nào.
   </Step>
   <Step title="Khởi chạy bảng điều khiển">
     ```bash
     failproofai
     ```
 
-    Mở bảng điều khiển cục bộ tại `http://localhost:8020` nơi bạn có thể duyệt phiên, kiểm tra các lời gọi công cụ và quản lý các chính sách.
+    Mở một bảng điều khiển cục bộ tại `http://localhost:8020` nơi bạn có thể duyệt qua các phiên, kiểm tra các lệnh gọi công cụ, và quản lý các chính sách.
   </Step>
   <Step title="Chạy agent của bạn">
-    Khởi động Claude Code như bình thường. Nếu agent cố gắng làm điều gì đó rủi ro, failproofai sẽ chặn nó tự động. Hãy để nó chạy không giám sát và xem xét những gì đã xảy ra trong bảng điều khiển.
+    Khởi chạy Claude Code như bình thường. Nếu agent cố gắng làm điều gì đó riskу, failproofai sẽ chặn nó tự động. Để nó chạy mà không cần giám sát và xem xét những gì đã xảy ra trong bảng điều khiển.
   </Step>
 </Steps>
 
@@ -70,33 +70,85 @@ bun add -g failproofai
 Mỗi khi một agent chạy một công cụ, Claude Code gọi failproofai như một tiến trình con:
 
 ```text
-Claude Code  →  failproofai --hook PreToolUse  →  đọc JSON từ stdin
-                                                 đánh giá các chính sách
-                                                 ghi quyết định vào stdout
+Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
+                                                 evaluates policies
+                                                 writes decision to stdout
 ```
 
 Mỗi chính sách trả về một trong ba quyết định:
 
 - **allow** - agent tiếp tục bình thường
 - **deny** - hành động bị chặn, agent được thông báo lý do
-- **instruct** - bối cảnh bổ sung được thêm vào lời nhắc của agent
+- **instruct** - ngữ cảnh bổ sung được thêm vào prompt của agent
 
 <Note>
-Các chính sách chạy trong quy trình cục bộ của bạn. Không có gì được gửi đến một dịch vụ từ xa.
+Các chính sách chạy trong quy trình cục bộ của bạn. Không có gì được gửi đến dịch vụ từ xa.
 </Note>
 
 ---
 
+## Thiết lập chính sách nhóm với chính sách dựa trên quy ước
+
+Cách nhanh nhất để thiết lập tiêu chuẩn chất lượng trên toàn nhóm là quy ước `.failproofai/policies/`. Đặt các tệp chính sách vào thư mục này và chúng sẽ được tải tự động — không có cờ, không có thay đổi cấu hình, không có lệnh cài đặt.
+
+<Steps>
+  <Step title="Tạo thư mục chính sách">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Thêm tệp chính sách">
+    Sao chép các ví dụ khởi đầu hoặc viết của riêng bạn:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Hoặc tạo một cái mới:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    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"
+    ```
+
+    Mỗi thành viên nhóm đã cài đặt failproofai sẽ chọn các chính sách này tự động. Không cần thiết lập cho mỗi nhà phát triển.
+  </Step>
+</Steps>
+
+<Tip>
+Commit `.failproofai/policies/` vào kho lưu trữ của bạn để toàn bộ nhóm chia sẻ cùng một tiêu chuẩn. Khi nhóm của bạn phát hiện các chế độ lỗi mới, hãy thêm chính sách và đẩy — mọi người sẽ nhận bản cập nhật trên `git pull` tiếp theo của họ. 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 tiếp tục cải thiện.
+</Tip>
+
+---
+
 ## Lưu trữ dữ liệu
 
-Tất cả cấu hình và nhật ký nằm trên máy của bạn:
+Tất cả cấu hình và nhật ký được giữ trên máy của bạn:
 
-| Đường dẫn | Những gì nó lưu trữ |
+| Đường dẫn | Nội dung lưu trữ |
 |------|----------------|
 | `~/.failproofai/policies-config.json` | Cấu hình chính sách toàn cục |
 | `~/.failproofai/hook-activity.jsonl` | Lịch sử thực thi hook |
-| `~/.failproofai/hook.log` | Nhật ký gỡ lỗi cho các lỗi hook tùy chỉnh |
-| `.failproofai/policies-config.json` | Cấu hình cho từng dự án (được cam kết) |
+| `~/.failproofai/hook.log` | Nhật ký gỡ lỗi cho lỗi hook tùy chỉnh |
+| `.failproofai/policies-config.json` | Cấu hình cho mỗi dự án (được commit) |
 | `.failproofai/policies-config.local.json` | Ghi đè cá nhân (gitignored) |
 
 ---
@@ -119,16 +171,16 @@ Xóa các mục hook khỏi `~/.claude/settings.json`. Các tệp cấu hình tr
   Phạm vi và định dạng tệp cấu hình
 </Card>
 
-<Card title="Chính sách tích hợp" icon="shield" href="/vi/built-in-policies">
-  Tất cả 26 chính sách với tham số
+<Card title="Chính sách tích hợp sẵn" icon="shield" href="/vi/built-in-policies">
+  Tất cả 26 chính sách với các tham số
 </Card>
 
 <Card title="Chính sách tùy chỉnh" icon="code" href="/vi/custom-policies">
-  Viết các chính sách của riêng bạn bằng JavaScript
+  Viết các chính sách riêng của bạn bằng JavaScript
 </Card>
 
-<Card title="Trình giám sát agent" icon="chart-line" href="/vi/dashboard">
-  Giám sát phiên và xem xét hoạt động của chính sách
+<Card title="Bộ giám sát agent" icon="chart-line" href="/vi/dashboard">
+  Giám sát các phiên và xem lại hoạt động chính sách
 </Card>
 
 </CardGroup>