failproofai 0.0.3 → 0.0.4-beta.0

package/.next/standalone/docs/ja/built-in-policies.mdx

@@ -1,16 +1,16 @@
 ---
 title: 組み込みポリシー
-description: "エージェントの一般的な失敗パターンを検出する30の組み込みポリシー"
+description: "エージェントのよくある失敗パターンを検出する30の組み込みポリシー"
 icon: shield
 ---
 
-failproofaiには、エージェントの一般的な失敗パターンを検出する30の組み込みポリシーが付属しています。各ポリシーは特定のフックイベントタイプとツール名に対して動作します。9つのポリシーはコードを書かずに動作を調整できるパラメータを受け付けます。4つのベータワークフローポリシーは、Claudeが停止する前にコミット → プッシュ → PR → CIのパイプラインを強制します。
+failproofai には、エージェントのよくある失敗パターンを検出する30の組み込みポリシーが付属しています。各ポリシーは特定のフックイベントタイプとツール名に対して発火します。9つのポリシーはコードを書かずに動作を調整できるパラメーターを受け付けます。4つのワークフローポリシーは、Claude が停止する前にコミット → プッシュ → PR → CI のパイプラインを強制します。
 
 ---
 
 ## 概要
 
-ポリシーはカテゴリにグループ化されています：
+ポリシーはカテゴリ別にグループ化されています：
 
 | カテゴリ | ポリシー | フックタイプ |
 |----------|----------|-----------|
