Skip to main content
Failproof AI は、リポジトリがコミットできるもの（フックの配線、ポリシーパラメーター、カスタムポリシー）と、認証情報・インストール済みパック・デーモンなどのマシン状態を分けて管理します。

​
スコープの選択

スコープはフックの配線先と、パラメーターおよびカスタムポリシーパスを記述する設定ファイルを決定します。
  • User — このマシン上のすべてのプロジェクトに適用されます。
  • Project — リポジトリに属し、コミット可能です。
  • Local — 特定のプロジェクトを特定のユーザー向けにオーバーライドします。gitignore に追加しておく必要があります。
すべてのハーネスがローカルスコープに対応しているわけではありません。選択したハーネスがサポートしていないスコープを指定すると、CLI はエラーを返します。 どのパックポリシーが有効かはスコープの影響を受けません。この設定はインストール済みパックに記録されるため、failproofai policies add <name> を実行すると、--scope の指定に関わらずマシン全体でそのポリシーが有効になります。 ポリシーパラメーターは、そのポリシーのパラメーターを定義している最初のスコープが使用されます（優先順位: project → local → user）。明示的なカスタムポリシーパスも、それを定義している最初のスコープが使用されます。

​
ポリシーパラメーターの設定

ローカルダッシュボードでポリシーを開き、サポートされているパラメーターを編集して、選択したスコープで保存します。一致するエージェントアクションと一致しないエージェントアクションをそれぞれ実行し、Observe → policy で判定内容を確認します。

​
Failproof AI ポリシーが受け付けるパラメーター

各ポリシーは独自のパラメーター型を検証します。
許可パターンはエージェントが実行できる範囲を広げます。フリート全体に展開する前に、対象のハーネス上でトークナイズの挙動やコマンドのバリエーションを正確にテストしてください。

​
マシンファイルの構成

~/.failproofai には、信頼境界ごとに個別のファイルが格納されています。 コンテナや隔離テスト環境のためにマシン全体のレイアウトを移動するには FAILPROOFAI_HOME を使用してください。個々の状態ディレクトリを個別に移動することは避けてください。
credentials.json は絶対にコミットしないでください。プロジェクトのポリシー設定およびプロジェクトのコンベンションポリシーをコミットする場合は、必ず強制コードとして内容を確認してからにしてください。