failproofai 0.0.2 → 0.0.4-beta.0

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

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

package/.next/standalone/docs/ja/cli/dashboard.mdx

@@ -0,0 +1,28 @@
+---
+title: セッションを表示する
+description: "ダッシュボードを起動してエージェントセッションを閲覧し、ポリシーを管理する"
+---
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` でウェブダッシュボードを起動します。
+
+## オプション
+
+| フラグ | 説明 |
+|------|-------------|
+| `--port <number>` | リッスンするポート番号（デフォルト: `8020`） |
+| `--projects-path <path>` | Claude Code プロジェクトフォルダーの検索場所を上書きする |
+| `--allowed-origins <origins>` | 開発リソースへのアクセスを許可するホスト/IP をカンマ区切りで指定する |
+
+## 使用例
+
+```bash
+# Launch on a different port
+failproofai --port 9000
+
+# Use a custom projects path
+failproofai --projects-path ~/my-claude-projects
+```

package/.next/standalone/docs/ja/cli/environment-variables.mdx

@@ -0,0 +1,34 @@
+---
+title: 環境変数
+description: "環境変数を使用して failproofai の動作を設定する"
+---
+
+## ダッシュボード
+
+| 変数 | 説明 |
+|----------|-------------|
+| `PORT` | ダッシュボードのポート（デフォルト: `8020`） |
+| `CLAUDE_PROJECTS_PATH` | Claude Code プロジェクトフォルダの検索場所を上書きする |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | 非表示にするダッシュボードページをカンマ区切りで指定する |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | 開発リソースへのアクセスを許可するホスト/IP。`--allowed-origins` と同等。 |
+
+## ログ
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | サーバーのログレベル（デフォルト: `warn`） |
+| `FAILPROOFAI_HOOK_LOG_FILE` | カスタムフックログファイルのパス。`true` を指定するとデフォルトパス（`~/.failproofai/logs/hooks.log`）を使用する |
+
+## テレメトリー
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | 匿名の使用状況テレメトリーを無効にする |
+
+## LLM（ポリシー評価用）
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | LLM API エンドポイント（デフォルト: `https://api.openai.com/v1`） |
+| `FAILPROOFAI_LLM_API_KEY` | LLM 駆動ポリシー用の API キー |
+| `FAILPROOFAI_LLM_MODEL` | モデル名（デフォルト: `gpt-4o-mini`） |

package/.next/standalone/docs/ja/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: フックハンドラー（内部）
+description: "各ツールイベントでClaude Codeが呼び出すサブプロセス"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+これは `failproofai policies --install` によって Claude Code の `settings.json` に登録されるコマンドです。通常、直接呼び出す必要はありません。
+
+stdin から JSON ペイロードを読み込み、有効なすべてのポリシーを評価し、決定内容を示すコードで終了します：
+
+| 終了コード | 決定 | 効果 |
+|-----------|----------|--------|
+| `0` | `allow` | アクションを許可する |
+| `1` | `deny` | アクションをブロックする - Claude は拒否理由を確認できる |
+| `2` | `instruct` | Claude のコンテキストにガイダンスを注入する |
+
+### サポートされているイベントタイプ
+
+| カテゴリ | イベント |
+|----------|--------|
+| **ツール実行** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **セッションライフサイクル** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **ユーザーインタラクション** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **サブエージェント＆タスク** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **設定** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **ファイルシステム** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **コンテキスト** | `PreCompact`, `PostCompact` |

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

@@ -0,0 +1,47 @@
+---
+title: ポリシーのインストール
+description: "エージェントのツール呼び出しごとにポリシーが実行されるよう有効化する"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+Claude Code の `settings.json` にフックエントリを書き込み、failproofai がツール呼び出しを横断できるようにします。
+
+エイリアス: `failproofai p -i`
+
+## オプション
+
+| フラグ | 説明 |
+|--------|------|
+| `--scope user` | `~/.claude/settings.json` にインストール（デフォルト - すべてのセッションに適用） |
+| `--scope project` | カレントディレクトリの `.claude/settings.json` にインストール |
+| `--scope local` | カレントディレクトリの `.claude/settings.local.json` にインストール |
+| `--custom <path>` / `-c` | カスタムフックポリシーを含む JS ファイルへのパス |
+
+## 動作
+
+- **ポリシー名の指定なし** - ポリシーを選択するインタラクティブなプロンプトを開きます
+- **特定の名前を指定** - 指定したポリシーを有効化します（すでに有効なポリシーに追加されます）
+- **`all`** - 利用可能なすべてのポリシーを有効化します
+
+インストールは追加的に動作します。`--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>` を指定すると、ファイルは即座に検証されます。少なくとも 1 回 `customPolicies.add()` を呼び出している必要があります。解決されたパスは `policies-config.json` に `customPoliciesPath` として保存されます。