ビルトインポリシーカタログ

インストール済みパッケージがポリシーの利用可否に関する唯一の情報源です。パッケージをアップグレードするたびに failproofai policies を実行してください。カタログのエントリや動作はパッケージバージョンによって変わることがあります。

推奨ベースライン

ガイド付きセットアップの推奨選択では、現在、シークレットサニタイザー、環境保護、自己保護、致命的コマンドガード、保護ブランチの安全策が有効化されます：

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-failproofai-commands   block-sudo
block-curl-pipe-sh           block-rm-rf
block-push-master            block-force-push

block-failproofai-commands は常に有効です。上記に記載しているのは網羅性のためであり、有効なセットに含まれているかどうかに関係なく、すべての評価時に登録されます。無効化や一時停止はできません。エージェントが無効にできる「エージェントによる強制のオフ」に対するガードは、ガードとして機能しないからです。推奨設定は意図的にすべてよりも範囲を絞っています。インフラや開発ワークフローのポリシーは正当な作業を中断させる可能性があるため、それらを必要とするリポジトリやマシンに限定して有効化すべきです。

シークレットと環境

ポリシー	トリガー	結果
`sanitize-jwt`	`PostToolUse`	モデルに渡る前にツール出力から JWT を削除する。
`sanitize-api-keys`	`PostToolUse`	OpenAI、Anthropic、GitHub、AWS、Stripe、Google の主要なキーを削除する。
`sanitize-connection-strings`	`PostToolUse`	認証情報を含むデータベース接続文字列を削除する。
`sanitize-private-key-content`	`PostToolUse`	PEM 秘密鍵の本文を削除する。
`sanitize-bearer-tokens`	`PostToolUse`	Authorization ベアラートークンを削除する。
`protect-env-vars`	シェルツール上の `PreToolUse`	環境変数をダンプするコマンドをブロックする。
`block-env-files`	`PreToolUse`	`.env` ファイルの読み取りおよび書き込みをブロックする。
`block-read-outside-cwd`	読み取り・glob・grep・シェルツール上の `PreToolUse`	読み取りをセッションの作業ディレクトリ内に限定する。
`block-secrets-write`	書き込みツール上の `PreToolUse`	一般的なシークレットキーや認証情報ファイル名への書き込みをブロックする。

危険なコマンドとインフラ

ポリシー	トリガー	結果
`block-sudo`	`PreToolUse`、`PermissionRequest`	allow パターンに一致しない限り `sudo` をブロックする。
`block-curl-pipe-sh`	`PreToolUse`	ダウンロードしたスクリプトをシェルに直接パイプすることをブロックする。
`block-rm-rf`	`PreToolUse`	致命的な再帰削除パターンをブロックする。
`block-failproofai-commands`	`PreToolUse`、`PermissionRequest`	常に有効、無効化不可。 Failproof AI CLI のすべての呼び出し、自己一時停止、パッケージマネージャーによるアンインストールをブロックする。
`block-kubectl`	`PreToolUse`	Kubernetes コマンドをゲートする。
`block-terraform`	`PreToolUse`	Terraform および OpenTofu コマンドをゲートする。
`block-aws-cli`	`PreToolUse`	AWS CLI コマンドをゲートする。
`block-gcloud`	`PreToolUse`	Google Cloud CLI コマンドをゲートする。
`block-az-cli`	`PreToolUse`	Azure CLI コマンドをゲートする。
`block-helm`	`PreToolUse`	Helm コマンドをゲートする。
`block-gh-pipeline`	`PreToolUse`	GitHub CLI の変更を伴うワークフロー・実行・マージ・リリース・キャッシュ・シークレット操作をゲートする。

Git とデータベースの安全性

