failproofai 0.0.5 → 0.0.6-beta.1

package/.next/standalone/docs/ja/architecture.mdx

@@ -1,21 +1,21 @@
 ---
 title: アーキテクチャ
-description: "フックハンドラー、設定の読み込み、ポリシー評価が内部でどのように機能するか"
+description: "フックハンドラー、設定の読み込み、ポリシー評価の内部動作について"
 icon: sitemap
 ---
 
-このドキュメントでは、failproofai の内部動作を説明します。フックシステムがエージェントのツール呼び出しをどのようにインターセプトするか、設定がどのように読み込まれてマージされるか、ポリシーがどのように評価されるか、そしてダッシュボードがエージェントの活動をどのように監視するかについて解説します。
+このドキュメントでは、failproofai の内部動作を説明します。フックシステムがエージェントのツール呼び出しをどのようにインターセプトするか、設定がどのように読み込まれてマージされるか、ポリシーがどのように評価されるか、そしてダッシュボードがエージェントのアクティビティをどのように監視するかについて解説します。
 
 ---
 
 ## 概要
 
-failproofai には2つの独立したサブシステムがあります。
+failproofai には独立した2つのサブシステムがあります。
 
-1. **フックハンドラー** - Claude Code がエージェントのすべてのツール呼び出し時に起動する高速な CLI サブプロセス。ポリシーを評価し、決定を返します。
-2. **エージェントモニター（ダッシュボード）** - エージェントセッションの監視とポリシー管理を行う Next.js ウェブアプリケーション。
+1. **フックハンドラー** - Claude Code がエージェントのツール呼び出しのたびに起動する高速な CLI サブプロセスです。ポリシーを評価して判断結果を返します。
+2. **エージェントモニター（ダッシュボード）** - エージェントセッションの監視とポリシー管理のための Next.js ウェブアプリケーションです。
 
-どちらのサブシステムも `~/.failproofai/` およびプロジェクトの `.failproofai/` ディレクトリにある設定ファイルを共有しますが、それぞれ独立したプロセスとして動作し、ファイルシステムを通じてのみ通信します。
+両サブシステムは `~/.failproofai/` とプロジェクトの `.failproofai/` ディレクトリにある設定ファイルを共有しますが、別々のプロセスとして動作し、ファイルシステムを通じてのみ通信します。
 
 ---
 
@@ -23,7 +23,7 @@ failproofai には2つの独立したサブシステムがあります。
 
 ### Claude Code との統合
 
-`failproofai policies --install` を実行すると、以下のようなエントリが `~/.claude/settings.json` に書き込まれます。
+`failproofai policies --install` を実行すると、`~/.claude/settings.json` に次のようなエントリが書き込まれます。
 
 ```json
 {
@@ -44,9 +44,9 @@ failproofai には2つの独立したサブシステムがあります。
 }
 ```
 
-Claude Code は各ツール呼び出しの前に `failproofai --hook PreToolUse` をサブプロセスとして起動し、stdin に JSON ペイロードを渡します。
+Claude Code はその後、各ツール呼び出しの前に `failproofai --hook PreToolUse` をサブプロセスとして起動し、stdin に JSON ペイロードを渡します。
 
