failproofai 1.0.1-beta.1 → 1.0.2-beta.0

package/.next/standalone/docs-old/ja/dashboard.mdx

@@ -0,0 +1,151 @@
+---
+title: ダッシュボード
+description: "エージェントセッションの監視、ツール呼び出しの確認、ポリシーの管理"
+icon: chart-line
+---
+
+failproofai ダッシュボードは、AIエージェントセッションの監視とポリシー管理のためのローカルWebアプリケーションです。離席中にエージェントが何をしたかを確認できます。
+
+---
+
+## ダッシュボードの起動
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` で開きます。
+
+ダッシュボードはローカルのプロジェクト、セッション、failproofai 設定データをファイルシステムから直接読み取ります。監査リマインダーや招待状などの認証が必要なオプション機能は、該当リクエストに必要な情報（メールアドレスを含む）をリモートAPIに送信します。
+
+---
+
+## ページ
+
+### プロジェクト
+
+マシン上で見つかったすべての Claude Code、OpenAI Codex、GitHub Copilot CLI _(beta)_、Cursor Agent _(beta)_、OpenCode _(beta)_、Pi _(beta)_、Hermes、OpenClaw、Factory Droid、Devin、Antigravity、Goose のプロジェクトを一覧表示します。Claude プロジェクトは `~/.claude/projects/`（または `CLAUDE_PROJECTS_PATH` で設定されたパス）から検出されます。Codex プロジェクトは `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` 配下のすべてのトランスクリプトをスキャンし、各セッションの最初のレコードに記録された `cwd` でグループ化して検出されます。Copilot CLI プロジェクトは各 `~/.copilot/session-state/<sessionId>/workspace.yaml`（`COPILOT_HOME` で変更可能）をスキャンし、`cwd` フィールドでグループ化して検出されます。Cursor Agent プロジェクトは `~/.cursor/agent-sessions/<sessionId>/`（`CURSOR_HOME` で変更可能。フォールバックとして `conversations/` と `sessions/` も探索）配下のセッションごとのメタデータから `meta.json` / `session.json` / `workspace.yaml` 内の `cwd` スカラーをもとに検出されます。OpenCode プロジェクトは `~/.local/share/opencode/opencode.db` にある SQLite DB を `opencode db --format json` 経由でクエリし（`session` と `project` テーブルを読み取り `project_id` でグループ化）検出されます。Pi プロジェクトは `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`（`PI_SESSIONS_DIR` で変更可能）配下のセッションごとの JSONL トランスクリプトをスキャンし、各セッションの最初のレコードから `cwd` を取得して検出されます。Hermes ゲートウェイセッションはすべてのプロファイルの SQLite ストア（`~/.hermes/state.db` および `~/.hermes/profiles/<name>/state.db`。`HERMES_HOME` または単一データベース用の `HERMES_DB_PATH` で上書き可能）から直接読み取られ、プロファイルと `source`（Slack/Telegram/cli/cron — ゲートウェイセッションには cwd がありません）ごとに `hermes-<profile>-<source>` プロジェクトとしてグループ化されます。OpenClaw ゲートウェイセッションは `~/.openclaw/agents/<agentId>/sessions/*.jsonl` から読み取られ、エージェントとチャンネルごとに `openclaw-<agentId>-<channel>` プロジェクトとしてグループ化されます（こちらも cwd なし）。Factory Droid プロジェクトは `~/.factory/sessions/<encoded-cwd>/*.jsonl` の JSONL トランスクリプトから cwd でグループ化して検出されます。Devin プロジェクトは `~/.local/share/devin/cli/sessions.db` の SQLite DB から（各セッションの `working_directory` でグループ化）検出されます。Antigravity プロジェクトは `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` の JSONL トランスクリプトから cwd でグループ化して検出されます。Goose プロジェクトは `~/.local/share/goose/sessions/sessions.db` の SQLite DB から（各セッションの `working_dir` でグループ化）検出されます。複数の CLI で使用されたプロジェクトは、一致するすべてのバッジを持つ単一の行として表示されます。テーブル上部の **CLI** ドロップダウンで特定のエージェント CLI に絞り込めます。URLには選択内容が `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose` として保持されます。
+
+Hermes と OpenClaw はユーザースコープでグループ化に使える作業ディレクトリがないため、**折りたたみ可能なフォルダーツリー**（トップレベルにプロファイルまたはエージェント、その下にチャンネル）として表示されます。cwd ベースの CLI はすべてフラットな行のまま表示されます。フォルダー行はその配下のセッション数と最新のアクティビティをロールアップ表示し、折りたたみ状態は訪問間で記憶されます。キーワード検索は一致するものを自動的に展開します。
+
+各プロジェクトの表示内容：
+- プロジェクト名（フォルダーパスから派生）
+- CLI バッジ — `Claude Code`（オレンジ）、`OpenAI Codex`（パープル）、`GitHub Copilot`（ブルー）、`Cursor Agent`（エメラルド）、`OpenCode`（アンバー）、`Pi`（ピンク）、`Hermes`（インディゴ）
+- 最新セッションアクティビティの日付
+
+プロジェクトをクリックするとそのセッションが表示されます。
+
+### セッション
+
+プロジェクト内のすべてのセッションを一覧表示します。各セッションの表示内容：
+- セッション ID
+- 開始・終了タイムスタンプ
+- ツール呼び出し数
+- フックアクティビティ数（発動したポリシー数）
+
+日付範囲フィルターとセッション ID 検索で絞り込めます。セッションはページネーション表示されます。
+
+セッションをクリックするとセッションビューアーが開きます。
+
+### セッションビューアー
+
+セッションビューアーは自律エージェントにとっての核心的な問いに答えます：エージェントは何をしたか、そして正しく動作していたか？ヘッダー横の CLI バッジは、そのセッションが Claude Code、OpenAI Codex、GitHub Copilot CLI、Cursor Agent、OpenCode、Pi、Hermes、OpenClaw、Factory Droid、Devin、Antigravity、Goose のどのトランスクリプトかを示します。セッション内で起きたすべての出来事のタイムラインを表示します：
+
+- **メッセージ** — Claude のテキスト応答とユーザープロンプト
+- **ツール呼び出し** — Claude が呼び出したすべてのツール（入力と出力を含む）
+- **ポリシーアクティビティ** — 各ツール呼び出しについて、どのポリシーが発動し、どの判定が返されたか
+
+上部のステータスバーにはセッション時間、ツール呼び出しの合計数、フック判定のサマリー（allow / deny / instruct の件数）が表示されます。
+
+**Download Logs** ボタンをクリックするとセッションをエクスポートできます。Claude Code、Codex、Copilot、Cursor、Pi のセッションはディスク上の元の JSONL トランスクリプトをバイト単位でそのまま取得できます。OpenCode（セッションがディスクではなく SQLite に保存されます）の場合は、基盤となる `session` / `messages` / `parts` テーブルを反映した JSON ドキュメントを取得できます。
+
+### 監査
+
+過去のセッションにわたってエージェントが実際にどのように振る舞っているかをパーソナリティ主導でレポートします。`failproofai audit` CLI と同じスキャンを実行し、シングルスクリーンの共有可能なポスターとスクロール下の4つのセクションとしてレンダリングします：
+
+1. **ポスター** — 最初のビューポートを占有します。failproof_ai ワードマーク + 監査ラベル · アーキタイプインデックス（`№ NN of 08`）+ 監査日 · 数値スコア（0～100）+ パーセンタイルランクピル（`top 15%`）· アーキタイプ名（`the optimist`、`the cowboy`、`the explorer`、`the goldfish`、`the paranoid architect`、`the precision builder`、`the hammer`、`the ghost` のいずれか）+ 3キーワードストリップ · `// only N% of agents are this archetype` レアリティライン · 8×8 ピクセルのシジルタイル · `audit yours → failproof.ai` フッターを含む、PNG キャプチャ領域として自己完結しています。キャプチャ枠の外側に3つのシェアボタン（`post your archetype`（X インテント）、`share on linkedin`、`download poster`）があります。キャプチャは `html-to-image` を通じて実行されるため、PNG は画面上のレンダリングとピクセル単位で一致します（破線ボーダー、SVG ロゴマスク、グラデーション、フォントメトリクス — すべて保持されます）。
+2. **強み** — エージェントがすでに正しく実行している動作の落ち着いた ✓ 行リスト。ライブ監査データ（クリーンなツール呼び出し率、main への直接プッシュなし、認証情報漏洩ゼロ、リトライストームゼロ）から導出され、関連ポリシーが監査ウィンドウ全体でクリーンな記録を持つ場合にのみ表示されます。
+3. **クセ** — 見逃された問題の表。重大度順にランク付け：`発生時刻 · 何が漏れたか + それを捕捉するはずだったポリシー · 重大度ピル · 発生回数`。再発件数は `new`（1回）、`N× seen`（2～9回）、`recurring`（10回以上）と表示されます。
+4. **改善方法** — 推奨ポリシーごとの落ち着いた行リスト：白文字のポリシー名、1行の説明、右側にインストールコマンドとコピーボタン。セクションヘッダーには `enable all N → projected <score> · <tier>`（すべての修正を適用した場合に到達するスコア）と表示され、`[install all]` ボタンは推奨されるすべてのポリシーの `failproofai policy add a b c …` コマンドをまとめてコピーします。
+5. **次回に備えて** — 横並びの2枚のカード。左：リマインダーの設定（`3d` / `7d` / `14d` / `30d` のケイデンスピッカー。認証後に `/api/auth/reminder` を通じて永続化）。右：failproof 特典のアンロック — `invite a friend` はモーダルを開き、カンマ・スペース・改行で区切られた友人のメールアドレスリスト（1回の送信で最大10件）を受け取り、`/api/audit/invite` に POST します。これが api-server の `POST /v0/invite` に転送されます。api-server は `invite@failproof.ai` から受信者1人につき1通のメールを送信し、送信者を Cc に含めて `Reply-To` を設定します。これにより受信者は誰が招待したかがわかり、送信者も自分の受信トレイにコピーを受け取ります。匿名ユーザーは招待送信前に送信者のメールアドレスを確認するため、最初に `AuthDialog` にルーティングされます。資格・特典の付与は今後の対応となります。
+
+`failproofai audit` ランタイムによって駆動されます — 基盤となるスキャンエンジン、サポートされるフラグ、トランスクリプトごとのキャッシュの不変条件については [Audit CLI](/ja/cli/audit) を参照してください。ダッシュボードは最新の結果を `~/.failproofai/audit-dashboard.json`（モード `0600`、シングルスロット、新しい実行で上書き）にキャッシュするため、再訪問は即座に表示されます。**トランスクリプトごとのキャッシュと全体結果のキャッシュはどちらも、7日を超えた時点で読み取り時に破棄されます**。これによりダッシュボードが1週間前の古い結果を暗黙的に提供することはありません — TTL を過ぎると `/audit` は空の状態にフォールスルーし、新しい実行を促します。レポート下部の `[ re-audit now ]` をクリックすると `noCache: true` で `/api/audit/run` に POST されます — 再監査はトランスクリプトごとのキャッシュをバイパスし、キャッシュ済み結果を暗黙的に返すのではなく、すべてのトランスクリプトをゼロから再スキャンします — ダッシュボードは実行が完了するまで 1Hz で `/api/audit/status` をポーリングします。実行中は経過タイマーとともにピンクのプログレスストリップがビューポートの上部に固定表示され、成功時には新しい結果がページの全体リロードなしにその場で差し替えられます。再監査に失敗した場合、ストリップは赤に変わり、`RerunError.kind`（`timeout` / `network` / `post_failed`）に応じたコピーが表示され、前のレポートはそのまま維持されます。空の状態（キャッシュなしまたは期限切れ）とセッションゼロの状態（キャッシュは存在するがスキャンでトランスクリプトが見つからなかった）は個別に表示されます。
+
+### ポリシー
+
+ポリシーの管理とアクティビティの確認のための2タブページです。
+
+<Tabs>
+  <Tab title="ポリシータブ">
+  - 単一パネルから failproofai が保護するエージェント CLI を複数選択できます — Claude Code、OpenAI Codex、GitHub Copilot、Cursor Agent、OpenCode、Pi、Hermes のそれぞれに、インストール状態（`Active` / `Detected` / `Inactive`）、ユーザースコープの設定パス、ブランドカラーのアクセントを持つ行があります。保護したい CLI にチェックを入れ、`Apply changes` をクリックすると差分を一括でインストール/アンインストールできます。PATH 上でバイナリが検出された CLI はあらかじめチェックされています。
+  - ワンクリックで個別ポリシーのオン/オフを切り替えられます（`~/.failproofai/policies-config.json` に書き込まれ、インストールされているすべての CLI 間で共有されます）
+  - ポリシーを展開してパラメーターを設定できます（`policyParams` をサポートするポリシーの場合）
+  - カスタムポリシーファイルのパスを設定できます
+  </Tab>
+  <Tab title="アクティビティタブ">
+  - すべてのセッションにわたって発動したすべてのフックイベントの完全なページネーション付き履歴
+  - 判定、イベントタイプ、CLI（Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose）、ポリシー名、またはセッション ID でフィルタリング
+  - 各行の表示内容：タイムスタンプ、ポリシー名、判定、CLI バッジ（オレンジ = Claude Code、パープル = OpenAI Codex、ブルー = GitHub Copilot、エメラルド = Cursor Agent、アンバー = OpenCode、ピンク = Pi、インディゴ = Hermes、ティール = OpenClaw、ローズ = Factory Droid、バイオレット = Devin、シアン = Antigravity、ライム = Goose）、ツール名、セッション ID、deny/instruct 判定の理由
+  - セッション ID をクリックするとそのトランスクリプトが開きます — ビューアーはフックを発動した CLI を自動検出し（Claude `~/.claude/projects/…`、Codex `~/.codex/sessions/…`、Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`、Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`、OpenCode `~/.local/share/opencode/opencode.db`、Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`、Hermes `~/.hermes/state.db`、OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`、Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`、Devin `~/.local/share/devin/cli/sessions.db`、Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`、Goose `~/.local/share/goose/sessions/sessions.db`）、ヘッダーに一致する CLI バッジをレンダリングします
+  </Tab>
+</Tabs>
+
+---
+
+## 自動更新
+
+ダッシュボードには上部ナビゲーションに自動更新トグルがあります。有効にすると、現在のページが定期的に更新され、新しいセッションとポリシーアクティビティがリアルタイムで表示されます。長時間実行される自律エージェントセッションの監視に不可欠です。
+
+---
+
+## ページの無効化
+
+ダッシュボードの一部のみ必要な場合は、`FAILPROOFAI_DISABLE_PAGES` にカンマ区切りのページ名リストを設定します：
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+有効な値：`policies`、`projects`、`audit`。
+
+---
+
+## プロジェクトパスの設定
+
+デフォルトでは、ダッシュボードは標準の Claude Code プロジェクトディレクトリから読み取ります。カスタム設定の場合は上書きできます：
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## localhost 以外のホストからのアクセス
+
+**dev モード**（`npm run dev`）でダッシュボードを実行し、`localhost` 以外のホスト名（カスタムドメイン、リモート IP、トンネルされた URL など）からアクセスする場合、次のような警告が表示されることがあります：
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+これは Next.js が HMR（ホットモジュールリロード）WebSocket へのクロスオリジンアクセスをブロックしているためです。HMR は dev モード専用の機能です。ホストを許可するには `--allowed-origins` フラグを使用します：
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+複数のホストや IP を指定する場合は、カンマ区切りのリストを渡します：
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+環境変数 `FAILPROOFAI_ALLOWED_DEV_ORIGINS` を使用することもできます：
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+これは dev モードにのみ適用されます。`failproofai`（プロダクションモード）を実行している場合、HMR WebSocket もクロスオリジン dev リソースの問題も発生しません。
+</Note>

package/.next/standalone/docs-old/ja/examples.mdx

@@ -0,0 +1,307 @@
+---
+title: サンプル
+description: "Claude Code と Agents SDK にフックを設定する方法"
+icon: book-open
+---
+
+よくあるシナリオですぐに使えるサンプル集です。それぞれのインストール方法と動作結果を紹介します。
+
+---
+
+## Claude Code にフックを設定する
+
+Failproof AI は Claude Code の[フックシステム](https://docs.anthropic.com/en/docs/claude-code/hooks)を通じて統合されます。`failproofai policies --install` を実行すると、Claude Code の `settings.json` にフックコマンドが登録され、ツール呼び出しのたびに実行されます。
+
+<Steps>
+  <Step title="failproofai をインストールする">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="すべての組み込みポリシーを有効にする">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="フックが登録されたことを確認する">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    `PreToolUse`、`PostToolUse`、`Notification`、`Stop` イベントのフックエントリが表示されるはずです。
+  </Step>
+  <Step title="Claude Code を起動する">
+    ```bash
+    claude
+    ```
+
+    ポリシーはツール呼び出しのたびに自動的に実行されます。Claude に `sudo rm -rf /` を実行させようとしてみてください。ブロックされます。
+  </Step>
+</Steps>
+
+---
+
+## Agents SDK にフックを設定する
+
+[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) を使って開発している場合、同じフックシステムをプログラムから利用できます。
+
+<Steps>
+  <Step title="プロジェクトに failproofai をインストールする">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="エージェントにフックを設定する">
+    エージェントプロセスの作成時にフックコマンドを渡します。フックは Claude Code と同じ方法で、stdin/stdout JSON を介して発火します。
+
+    ```bash
+    failproofai --hook PreToolUse   # called before each tool
+    failproofai --hook PostToolUse  # called after each tool
+    ```
+  </Step>
+  <Step title="エージェント用のカスタムポリシーを作成する">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      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 is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="カスタムポリシーをインストールする">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## 破壊的なコマンドをブロックする
+
+最もよくある設定 — エージェントが取り消せないダメージを与えるのを防ぎます。
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+この設定でできること:
+- `block-sudo` — すべての `sudo` コマンドをブロック
+- `block-rm-rf` — 再帰的なファイル削除をブロック
+- `block-force-push` — `git push --force` をブロック
+- `block-curl-pipe-sh` — リモートスクリプトをシェルにパイプするのをブロック
+
+---
+
+## シークレットの漏洩を防ぐ
+
+エージェントがツール出力で認証情報を参照・漏洩しないようにします。
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+これらは `PostToolUse` で発火します。ツール実行後、エージェントが結果を受け取る前に出力をスクラブします。
+
+---
+
+## エージェントが応答待ちになったら Slack に通知する
+
+通知フックを使って、アイドル状態のアラートを Slack に転送します。
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  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 is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // never block the agent if Slack is unreachable
+    }
+
+    return allow();
+  },
+});
+```
+
+インストール:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## エージェントをブランチに固定する
+
+エージェントが別のブランチに切り替えたり、保護されたブランチにプッシュしたりするのを防ぎます。
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  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("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## コミット前にテストを要求する
+
+コミットする前にテストを実行するようエージェントに促します。
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-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("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## 本番リポジトリをロックダウンする
+
+プロジェクトレベルの設定をコミットして、チーム全員が同じポリシーを適用できるようにします。
+
+リポジトリに `.failproofai/policies-config.json` を作成します:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+コミットします:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+failproofai をインストールしているすべてのチームメンバーが、これらのルールを自動的に取得します。
+
+---
+
+## コンベンションポリシーで組織全体の品質基準を作る
+
+最も効果的な設定: プロジェクトに合わせたポリシーを含む `.failproofai/policies/` をリポジトリにコミットします。チームメンバー全員が自動的に取得できます — インストールコマンドも設定変更も不要です。
+
+<Steps>
+  <Step title="ディレクトリを作成してポリシーを追加する">
+    ```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="git にコミットする">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="継続的に改善する">
+    チームが新たな問題に直面したら、ポリシーを追加してプッシュしましょう。次回の `git pull` で全員が更新を受け取ります。これらのポリシーは、チームとともに成長する生きた品質基準となります。
+  </Step>
+</Steps>
+
+---
+
+## その他のサンプル
+
+リポジトリの [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) ディレクトリには以下が含まれています:
+
+| ファイル | 内容 |
+|------|---------------|
+| `policies-basic.js` | スターターポリシー — 本番環境への書き込み、force-push、パイプスクリプトのブロック |
+| `policies-notification.js` | アイドル通知とセッション終了時の Slack アラート |
+| `policies-advanced/index.js` | 推移的インポート、非同期フック、PostToolUse 出力スクラブ、Stop イベント処理 |

package/.next/standalone/docs-old/ja/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "エージェント向け"
+description: "1つのコマンドでFailproof AIの知識をコーディングエージェントに追加できます。Claude Code、Cursor、Windsurfなど様々なエージェントに対応しています。"
+---
+
+1つのコマンドで、Failproof AIのリファレンス全体をコーディングエージェントに追加できます。Claude Code、Cursor、Windsurf、そしてスキルをサポートするその他のエージェントでも動作します。
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` はインストール済みのエージェントを自動検出し、それぞれに適した形式でスキルを追加します。
+
+## スキルがカバーする内容
+
+| 分野 | 含まれる内容 |
+|------|-------------|
+| ポリシー | 組み込みポリシー名、イベントタイプ、パラメータ、有効化/無効化 |
+| カスタムポリシー | `customPolicies.add()`、マッチフィルター、`allow`/`deny`/`instruct` API |
+| コンテキストオブジェクト | `ctx.eventType`、`ctx.toolName`、`ctx.toolInput`、`ctx.session` |
+| 設定 | `policies-config.json` の構造、スコープのマージ、`policyParams` |
+| CLI | `failproofai policies --install`、`--uninstall`、`--custom`、スコープ |
+| ダッシュボード | セッションビューア、ポリシーアクティビティ、環境変数 |
+| アーキテクチャ | フックハンドラーのフロー、終了コード、stdin/stdout の仕様 |
+
+## スキルの内容は完全ですか？
+
+Mintlify はナビゲーション内の全ページから `llms.txt` を生成します。Failproof AI のドキュメントは完全な API をカバーしており、すべてのポリシー、オプション、サンプルが含まれています。不足している情報があれば、ソースは `https://docs.befailproof.ai/llms-full.txt` から確認できます。
+
+特定のコンテキストだけが必要な場合は、特定のページに直接リンクすることも可能です：
+
+```bash
+# カスタムポリシー API のみ
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# 組み込みポリシーのみ
+npx skills add https://docs.befailproof.ai/built-in-policies
+```