ポリシー	トリガー	結果
`block-push-master`	`PreToolUse`	設定された保護ブランチへの直接プッシュをブロックする。
`block-force-push`	`PreToolUse`	フォースプッシュをブロックする。現在の実装では `--force-with-lease` は引き続き許可される。
`block-work-on-main`	`PreToolUse`	保護ブランチへのコミットおよびマージをブロックする。
`warn-git-amend`	`PreToolUse`	`--amend` によるコミットの書き換え前に警告する。
`warn-git-stash-drop`	`PreToolUse`	スタッシュを永続的にドロップまたはクリアする前に警告する。
`warn-all-files-staged`	`PreToolUse`	広範な `git add -A`、`git add .`、`git add --all` に対して警告する。
`warn-destructive-sql`	`PreToolUse`	認識されたデータベースクライアント経由で `WHERE` なしの `DROP`、`TRUNCATE`、`DELETE` が実行される前に警告する。
`warn-schema-alteration`	`PreToolUse`	認識された `ALTER TABLE` のカラム操作やリネーム操作に対して警告する。

パッケージ、システム動作、エージェントループ

ポリシー	トリガー	結果
`warn-package-publish`	`PreToolUse`	パッケージレジストリへの公開前に警告する。
`warn-global-package-install`	`PreToolUse`	グローバルパッケージのインストール前に警告する。
`prefer-package-manager`	`PreToolUse`	許可されたパッケージマネージャーを使用するようエージェントに指示する。
`warn-large-file-write`	書き込みツール上の `PreToolUse`	設定されたファイルサイズしきい値を超えた場合に警告する。
`warn-background-process`	`PreToolUse`	デタッチまたは長期実行のバックグラウンドプロセスパターンに対して警告する。
`warn-repeated-tool-calls`	`PreToolUse`	同一のツール呼び出しが 3 回以上繰り返された場合に警告する。

タスク終了時のワークフロー

これらのポリシーは、互換性のある Stop イベントを発行するハーネスを必要とします。

ポリシー	結果
`require-commit-before-stop`	トラッキングされた作業がコミットされていない間は完了を拒否する。
`require-push-before-stop`	コミットがローカルのみの間は完了を拒否する。
`require-pr-before-stop`	現在のブランチに対してプルリクエストを要求する。
`require-no-conflicts-before-stop`	設定されたベースブランチに対してクリーンなマージを要求する。
`require-ci-green-before-stop`	現在の HEAD の CI チェックが正常に完了することを要求する。

パラメーターリファレンス

選択したスコープの policyParams オブジェクト配下でパラメーターを設定します。型は各ポリシーによって検証されます。

ポリシー	パラメーター	型とデフォルト値
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`、`[]`；エントリには `regex` と `label` が含まれる
`block-read-outside-cwd`	`allowPaths`	`string[]`、`[]`
`block-sudo`	`allowPatterns`	`string[]`、`[]`
`block-rm-rf`	`allowPaths`	`string[]`、`[]`
インフラブロッカー	`allowPatterns`	`string[]`、`[]`
`block-secrets-write`	`additionalPatterns`	`string[]`、`[]`
`block-push-master`	`protectedBranches`	`string[]`、`["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`、`["main", "master"]`
`prefer-package-manager`	`allowed`、`blocked`	`string[]`、`[]`
`warn-large-file-write`	`thresholdKb`	`number`、`1024`
`require-push-before-stop`	`remote`、`baseBranch`	`string`、`"origin"`；`string`、`"main"`
`require-pr-before-stop`	`baseBranch`	`string`、`"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`、`"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

allow パターンはエージェントが実行できる範囲を広げます。フリートへの展開前に、対象ハーネス上でトークン化の詳細とコマンドのバリエーションを正確にテストしてください。

​推奨ベースライン

​シークレットと環境

​危険なコマンドとインフラ

​Git とデータベースの安全性

​パッケージ、システム動作、エージェントループ

​タスク終了時のワークフロー

​パラメーターリファレンス

推奨ベースライン

シークレットと環境

危険なコマンドとインフラ

Git とデータベースの安全性

パッケージ、システム動作、エージェントループ

タスク終了時のワークフロー

パラメーターリファレンス