-### ペイロードの形式
+### ペイロード形式
 
 ```json
 {
@@ -62,11 +62,11 @@ Claude Code は各ツール呼び出しの前に `failproofai --hook PreToolUse`
 
 `PostToolUse` イベントの場合、ペイロードにはツールの出力を含む `tool_result` も含まれます。
 
-ハンドラーは stdin の上限を 1 MB に制限しています。これを超えるペイロードは破棄され、すべてのポリシーは暗黙的に allow となります。
+ハンドラーは stdin に対して 1 MB の上限を適用します。これを超えるペイロードは破棄され、すべてのポリシーは暗黙的に allow となります。
 
-### レスポンスの形式
+### レスポンス形式
 
-**Deny（PreToolUse）:**
+**Deny（PreToolUse）：**
 ```json
 {
   "hookSpecificOutput": {
@@ -76,7 +76,7 @@ Claude Code は各ツール呼び出しの前に `failproofai --hook PreToolUse`
 }
 ```
 
-**Deny（PostToolUse）:**
+**Deny（PostToolUse）：**
 ```json
 {
   "hookSpecificOutput": {
@@ -85,7 +85,7 @@ Claude Code は各ツール呼び出しの前に `failproofai --hook PreToolUse`
 }
 ```
 
-**Instruct（Stop 以外のすべてのイベント）:**
+**Instruct（Stop 以外の任意のイベント）：**
 ```json
 {
   "hookSpecificOutput": {
@@ -94,52 +94,52 @@ Claude Code は各ツール呼び出しの前に `failproofai --hook PreToolUse`
 }
 ```
 
-**Stop イベントの instruct:**
-- 終了コード: `2`
+**Stop イベントの instruct：**
+- 終了コード：`2`
 - 理由は stdout ではなく stderr に書き込まれます
 
-**Allow:**
-- 終了コード: `0`
+**Allow：**
+- 終了コード：`0`
 - stdout は空
 
-**メッセージ付き Allow:**
+**メッセージ付き Allow：**
 
-`allow(message)` を使用することで、操作が許可されている場合でもポリシーが Claude に情報コンテキストを返せるようになりました。フックハンドラーは以下の JSON を **stdout** に書き込みます（設定ファイルではありません。上記の deny や instruct のレスポンスと同様に、Claude Code へのハンドラープロセスのレスポンスです）。
+`allow(message)` を使うと、操作が許可されている場合でも、ポリシーが Claude に情報コンテキストを返せます。フックハンドラーは以下の JSON を **stdout** に書き込みます（設定ファイルではなく、上記の deny や instruct レスポンスと同様に、ハンドラープロセスから Claude Code へのレスポンスです）。
 
 ```json
-// フックハンドラープロセスによって stdout に書き込まれます
+// フックハンドラープロセスが stdout に書き込む内容
 {
   "hookSpecificOutput": {
     "additionalContext": "All CI checks passed on branch 'feat/my-feature'."
   }
 }
 ```
-- 終了コード: `0`（操作は許可されます）
-- 複数のポリシーがメッセージ付きで `allow` を返した場合、それらのメッセージは改行で結合されて単一の `additionalContext` 文字列になります
-- どのポリシーもメッセージを提供しない場合、stdout は空（従来と同じ）
+- 終了コード：`0`（操作は許可されます）
+- 複数のポリシーがメッセージ付きの `allow` を返した場合、各メッセージは改行で結合されて1つの `additionalContext` 文字列になります
+- どのポリシーもメッセージを提供しない場合、stdout は空になります（従来と同じ動作）
 
 ### 処理パイプライン
 
-`src/hooks/handler.ts` が完全なパイプラインを実装しています。
+`src/hooks/handler.ts` がパイプライン全体を実装しています。
 
 ```text
 stdin JSON
   → ペイロードのパース（最大 1 MB）
-  → セッションメタデータの抽出（session_id、cwd、tool_name、tool_input など）
-  → readMergedHooksConfig(cwd)    ← プロジェクト + ローカル + グローバル設定をマージ
-  → 解決済みパラメーターで有効なビルトインポリシーを登録
-  → customPoliciesPath からカスタムポリシーを読み込み（設定されている場合）
+  → セッションメタデータの抽出（session_id, cwd, tool_name, tool_input など）
+  → readMergedHooksConfig(cwd)    ← プロジェクト・ローカル・グローバル設定をマージ
+  → 有効な組み込みポリシーを解決済みパラメーターで登録
+  → customPoliciesPath からカスタムポリシーを読み込む（設定されている場合）
   → カスタムポリシーをポリシーレジストリに登録
-  → すべてのポリシーを評価（ビルトインが先、次にカスタム）
-      → 最初の deny で短絡
-      → instruct の決定を蓄積
-      → allow メッセージを蓄積
-  → JSON 決定を stdout に書き込み
-  → イベントを ~/.failproofai/hook-activity.jsonl に永続化
+  → すべてのポリシーを評価（組み込みが先、次にカスタム）
+      → 最初の deny で短絡評価
+      → instruct の判断は蓄積
+      → allow のメッセージは蓄積
+  → JSON 判断結果を stdout に書き込む
+  → イベントを ~/.failproofai/hook-activity.jsonl に保存
   → 終了
 ```
 
-プロセス全体は、LLM 呼び出しなしで典型的なペイロードに対して 100ms 未満で実行されます。
+プロセス全体は、LLM 呼び出しなしの典型的なペイロードで 100ms 以内に完了します。
 
 ---
 
@@ -153,13 +153,13 @@ stdin JSON
 [3] ~/.failproofai/policies-config.json             ← グローバル（最低優先度）
 ```
 
-マージロジック:
-- `enabledPolicies` - 3つのファイル全体で重複排除された和集合
-- `policyParams` - ポリシーごとのキー。最初に定義されたファイルが完全に優先
-- `customPoliciesPath` - 最初に定義されたファイルが優先
-- `llm` - 最初に定義されたファイルが優先
+マージロジック：
+- `enabledPolicies` - 3つのファイルすべての重複排除された和集合
+- `policyParams` - ポリシーごとのキーで、最初に定義したファイルの値が全体として優先されます
+- `customPoliciesPath` - 最初に定義したファイルの値が優先されます
+- `llm` - 最初に定義したファイルの値が優先されます
 
-ウェブダッシュボードはプロジェクトの cwd で起動されないため、読み取りと書き込みには `readHooksConfig()`（グローバルのみ）を使用します。
+ウェブダッシュボードは、プロジェクトの cwd を使って起動されるわけではないため、読み書きに `readHooksConfig()`（グローバルのみ）を使用します。
 
 ---
 
@@ -167,26 +167,26 @@ stdin JSON
 
 `src/hooks/policy-evaluator.ts` がポリシーを順番に実行します。
 
-各ポリシーについて:
+各ポリシーに対して：
 
 1. ポリシーの `params` スキーマを検索します（存在する場合）。
-2. マージされた設定から `policyParams[policy.name]` を読み取ります。
-3. スキーマのデフォルト値にユーザー提供の値をマージして `ctx.params` を生成します。
-4. 解決されたコンテキストと共に `policy.fn(ctx)` を呼び出します。
-5. 結果が `deny` の場合、即座に停止してその決定を返します。
-6. 結果が `instruct` の場合、メッセージを蓄積して続行します。
+2. マージされた設定から `policyParams[policy.name]` を読み込みます。
+3. スキーマのデフォルト値にユーザー指定の値をマージして `ctx.params` を生成します。
+4. 解決されたコンテキストで `policy.fn(ctx)` を呼び出します。
+5. 結果が `deny` の場合、直ちに処理を停止してその判断を返します。
+6. 結果が `instruct` の場合、メッセージを蓄積して次のポリシーに進みます。
 7. 結果が `allow` の場合、次のポリシーに進みます。
 
-すべてのポリシーの実行後:
-- `deny` が返された場合、deny レスポンスを出力します。
-- `instruct` の結果が収集された場合、すべてのメッセージを結合した単一の instruct レスポンスを出力します。
-- それ以外の場合、allow レスポンスを出力します（stdout 空、終了コード 0）。
+すべてのポリシーの実行後：
+- `deny` が返されていた場合、deny レスポンスを発行します。
+- `instruct` の返却が収集されていた場合、すべてのメッセージを結合した単一の instruct レスポンスを発行します。
+- それ以外の場合、allow レスポンスを発行します（stdout は空、終了コード 0）。
 
 ---
 
-## ビルトインポリシー
+## 組み込みポリシー
 
-`src/hooks/builtin-policies.ts` が `BuiltinPolicyDefinition` オブジェクトとして26個のビルトインポリシーをすべて定義しています。
+`src/hooks/builtin-policies.ts` が全26件の組み込みポリシーを `BuiltinPolicyDefinition` オブジェクトとして定義しています。
 
 ```typescript
 interface BuiltinPolicyDefinition {
@@ -204,15 +204,15 @@ interface BuiltinPolicyDefinition {
 }
 ```
 
-`params` を受け付けるポリシーは、各パラメーターの型とデフォルト値を含む `PolicyParamsSchema` を宣言します。ポリシーエバリュエーターは `fn` を呼び出す前に解決済みの値を `ctx.params` に注入します。デフォルト値は常に最初に適用されるため、ポリシー関数は null チェックなしで `ctx.params` を読み取ります。
+`params` を受け付けるポリシーは、各パラメーターの型とデフォルト値を持つ `PolicyParamsSchema` を宣言します。ポリシー評価器は `fn` を呼び出す前に解決済みの値を `ctx.params` に注入します。デフォルト値は常に先に適用されるため、ポリシー関数は null チェックなしで `ctx.params` を読み込めます。
 
-ポリシー内のパターンマッチングは生の文字列マッチングではなく、パース済みのコマンドトークン（argv）を使用します。これにより、シェル演算子の挿入によるバイパスを防ぎます（例: `sudo systemctl status *` のパターンに `; rm -rf /` を追加してもバイパスできません）。
+ポリシー内部のパターンマッチングは、生の文字列マッチングではなく、パース済みのコマンドトークン（argv）を使用します。これにより、シェル演算子インジェクションによるバイパスを防ぎます（例えば、`sudo systemctl status *` に対するパターンは、コマンドに `; rm -rf /` を追加してもバイパスできません）。
 
 ---
 
 ## カスタムポリシー
 
-`src/hooks/custom-hooks-registry.ts` が `globalThis` バックのレジストリを実装しています。
+`src/hooks/custom-hooks-registry.ts` が `globalThis` ベースのレジストリを実装しています。
 
 ```typescript
 const REGISTRY_KEY = "__failproofai_custom_hooks__";
@@ -227,17 +227,17 @@ export function clearCustomHooks(): void { ... }  // テストで使用
 
 `src/hooks/custom-hooks-loader.ts` がユーザーのポリシーファイルを読み込みます。
 
-1. 設定から `customPoliciesPath` を読み取り、存在しない場合はスキップします。
-2. 絶対パスに解決し、ファイルの存在を確認します。
-3. `customPolicies` が同じ `globalThis` レジストリに解決されるよう、すべての `from "failproofai"` インポートを実際の dist パスに書き換えます。
-4. ESM 互換性を確保するため、推移的なローカルインポートを再帰的に書き換えます。
+1. 設定から `customPoliciesPath` を読み込み、存在しない場合はスキップします。
+2. 絶対パスに解決してファイルの存在を確認します。
+3. `from "failproofai"` のすべてのインポートを実際の dist パスに書き換え、`customPolicies` が同じ `globalThis` レジストリを参照するようにします。
+4. ESM 互換性を確保するために、推移的なローカルインポートを再帰的に書き換えます。
 5. 一時的な `.mjs` ファイルを書き込み、エントリファイルを `import()` します。
-6. `getCustomHooks()` を呼び出して登録済みフックを取得します。
+6. `getCustomHooks()` を呼び出して登録済みのフックを取得します。
 7. `finally` ブロックですべての一時ファイルを削除します。
 
-エラー（ファイルが見つからない、構文エラー、インポートの失敗など）が発生した場合、エラーは `~/.failproofai/hook.log` に記録され、ローダーは空の配列を返します。ビルトインポリシーには影響しません。
+エラー（ファイルが見つからない、構文エラー、インポートの失敗など）が発生した場合、エラーは `~/.failproofai/hook.log` に記録され、ローダーは空の配列を返します。組み込みポリシーへの影響はありません。
 
-カスタムポリシーはすべてのビルトインポリシーの後に評価されます。カスタムポリシーの `deny` はそれ以降のカスタムポリシーの実行を短絡させますが（その時点ではすべてのビルトインはすでに実行済みです）。
+カスタムポリシーはすべての組み込みポリシーの後に評価されます。カスタムポリシーの `deny` は、それ以降のカスタムポリシーの短絡評価を引き起こしますが（ただし、その時点ですべての組み込みポリシーは実行済みです）。
 
 ---
 
@@ -258,44 +258,44 @@ export function clearCustomHooks(): void { ... }  // テストで使用
 }
 ```
 
-allow 以外の決定を下したポリシー1件につき1行。allow の決定はログに記録されません（ファイルサイズを小さく保つため）。
+allow 以外の判断を行ったポリシーごとに1行が記録されます。allow の判断はファイルサイズを小さく保つために記録されません。
 
 ---
 
 ## ダッシュボードのアーキテクチャ
 
-ダッシュボードは、React Server Components と Server Actions を使用した App Router 採用の **Next.js 16** アプリケーションです。
+ダッシュボードは、App Router と React Server Components および Server Actions を使用した **Next.js 16** アプリケーションです。
 
 ```text
 app/
   layout.tsx                  ← ルートレイアウト（テーマ、テレメトリー、ナビゲーション）
-  projects/page.tsx           ← サーバーコンポーネント: すべての Claude プロジェクトを一覧表示
-  project/[name]/page.tsx     ← サーバーコンポーネント: プロジェクト内のセッションを一覧表示
+  projects/page.tsx           ← サーバーコンポーネント：すべての Claude プロジェクトを一覧表示
+  project/[name]/page.tsx     ← サーバーコンポーネント：プロジェクト内のセッションを一覧表示
   project/[name]/session/
-    [sessionId]/page.tsx      ← サーバーコンポーネント: セッションビューアーを表示
-  policies/page.tsx           ← クライアントコンポーネント: ポリシー管理 + アクティビティログ
+    [sessionId]/page.tsx      ← サーバーコンポーネント：セッションビューアーを表示
+  policies/page.tsx           ← クライアントコンポーネント：ポリシー管理 + アクティビティログ
   actions/
-    get-hooks-config.ts       ← 設定とポリシーリストの読み取り
-    update-hooks-config.ts    ← ポリシーのオン/オフ切り替え
+    get-hooks-config.ts       ← 設定とポリシーリストの読み込み
+    update-hooks-config.ts    ← ポリシーの有効・無効の切り替え
     update-policy-params.ts   ← ポリシーパラメーターの更新
-    get-hook-activity.ts      ← アクティビティログのページング/検索
-    install-hooks-web.ts      ← ブラウザからのフックのインストール/削除
+    get-hook-activity.ts      ← アクティビティログのページネーション・検索
+    install-hooks-web.ts      ← ブラウザからのフックのインストール・削除
   api/
     download/[project]/[session]/route.ts   ← セッションを ZIP/JSONL としてエクスポート
 ```
 
-**データフロー:**
+**データフロー：**
 
-- ページコンポーネントは `lib/projects.ts` と `lib/log-entries.ts` を呼び出し、ファイルシステムからプロジェクト/セッションデータを直接読み取ります（読み取りに API レイヤーは不要）。
-- ポリシーページはすべての変更操作（切り替え、パラメーター更新、インストール/削除）に Server Actions を使用します。
-- セッションビューアーは Claude の JSONL トランスクリプト形式をパースし、メッセージとツール呼び出しのタイムラインをレンダリングします。
+- ページコンポーネントは `lib/projects.ts` と `lib/log-entries.ts` を呼び出し、ファイルシステムから直接プロジェクト・セッションデータを読み込みます（読み取りに API レイヤーは不要）。
+- Policies ページはすべての変更操作（切り替え、パラメーター更新、インストール・削除）に Server Actions を使用します。
+- セッションビューアーは Claude の JSONL トランスクリプト形式をパースし、メッセージとツール呼び出しのタイムラインを表示します。
 
-**主要な設計上の決定事項:**
+**主要な設計上の決定事項：**
 
 - データベースなし - すべての永続状態はプレーンファイル（`~/.failproofai/`、`~/.claude/projects/`）に保存されます。
-- 変更操作には Server Actions を使用 - CRUD 操作に REST API は不要。
-- 読み取りページには React Server Components を使用 - 初期ロードが高速で、データフェッチのクライアントバンドルが不要。
-- クライアントコンポーネントはインタラクティブ性が必要な場合のみ使用（ポリシーの切り替え、アクティビティ検索、ログビューアー）。
+- 変更操作には Server Actions を使用 - CRUD 操作に REST API は不要です。
+- 読み取りページには React Server Components を使用 - 初期表示が高速で、データ取得のクライアントバンドルが不要です。
+- クライアントコンポーネントはインタラクティブ性が必要な箇所のみ使用（ポリシーの切り替え、アクティビティ検索、ログビューアー）。
 
 ---
 
@@ -304,29 +304,29 @@ app/
 ```text
 failproofai/
 ├── bin/
-│   └── failproofai.mjs           # CLI ルーター（フック / ダッシュボード / インストール など）
+│   └── failproofai.mjs           # CLI ルーター（hook / dashboard / install など）
 ├── src/hooks/
 │   ├── handler.ts                # フックイベントパイプライン
-│   ├── builtin-policies.ts       # 26のポリシー定義
+│   ├── builtin-policies.ts       # 26件のポリシー定義
 │   ├── policy-evaluator.ts       # ポリシー実行エンジン
 │   ├── policy-registry.ts        # ポリシーの登録と検索
 │   ├── policy-types.ts           # TypeScript インターフェース
-│   ├── hooks-config.ts           # マルチスコープ設定読み込み
-│   ├── custom-hooks-registry.ts  # globalThis バックのフックレジストリ
+│   ├── hooks-config.ts           # マルチスコープ設定の読み込み
+│   ├── custom-hooks-registry.ts  # globalThis ベースのフックレジストリ
 │   ├── custom-hooks-loader.ts    # ユーザー JS フック用の ESM ローダー
-│   ├── manager.ts                # インストール / 削除 / 一覧操作
+│   ├── manager.ts                # インストール・削除・一覧操作
 │   ├── install-prompt.ts         # インタラクティブなポリシー選択プロンプト
-│   ├── hook-logger.ts            # hook.log へのロギング
-│   ├── hook-activity-store.ts    # hook-activity.jsonl へのアクティビティの永続化
-│   └── llm-client.ts             # LLM API クライアント（AI 搭載ポリシー用）
+│   ├── hook-logger.ts            # hook.log へのログ記録
+│   ├── hook-activity-store.ts    # hook-activity.jsonl へのアクティビティ保存
+│   └── llm-client.ts             # LLM API クライアント（AI 駆動ポリシー用）
 ├── app/                          # Next.js ダッシュボード（ページ + サーバーアクション）
 ├── lib/                          # 共有ユーティリティ
 │   ├── projects.ts               # ファイルシステムから Claude プロジェクトを列挙
-│   ├── log-entries.ts            # Claude トランスクリプトの JSONL 形式をパース
+│   ├── log-entries.ts            # Claude トランスクリプト JSONL 形式のパース
 │   ├── paths.ts                  # システムパスの解決
 │   └── ...
 ├── components/                   # 共有 React UI コンポーネント
 ├── contexts/                     # React コンテキストプロバイダー（テーマ、自動更新、テレメトリー）
-├── examples/                     # カスタムフックファイルの例
-└── __tests__/                    # ユニットテストと E2E テスト
+├── examples/                     # カスタムフックのサンプルファイル
+└── __tests__/                    # ユニットテストおよび E2E テスト
 ```

package/.next/standalone/docs/ja/configuration.mdx

@@ -4,54 +4,54 @@ description: "設定ファイルのフォーマット、3スコープシステ
 icon: gear
 ---
 
-failproofai は JSON 設定ファイルを使用して、どのポリシーが有効か、その動作方法、カスタムポリシーの読み込み元を管理します。設定はチームで共有しやすい設計になっています。リポジトリにコミットすれば、すべての開発者が同じエージェントセーフティネットを利用できます。
+failproofaiはJSON設定ファイルを使用して、有効なポリシー、その動作、カスタムポリシーの読み込み元を管理します。設定はチームと簡単に共有できるよう設計されています。リポジトリにコミットするだけで、すべての開発者が同じエージェントセーフティネットを利用できます。
 
 ---
 
 ## 設定スコープ
 
-設定スコープは優先順位の高い順に 3 つあります。
+優先順位順に評価される3つの設定スコープがあります：
 
 | スコープ | ファイルパス | 用途 |
 |-------|-----------|---------|
-| **project** | `.failproofai/policies-config.json` | リポジトリ単位の設定、バージョン管理にコミット |
-| **local** | `.failproofai/policies-config.local.json` | 個人用のリポジトリ単位オーバーライド、gitignore 対象 |
-| **global** | `~/.failproofai/policies-config.json` | 全プロジェクト共通のユーザーレベルデフォルト |
+| **project** | `.failproofai/policies-config.json` | リポジトリごとの設定。バージョン管理にコミット |
+| **local** | `.failproofai/policies-config.local.json` | 個人用のリポジトリごとの上書き設定。gitignore対象 |
+| **global** | `~/.failproofai/policies-config.json` | すべてのプロジェクトに適用されるユーザーレベルのデフォルト |
 
-failproofai がフックイベントを受け取ると、現在の作業ディレクトリに存在する 3 つのファイルをすべて読み込んでマージします。
+failproofaiがフックイベントを受け取ると、カレントワーキングディレクトリに存在する3つのファイルをすべて読み込んでマージします。
 
 ### マージルール
 
-**`enabledPolicies`** - 3 つのスコープすべての和集合。いずれかのレベルで有効化されたポリシーはアクティブになります。
+**`enabledPolicies`** — 3つのスコープすべての和集合となります。いずれかのレベルで有効化されたポリシーはアクティブになります。
 
 ```text
 project:  ["block-sudo"]
 local:    ["block-rm-rf"]
 global:   ["block-sudo", "sanitize-api-keys"]
 
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← 重複排除済みの和集合
+resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← 重複排除された和集合
 ```
 
-**`policyParams`** - 特定のポリシーのパラメーターを最初に定義したスコープが全体として優先されます。ポリシーのパラメーター内での深いマージは行われません。
+**`policyParams`** — 特定のポリシーのパラメータを最初に定義したスコープが完全に優先されます。ポリシーのパラメータ内の値は深くマージされません。
 
 ```text
 project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
 global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project が優先、global は無視
+resolved: { allowPatterns: ["sudo apt-get update"] }   ← projectが優先。globalは無視される
 ```
 
 ```text
-project:  (block-sudo エントリなし)
-local:    (block-sudo エントリなし)
+project:  (block-sudoエントリなし)
+local:    (block-sudoエントリなし)
 global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← global にフォールスルー
+resolved: { allowPatterns: ["sudo systemctl status"] }  ← globalにフォールスルー
 ```
 
-**`customPoliciesPath`** - 最初に定義したスコープが優先されます。
+**`customPoliciesPath`** — 最初に定義したスコープが優先されます。
 
-**`llm`** - 最初に定義したスコープが優先されます。
+**`llm`** — 最初に定義したスコープが優先されます。
 
 ---
 
@@ -100,29 +100,29 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← global にフォー
 
 ### `enabledPolicies`
 
-型: `string[]`
+型：`string[]`
 
-有効化するポリシー名の一覧。名前は `failproofai policies` で表示されるポリシー識別子と完全に一致する必要があります。全一覧は [Built-in Policies](/ja/built-in-policies) を参照してください。
+有効にするポリシー名の一覧です。名前は `failproofai policies` が表示するポリシー識別子と完全に一致する必要があります。完全なリストは[組み込みポリシー](/ja/built-in-policies)を参照してください。
 
 `enabledPolicies` に含まれていないポリシーは、`policyParams` にエントリがあっても非アクティブになります。
 
 ### `policyParams`
 
-型: `Record<string, Record<string, unknown>>`
+型：`Record<string, Record<string, unknown>>`
 
-ポリシーごとのパラメーターオーバーライド。外側のキーがポリシー名、内側のキーはポリシー固有の設定です。各ポリシーで利用可能なパラメーターは [Built-in Policies](/ja/built-in-policies) に記載されています。
+ポリシーごとのパラメータ上書き設定です。外側のキーはポリシー名、内側のキーはポリシー固有のものです。各ポリシーの利用可能なパラメータは[組み込みポリシー](/ja/built-in-policies)に記載されています。
 
-ポリシーにパラメーターがあっても指定しない場合は、ポリシーの組み込みデフォルト値が使用されます。`policyParams` をまったく設定していないユーザーは、以前のバージョンと同じ動作になります。
+ポリシーにパラメータが存在しても指定しない場合、ポリシーの組み込みデフォルト値が使用されます。`policyParams` をまったく設定しないユーザーは、以前のバージョンと同一の動作になります。
 
-ポリシーのパラメーターブロック内の未知のキーは、フック発火時には無視されますが、`failproofai policies` 実行時に警告として表示されます。
+ポリシーのパラメータブロック内の未知のキーは、フック実行時には無視されますが、`failproofai policies` を実行したときに警告として表示されます。
 
-#### `hint`（共通設定）
+#### `hint`（横断的設定）
 
-型: `string`（省略可能）
+型：`string`（任意）
 
-ポリシーが `deny` または `instruct` を返した際に、理由メッセージに追加されるテキスト。ポリシー自体を変更せずに Claude への具体的なガイダンスを提供するために使用します。
+ポリシーが `deny` または `instruct` を返したときに理由に追記されるメッセージです。ポリシー自体を変更せずに、Claudeへの具体的なガイダンスを提供するために使用します。
 
-組み込みポリシー、カスタムポリシー（`custom/`）、プロジェクト規約（`.failproofai-project/`）、ユーザー規約（`.failproofai-user/`）など、すべてのポリシータイプで利用できます。
+組み込み、カスタム（`custom/`）、プロジェクト規約（`.failproofai-project/`）、ユーザー規約（`.failproofai-user/`）を問わず、あらゆるポリシータイプで利用できます。
 
 ```json
 {
@@ -141,40 +141,40 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← global にフォー
 }
 ```
 
-`block-force-push` が deny した場合、Claude には次のように表示されます: *"Force-pushing is blocked. Try creating a fresh branch instead."*
+`block-force-push` が拒否した場合、Claudeには「Force-pushing is blocked. Try creating a fresh branch instead.」と表示されます。
 
-文字列以外の値および空文字列は無視されます。`hint` が設定されていない場合は動作に変化はありません（後方互換性あり）。
+文字列以外の値や空文字列は無視されます。`hint` が設定されていない場合、動作は変わりません（後方互換性があります）。
 
 ### `customPoliciesPath`
 
-型: `string`（絶対パス）
+型：`string`（絶対パス）
 
-カスタムフックポリシーを含む JavaScript ファイルへのパス。`failproofai policies --install --custom <path>` によって自動的に設定されます（パスは保存前に絶対パスに解決されます）。
+カスタムフックポリシーを含むJavaScriptファイルへのパスです。`failproofai policies --install --custom <path>` を実行すると自動的に設定されます（パスは保存前に絶対パスに解決されます）。
 
-このファイルはフックイベントのたびに新たに読み込まれます。キャッシュは使用されません。作成方法の詳細は [Custom Policies](/ja/custom-policies) を参照してください。
+ファイルはフックイベントのたびに新しく読み込まれます。キャッシュはありません。作成方法の詳細は[カスタムポリシー](/ja/custom-policies)を参照してください。
 
 ### 規約ベースのポリシー
 
-明示的な `customPoliciesPath` に加えて、failproofai は `.failproofai/policies/` ディレクトリからポリシーファイルを自動的に検出して読み込みます。
+`customPoliciesPath` の明示的な指定に加えて、failproofaiは `.failproofai/policies/` ディレクトリからポリシーファイルを自動的に検出して読み込みます：
 
 | レベル | ディレクトリ | スコープ |
 |-------|-----------|-------|
-| プロジェクト | `.failproofai/policies/` | バージョン管理でチームと共有 |
-| ユーザー | `~/.failproofai/policies/` | 個人用、全プロジェクトに適用 |
+| プロジェクト | `.failproofai/policies/` | バージョン管理を通じてチームと共有 |
+| ユーザー | `~/.failproofai/policies/` | 個人用。すべてのプロジェクトに適用 |
 
-**ファイルのマッチング:** `*policies.{js,mjs,ts}` にマッチするファイルのみ読み込まれます（例: `security-policies.mjs`、`workflow-policies.js`）。ディレクトリ内のその他のファイルは無視されます。
+**ファイルのマッチング：** `*policies.{js,mjs,ts}` にマッチするファイルのみ読み込まれます（例：`security-policies.mjs`、`workflow-policies.js`）。ディレクトリ内のその他のファイルは無視されます。
 
-**設定不要:** 規約ポリシーは `policies-config.json` へのエントリが不要です。ディレクトリにファイルを配置するだけで、次のフックイベント時に自動的に読み込まれます。
+**設定不要：** 規約ポリシーは `policies-config.json` へのエントリが不要です。ディレクトリにファイルを置くだけで、次のフックイベント時に自動的に読み込まれます。
 
-**全量読み込み:** プロジェクトとユーザーの両方の規約ディレクトリがスキャンされます。両レベルのマッチするファイルがすべて読み込まれます（最初のスコープ優先となる `customPoliciesPath` とは異なります）。
+**ユニオン読み込み：** プロジェクトとユーザーの両方の規約ディレクトリがスキャンされます。両レベルのすべてのマッチするファイルが読み込まれます（最初のスコープ優先となる `customPoliciesPath` とは異なります）。
 
-詳細と例については [Custom Policies](/ja/custom-policies) を参照してください。
+詳細と例については[カスタムポリシー](/ja/custom-policies)を参照してください。
 
 ### `llm`
 
-型: `object`（省略可能）
+型：`object`（任意）
 
-AI 呼び出しを行うポリシー向けの LLM クライアント設定。ほとんどの環境では不要です。
+AIコールを行うポリシー向けのLLMクライアント設定です。ほとんどのセットアップでは不要です。
 
 ```json
 {
@@ -187,20 +187,20 @@ AI 呼び出しを行うポリシー向けの LLM クライアント設定。ほ
 
 ---
 
-## CLI からの設定管理
+## CLIからの設定管理
 
-`policies --install` および `policies --uninstall` コマンドは Claude Code の `settings.json`（フックエントリポイント）に書き込みます。一方、`policies-config.json` は直接管理するファイルです。この 2 つは別物です。
+`policies --install` および `policies --uninstall` コマンドは Claude Code の `settings.json`（フックエントリポイント）に書き込みます。一方、`policies-config.json` は直接管理するファイルです。この2つは別々のものです：
 
-- **`settings.json`** - ツール使用のたびに `failproofai --hook <event>` を呼び出すよう Claude Code に指示する
-- **`policies-config.json`** - どのポリシーをどのパラメーターで評価するかを failproofai に指示する
+- **`settings.json`** — ツール使用のたびに Claude Code が `failproofai --hook <event>` を呼び出すよう指示する
+- **`policies-config.json`** — どのポリシーをどのパラメータで評価するかを failproofai に指示する
 
-`policies-config.json` はいつでも直接編集できます。変更は再起動不要で、次のフックイベント時に即座に反映されます。
+`policies-config.json` はいつでも直接編集できます。変更は次のフックイベント時に即座に反映され、再起動は不要です。
 
 ---
 
-## 例: チームデフォルトを含むプロジェクトレベル設定
+## 例：チームデフォルトを含むプロジェクトレベルの設定
 
-`.failproofai/policies-config.json` をリポジトリにコミットします。
+`.failproofai/policies-config.json` をリポジトリにコミットします：
 
 ```json
 {
@@ -219,4 +219,4 @@ AI 呼び出しを行うポリシー向けの LLM クライアント設定。ほ
 }
 ```
 
-各開発者はチームメンバーに影響を与えることなく、個人用のオーバーライドとして `.failproofai/policies-config.local.json`（gitignore 対象）を作成できます。
+各開発者は `.failproofai/policies-config.local.json`（gitignore対象）を作成して、チームメンバーに影響を与えることなく個人用の上書き設定を行えます。