@@ -21,37 +21,37 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 | [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
 | [データベース](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
 | [警告](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
-| [ワークフロー（ベータ）](#workflow-beta) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+| [ワークフロー](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
 
-- **`block-`** — エージェントの処理を停止させる。
-- **`warn-`** — エージェントが自己修正できるよう追加のコンテキストを提供する。
-- **`sanitize-`** — エージェントが参照する前にツール出力から機密データを除去する。
-- **`require-`** — 条件が満たされるまでStopイベントをブロックする。
+- **`block-`** — エージェントの処理を停止します。
+- **`warn-`** — エージェントが自己修正できるよう追加のコンテキストを提供します。
+- **`sanitize-`** — エージェントが参照する前に、ツールの出力から機密データを除去します。
+- **`require-`** — 条件が満たされるまで Stop イベントをブロックします。
 
 ---
 
 <Tip>
-すべてのポリシーは`policyParams`にオプションの`hint`フィールドをサポートしています。ヒントはClaudeが受け取るdenyまたはinstructメッセージに追加され、ポリシーコードを変更せずに実行可能なガイダンスを提供します。組み込み、カスタム、コンベンションポリシーのいずれでも使用できます。詳細は[設定 → hint](/ja/configuration#hint-cross-cutting)を参照してください。
+すべてのポリシーは `policyParams` にオプションの `hint` フィールドをサポートしています。hint は Claude が受け取る deny または instruct メッセージに追加され、ポリシーコードを変更することなく実用的なガイダンスを提供します。組み込み、カスタム、コンベンションポリシーいずれにも対応しています。詳細は [設定 → hint](/ja/configuration#hint-cross-cutting) を参照してください。
 </Tip>
 
 ---
 
-## 危険なコマンド {#dangerous-commands}
+## 危険なコマンド
 
-元に戻しにくい操作やホストシステムに損害を与える可能性のある操作をエージェントが実行するのを防ぎます。
+元に戻しにくい操作や、ホストシステムに損害を与える可能性のある操作をエージェントが実行するのを防ぎます。
 
 ### `block-sudo`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `sudo`コマンドを含む全コマンドを拒否。
+**デフォルト:** `sudo` コマンドを含む呼び出しをすべて拒否します。
 
-`sudo`キーワードを含む呼び出しをブロックします。パターンマッチングは生の文字列ではなく、パース済みのコマンドトークンに対して行われるため、シェル演算子インジェクションによるバイパスを防ぎます。
+`sudo` キーワードを含む呼び出しをブロックします。パターンマッチングは生の文字列ではなく、パース済みのコマンドトークンに対して行われるため、シェル演算子インジェクションによるバイパスを防止します。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
-| `allowPatterns` | `string[]` | `[]` | 許可するコマンドプレフィックス。各エントリはパース済みのargvトークンと照合されます。 |
+| `allowPatterns` | `string[]` | `[]` | 許可するコマンドの正確なプレフィックス。各エントリはパース済みの argv トークンと照合されます。 |
 
 **例:**
 
@@ -65,10 +65,10 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 }
 ```
 
-この設定では、`sudo systemctl status nginx`は許可されますが、`sudo rm /etc/hosts`は拒否されます。
+この設定では、`sudo systemctl status nginx` は許可されますが、`sudo rm /etc/hosts` は拒否されます。
 
 <Note>
-パターンは生のコマンド文字列ではなく、パース済みトークンと照合されます。これにより、シェル演算子を後付けすることによるバイパス（例：`sudo systemctl status x; rm -rf /`は`sudo systemctl status *`にマッチしない）を防ぎます。
+パターンはパース済みトークンと照合され、生のコマンド文字列とは照合されません。これにより、シェル演算子を付加したバイパス（例：`sudo systemctl status x; rm -rf /` は `sudo systemctl status *` にマッチしません）を防止します。
 </Note>
 
 ---
@@ -76,13 +76,13 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `block-rm-rf`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `rm -rf`、`rm -fr`、およびそれに類する再帰的削除の形式を拒否。
+**デフォルト:** `rm -rf`、`rm -fr`、およびそれに類する再帰的削除の形式を拒否します。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | 再帰的削除が許可されるパス（例：`/tmp`）。 |
+| `allowPaths` | `string[]` | `[]` | 再帰的削除が安全なパス（例：`/tmp`）。 |
 
 **例:**
 
@@ -101,42 +101,42 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `block-curl-pipe-sh`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `curl <url> | bash`、`curl <url> | sh`、`wget <url> | bash`、およびそれに類するパターンを拒否。
+**デフォルト:** `curl <url> | bash`、`curl <url> | sh`、`wget <url> | bash` などのパターンを拒否します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `block-failproofai-commands`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** failproofai自体をアンインストールまたは無効化しようとするコマンド（例：`npm uninstall failproofai`、`failproofai policies --uninstall`）を拒否。
+**デフォルト:** failproofai 自体をアンインストールまたは無効化するコマンド（例：`npm uninstall failproofai`、`failproofai policies --uninstall`）を拒否します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## シークレット（サニタイザー） {#secrets-sanitizers}
+## シークレット（サニタイザー）
 
-エージェントがコンテキストや出力に認証情報を漏洩させるのを防ぎます。サニタイザーポリシーは**PostToolUse**イベントで動作します。ClaudeがBashコマンドを実行したり、ファイルを読み込んだり、ツールを呼び出したりする際、これらのポリシーはClaudeに返される前に出力を検査します。シークレットパターンが検出された場合、ポリシーはdeny決定を返し、出力が返されるのを防ぎます。
+エージェントが認証情報をコンテキストや出力に漏洩するのを防ぎます。サニタイザーポリシーは **PostToolUse** イベントで発火します。Claude が Bash コマンドを実行したり、ファイルを読み取ったり、何らかのツールを呼び出したりすると、これらのポリシーは Claude に返される前に出力を検査します。シークレットのパターンが検出された場合、ポリシーは deny の決定を返し、出力が Claude に渡されるのを防ぎます。
 
 ### `sanitize-jwt`
 
-**イベント:** PostToolUse（全ツール）  
-**デフォルト:** JWTトークン（`.`で区切られた3つのbase64urlセグメント）を削除。
+**イベント:** PostToolUse (すべてのツール)  
+**デフォルト:** JWT トークン（`.` で区切られた3つの base64url セグメント）を編集します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `sanitize-api-keys`
 
-**イベント:** PostToolUse（全ツール）  
-**デフォルト:** 一般的なAPIキーフォーマットを削除: Anthropic（`sk-ant-`）、OpenAI（`sk-`）、GitHub PAT（`ghp_`）、AWSアクセスキー（`AKIA`）、Stripeキー（`sk_live_`、`sk_test_`）、Google APIキー（`AIza`）。
+**イベント:** PostToolUse (すべてのツール)  
+**デフォルト:** 一般的な API キーのフォーマットを編集します：Anthropic (`sk-ant-`)、OpenAI (`sk-`)、GitHub PAT (`ghp_`)、AWS アクセスキー (`AKIA`)、Stripe キー (`sk_live_`、`sk_test_`)、Google API キー (`AIza`)。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
 | `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | シークレットとして扱う追加の正規表現パターン。 |
 
@@ -159,69 +159,69 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 
 ### `sanitize-connection-strings`
 
-**イベント:** PostToolUse（全ツール）  
-**デフォルト:** 認証情報が埋め込まれたデータベース接続文字列（例：`postgresql://user:password@host/db`）を削除。
+**イベント:** PostToolUse (すべてのツール)  
+**デフォルト:** 認証情報が埋め込まれたデータベース接続文字列（例：`postgresql://user:password@host/db`）を編集します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `sanitize-private-key-content`
 
-**イベント:** PostToolUse（全ツール）  
-**デフォルト:** PEMブロック（`-----BEGIN PRIVATE KEY-----`、`-----BEGIN RSA PRIVATE KEY-----`など）を削除。
+**イベント:** PostToolUse (すべてのツール)  
+**デフォルト:** PEM ブロック（`-----BEGIN PRIVATE KEY-----`、`-----BEGIN RSA PRIVATE KEY-----` など）を編集します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `sanitize-bearer-tokens`
 
-**イベント:** PostToolUse（全ツール）  
-**デフォルト:** トークンが20文字以上の`Authorization: Bearer <token>`ヘッダーを削除。
+**イベント:** PostToolUse (すべてのツール)  
+**デフォルト:** トークンが20文字以上の `Authorization: Bearer <token>` ヘッダーを編集します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## 環境 {#environment}
+## 環境
 
-エージェントによる機密環境設定の読み取りや公開を防ぎます。
+エージェントによる機密の環境設定の読み取りや露出を防ぎます。
 
 ### `block-env-files`
 
 **イベント:** PreToolUse (Bash, Read)  
-**デフォルト:** `cat .env`や、ファイルパスに`.env`を指定したReadツール呼び出しなどによる`.env`ファイルの読み取りを拒否。
+**デフォルト:** `cat .env` や `.env` をファイルパスとした `Read` ツールの呼び出しなど、`.env` ファイルの読み取りを拒否します。
 
-`.envrc`やその他の環境関連ファイルはブロックせず、厳密に`.env`という名前のファイルのみブロックします。
+`.envrc` や他の環境関連ファイルはブロックせず、`.env` という名前のファイルのみをブロックします。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `protect-env-vars`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `printenv`、`env`、`echo $VAR`などの環境変数を表示するコマンドを拒否。
+**デフォルト:** `printenv`、`env`、`echo $VAR` など、環境変数を表示するコマンドを拒否します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## ファイルアクセス {#file-access}
+## ファイルアクセス
 
-エージェントをプロジェクトの境界内に留め、機密ファイルへのアクセスを防ぎます。
+エージェントをプロジェクト境界内に留め、機密ファイルへのアクセスを防ぎます。
 
 ### `block-read-outside-cwd`
 
 **イベント:** PreToolUse (Read, Bash)  
-**デフォルト:** カレントワーキングディレクトリ（プロジェクトルート）外のファイル読み取りを拒否。
+**デフォルト:** 現在の作業ディレクトリ（プロジェクトルート）外のファイルの読み取りを拒否します。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | cwdの外であっても許可する絶対パスのプレフィックス。 |
+| `allowPaths` | `string[]` | `[]` | cwd 外であっても許可する絶対パスのプレフィックス。 |
 
 **例:**
 
@@ -240,11 +240,11 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `block-secrets-write`
 
 **イベント:** PreToolUse (Write, Edit)  
-**デフォルト:** 秘密鍵と証明書によく使われるファイルへの書き込みを拒否: `id_rsa`、`id_ed25519`、`*.key`、`*.pem`、`*.p12`、`*.pfx`。
+**デフォルト:** 秘密鍵や証明書によく使われるファイルへの書き込みを拒否します：`id_rsa`、`id_ed25519`、`*.key`、`*.pem`、`*.p12`、`*.pfx`。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
 | `additionalPatterns` | `string[]` | `[]` | ブロックする追加のファイル名パターン（グロブ形式）。 |
 
@@ -262,18 +262,18 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 
 ---
 
-## Git {#git}
+## Git
 
-元に戻しにくい誤ったプッシュ、フォースプッシュ、ブランチ操作を防ぎます。
+元に戻しにくい誤ったプッシュ、フォースプッシュ、ブランチの操作ミスを防ぎます。
 
 ### `block-push-master`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `git push origin main`および`git push origin master`を拒否。
+**デフォルト:** `git push origin main` と `git push origin master` を拒否します。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
 | `protectedBranches` | `string[]` | `["main", "master"]` | 直接プッシュできないブランチ名。 |
 
@@ -290,7 +290,7 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ```
 
 <Tip>
-全ブランチへのプッシュを許可する（`enabledPolicies`からこのポリシーを削除せずに実質的に無効化する）には、`protectedBranches: []`に設定します。
+すべてのブランチへのプッシュを許可する（`enabledPolicies` からポリシーを削除せずに実質的に無効化する）には、`protectedBranches: []` を設定してください。
 </Tip>
 
 ---
@@ -298,11 +298,11 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `block-work-on-main`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `main`または`master`ブランチへの直接チェックアウトを拒否。
+**デフォルト:** `main` または `master` ブランチへの直接チェックアウトを拒否します。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
 | `protectedBranches` | `string[]` | `["main", "master"]` | 直接チェックアウトできないブランチ名。 |
 
@@ -311,9 +311,9 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `block-force-push`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `git push --force`および`git push -f`を拒否。
+**デフォルト:** `git push --force` と `git push -f` を拒否します。
 
-ポリシー固有のパラメータはありません。クロスカッティングの[`hint`](/ja/configuration#hint-cross-cutting)を使って代替手段を提案できます：
+ポリシー固有のパラメーターはありません。クロスカッティングの [`hint`](/ja/configuration#hint-cross-cutting) を使用して代替手段を提案できます：
 
 ```json
 {
@@ -330,66 +330,66 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `warn-git-amend`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `git commit --amend`を実行する際に注意して進むようClaudeに指示。コマンドはブロックしません。
+**デフォルト:** `git commit --amend` を実行する際に慎重に進むよう Claude に指示します。コマンドはブロックしません。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `warn-git-stash-drop`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `git stash drop`を実行する前に確認するようClaudeに指示。コマンドはブロックしません。
+**デフォルト:** `git stash drop` を実行する前に確認するよう Claude に指示します。コマンドはブロックしません。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `warn-all-files-staged`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `git add -A`または`git add .`を実行する際にステージングする内容を確認するようClaudeに指示。コマンドはブロックしません。
+**デフォルト:** `git add -A` または `git add .` を実行する際に、ステージングする内容を確認するよう Claude に指示します。コマンドはブロックしません。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## データベース {#database}
+## データベース
 
-データベースに対して実行される前に破壊的なSQL操作を検出します。
+データベースに対して実行される前に、破壊的な SQL 操作を検出します。
 
 ### `warn-destructive-sql`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `DROP TABLE`、`DROP DATABASE`、または`WHERE`句のない`DELETE`を含むSQLを実行する前に確認するようClaudeに指示。
+**デフォルト:** `DROP TABLE`、`DROP DATABASE`、または `WHERE` 句のない `DELETE` を含む SQL を実行する前に確認するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `warn-schema-alteration`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `ALTER TABLE`ステートメントを実行する前に確認するようClaudeに指示。
+**デフォルト:** `ALTER TABLE` 文を実行する前に確認するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## 警告 {#warnings}
+## 警告
 
-潜在的にリスクはあるものの非破壊的な操作の前に、エージェントに追加のコンテキストを提供します。
+破壊的ではないが潜在的にリスクのある操作を行う前に、エージェントに追加のコンテキストを提供します。
 
 ### `warn-large-file-write`
 
 **イベント:** PreToolUse (Write)  
-**デフォルト:** 1024 KBを超えるファイルを書き込む前に確認するようClaudeに指示。
+**デフォルト:** 1024 KB を超えるファイルを書き込む前に確認するよう Claude に指示します。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
-| `thresholdKb` | `number` | `1024` | 警告を発するファイルサイズのしきい値（キロバイト単位）。 |
+| `thresholdKb` | `number` | `1024` | 警告が発行されるファイルサイズの閾値（キロバイト）。 |
 
 **例:**
 
@@ -404,7 +404,7 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ```
 
 <Note>
-フックハンドラーはペイロードに1 MBのstdin制限を適用します。小さなコンテンツでこのポリシーをテストするには、`thresholdKb`を1024よりもかなり小さい値に設定してください。
+フックハンドラーはペイロードに対して 1 MB の stdin 制限を適用します。小さなコンテンツでこのポリシーをテストするには、`thresholdKb` を 1024 より十分に小さい値に設定してください。
 </Note>
 
 ---
@@ -412,66 +412,66 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `warn-package-publish`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `npm publish`を実行する前に確認するようClaudeに指示。
+**デフォルト:** `npm publish` を実行する前に確認するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `warn-background-process`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `nohup`、`&`、`disown`、`screen`などでバックグラウンドプロセスを起動する際に注意するようClaudeに指示。
+**デフォルト:** `nohup`、`&`、`disown`、`screen` を使用してバックグラウンドプロセスを起動する際に注意するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `warn-global-package-install`
 
 **イベント:** PreToolUse (Bash)  
-**デフォルト:** `npm install -g`、`yarn global add`、または仮想環境なしの`pip install`を実行する前に確認するようClaudeに指示。
+**デフォルト:** `npm install -g`、`yarn global add`、または仮想環境なしの `pip install` を実行する前に確認するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## AIの動作
+## AI の動作
 
-エージェントが行き詰まったり予期しない動作をしたりしているときに検出します。
+エージェントが行き詰まっているか予期しない動作をしているかを検出します。
 
 ### `warn-repeated-tool-calls`
 
-**イベント:** PreToolUse（全ツール）  
-**デフォルト:** 同じツールが同一のパラメータで3回以上呼び出された場合（エージェントがループに陥っているよくあるサイン）に、再考するようClaudeに指示。
+**イベント:** PreToolUse (すべてのツール)  
+**デフォルト:** 同じツールが同じパラメーターで3回以上呼び出された場合（エージェントがループで行き詰まっている一般的なサイン）に、再考するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
-## ワークフロー（ベータ） {#workflow-beta}
+## ワークフロー
 
-セッション終了時の規律あるワークフローを強制します。これらのポリシーは**Stop**イベントで動作し、各条件が満たされるまでClaudeの停止を拒否します。コミット → プッシュ → PR → CIという自然な依存関係チェーンに従います。ポリシーが拒否した場合、チェーン内の後続ポリシーはスキップされます（denyは短絡評価）。
+セッション終了時の規律あるワークフローを強制します。これらのポリシーは **Stop** イベントで発火し、各条件が満たされるまで Claude の停止を拒否します。コミット → プッシュ → PR → CI という自然な依存関係の連鎖に従います。ポリシーが拒否すると、チェーン内の後続ポリシーはスキップされます（deny でショートサーキット）。
 
-すべてのワークフローポリシーは**フェイルオープン**です：必要なツールが利用できない場合（例：`gh`がインストールされていない、gitリモートがない）、ポリシーはチェックがスキップされた理由を説明する情報メッセージとともに許可します。
+すべてのワークフローポリシーは **フェイルオープン** です：必要なツールが利用できない場合（例：`gh` がインストールされていない、git リモートがない）、ポリシーはチェックがスキップされた理由を説明する情報メッセージとともに許可します。
 
 ### `require-commit-before-stop`
 
 **イベント:** Stop  
-**デフォルト:** コミットされていない変更（変更済み、ステージング済み、または未追跡ファイル）がある場合に停止を拒否。ワーキングディレクトリがクリーンな場合は情報メッセージを返します。
+**デフォルト:** コミットされていない変更（変更済み、ステージ済み、または未追跡のファイル）がある場合に停止を拒否します。作業ディレクトリがクリーンな場合は情報メッセージを返します。
 
-パラメータなし。
+パラメーターなし。
 
 ---
 
 ### `require-push-before-stop`
 
 **イベント:** Stop  
-**デフォルト:** プッシュされていないコミットがある場合、または現在のブランチにリモートトラッキングブランチがない場合に停止を拒否。必要に応じてトラッキングブランチを作成するために`git push -u`を提案します。リモートが設定されていない場合はフェイルオープン。
+**デフォルト:** プッシュされていないコミットがある場合、または現在のブランチにリモートトラッキングブランチがない場合に停止を拒否します。必要に応じてトラッキングブランチを作成するための `git push -u` を提案します。リモートが設定されていない場合はフェイルオープンします。
 
-**パラメータ:**
+**パラメーター:**
 
-| パラメータ | 型 | デフォルト | 説明 |
+| パラメーター | 型 | デフォルト | 説明 |
 |-------|------|---------|-------------|
 | `remote` | `string` | `"origin"` | プッシュ先のリモート名。 |
 
@@ -492,13 +492,13 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `require-pr-before-stop`
 
 **イベント:** Stop  
-**デフォルト:** 現在のブランチにプルリクエストが存在しない場合、または既存のPRがクローズ/マージ済みの場合に停止を拒否。`gh pr create`でPRを作成するようClaudeに指示します。
+**デフォルト:** 現在のブランチにプルリクエストが存在しない場合、または既存の PR がクローズ/マージ済みの場合に停止を拒否します。`gh pr create` で PR を作成するよう Claude に指示します。
 
-パラメータなし。
+パラメーターなし。
 
 <Note>
-このポリシーは[GitHub CLI](https://cli.github.com/)（`gh`）がインストールされ、認証済みである必要があります。
-プルリクエストへの読み取りアクセスに`repo`スコープを持つパーソナルアクセストークンで`gh auth login`を実行してください。`gh`がインストールされていないか認証されていない場合、ポリシーはフェイルオープンとなり、その理由をClaudeに報告します。
+このポリシーには [GitHub CLI](https://cli.github.com/)（`gh`）のインストールと認証が必要です。
+プルリクエストへの読み取りアクセスのために `repo` スコープを持つパーソナルアクセストークンで `gh auth login` を実行してください。`gh` がインストールされていないか認証されていない場合、ポリシーはフェイルオープンし、その理由を Claude に報告します。
 </Note>
 
 ---
@@ -506,49 +506,22 @@ failproofaiには、エージェントの一般的な失敗パターンを検出
 ### `require-ci-green-before-stop`
 
 **イベント:** Stop  
-**デフォルト:** 現在のブランチでCIチェックが失敗または実行中の場合に停止を拒否。GitHub Actionsのワークフロー実行とサードパーティのボットチェック（例：CodeRabbit、SonarCloud、Codecov）の両方を確認します。`skipped`の結論は成功として扱います。すべてのチェックが通過した場合は情報メッセージを返します。
+**デフォルト:** 現在のブランチで CI チェックが失敗しているか、まだ実行中の場合に停止を拒否します。GitHub Actions のワークフロー実行とサードパーティのボットチェック（CodeRabbit、SonarCloud、Codecov など）の両方を確認します。`skipped` の結論は成功として扱います。すべてのチェックが通過した場合は情報メッセージを返します。
 
-パラメータなし。
+パラメーターなし。
 
 <Note>
-このポリシーは[GitHub CLI](https://cli.github.com/)（`gh`）がインストールされ、認証済みである必要があります。
-ActionsワークフローランとChecks APIへの読み取りアクセスに`repo`スコープを持つパーソナルアクセストークンで`gh auth login`を実行してください。`gh`がインストールされていないか認証されていない場合、ポリシーはフェイルオープンとなり、その理由をClaudeに報告します。
+このポリシーには [GitHub CLI](https://cli.github.com/)（`gh`）のインストールと認証が必要です。
+Actions ワークフロー実行および Checks API への読み取りアクセスのために `repo` スコープを持つパーソナルアクセストークンで `gh auth login` を実行してください。`gh` がインストールされていないか認証されていない場合、ポリシーはフェイルオープンし、その理由を Claude に報告します。
 </Note>
 
 ---
 
-## ベータポリシー
-
-一部のポリシーは`beta`とマークされており、デフォルトではインストールされません。ベータポリシーは粗削りな部分があったり、誤検知が発生する場合があります。将来のリリースで安定版に昇格します。
-
-**現在のベータポリシー:**
-
-- `require-commit-before-stop` — 停止前にすべての変更をコミット
-- `require-push-before-stop` — すべてのコミットをリモートにプッシュ
-- `require-pr-before-stop` — ブランチのPRが存在することを確認
-- `require-ci-green-before-stop` — すべてのCIチェックが通過している必要がある
-
-これらを組み合わせることで、**コミット → プッシュ → PR → CI**ワークフローを強制します。
-
-すべてのベータポリシーをインストールするには:
-
-```bash
-failproofai policies --install --beta
-```
-
-または特定のワークフローポリシーをインストールするには:
-
-```bash
-failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
-```
-
-`failproofai policies`を実行して、どのポリシーにベータフラグが付いているか確認できます。
-
 ---
 
 ## 個別ポリシーの無効化
 
-設定の`enabledPolicies`から特定のポリシーを削除するか、ダッシュボードのPoliciesタブでオフに切り替えます。
+設定の `enabledPolicies` から特定のポリシーを削除するか、ダッシュボードの「ポリシー」タブでオフに切り替えてください。
 
 ```json
 {
@@ -559,4 +532,4 @@ failproofai policies --install require-commit-before-stop require-push-before-st
 }
 ```
 
-`enabledPolicies`にリストされていないポリシーは、`policyParams`にエントリが存在しても実行されません。
+`enabledPolicies` に記載されていないポリシーは、`policyParams` にエントリが存在していても実行されません。

package/.next/standalone/docs/ja/cli/install-policies.mdx

@@ -7,42 +7,41 @@ description: "エージェントのツール呼び出しごとにポリシーが
 failproofai policies --install [policy-names...] [options]
 ```
 
-Claude Code の `settings.json` にフックエントリを書き込み、failproofai がツール呼び出しをインターセプトできるようにします。
+Claude Code の `settings.json` にフックエントリを書き込み、failproofai がツール呼び出しを横断できるようにします。
 
 エイリアス: `failproofai p -i`
 
 ## オプション
 
 | フラグ | 説明 |
-|------|-------------|
-| `--scope user` | `~/.claude/settings.json` にインストール（デフォルト - 全セッション対象） |
+|--------|------|
+| `--scope user` | `~/.claude/settings.json` にインストール（デフォルト - すべてのセッションに適用） |
 | `--scope project` | カレントディレクトリの `.claude/settings.json` にインストール |
 | `--scope local` | カレントディレクトリの `.claude/settings.local.json` にインストール |
 | `--custom <path>` / `-c` | カスタムフックポリシーを含む JS ファイルへのパス |
-| `--beta` | ベータ版ポリシーを含める |
 
 ## 動作
 
-- **ポリシー名なし** - ポリシーを選択するための対話型プロンプトを開く
-- **特定の名前を指定** - 指定したポリシーを有効化（既に有効なものに追加）
-- **`all`** - 利用可能なすべてのポリシーを有効化
+- **ポリシー名の指定なし** - ポリシーを選択するインタラクティブなプロンプトを開きます
+- **特定の名前を指定** - 指定したポリシーを有効化します（すでに有効なポリシーに追加されます）
+- **`all`** - 利用可能なすべてのポリシーを有効化します
 
-インストールは追記型です。`--install` を再度実行しても、既存のポリシーは削除されず、新しいポリシーが追加されます。
+インストールは追加的に動作します。`--install` を再度実行すると、既存のポリシーを削除せずに新しいポリシーが追加されます。
 
-## 使用例
+## 例
 
 ```bash
-# すべてのデフォルトポリシーをグローバルにインストール（対話形式）
+# デフォルトポリシーをすべてグローバルにインストール（インタラクティブ）
 failproofai policies --install
 
 # 特定のポリシーを現在のプロジェクトにインストール
 failproofai policies --install block-sudo sanitize-api-keys --scope project
 
-# すべてのポリシーを一括で有効化
+# すべてのポリシーを一度に有効化
 failproofai policies --install all
 
-# カスタムポリシーファイルを指定してインストール
+# カスタムポリシーファイルを使ってインストール
 failproofai policies --install --custom ./my-policies.js
 ```
 
-`--custom <path>` を指定した場合、ファイルは即座に検証されます。少なくとも一度 `customPolicies.add()` を呼び出している必要があります。解決されたパスは `customPoliciesPath` として `policies-config.json` に保存されます。
+`--custom <path>` を指定すると、ファイルは即座に検証されます。少なくとも 1 回 `customPolicies.add()` を呼び出している必要があります。解決されたパスは `policies-config.json` に `customPoliciesPath` として保存されます。