会社エージェントセーフガード
目的
Keshet社全体でAIコーディングエージェント向けに実用的で安全なセーフガードを定義・強制します。完全なサンドボックスセキュリティではなく、可視性と人間による確認を重視した危険なアクションの制御を提供します。Claude Code、Cowork、およびClaudeを使用するすべてのパイプライン・自動化に適用されます。デフォルトのポリシーカテゴリとアプリごとのファイル配置パスは reference.md に記載されています。
トリガー条件
AIエージェントセッションでは常にアクティブです。以下の場合に明示的に有効化します:Keshetプロジェクトで新しいセッションが開始されたとき、エージェントがシェル/Git/MCP呼び出しを実行しようとしているとき、ユーザーが広範な自律性を付与したとき(「任せる」)、パイプラインが設計・レビューされているとき、アクションがシークレットやプロジェクトディレクトリ外のファイルに触れようとするとき。
基本原則
- アクション領域を特定する:シェル、ファイル読み書き、Git、MCP呼び出し、パッケージインストール、フック、スキル、シークレット。
- 各制御を
拒否、確認、監視、ガイダンスに分類する。 - 広く曖昧なルールよりも、小さく明示的なルールを優先する。
- 開発者の生産性を維持する — 曖昧なアクションは確認し、明確に安全でないアクションのみ拒否する。
- 制限を明確に伝える:instructionファイルは動作を誘導するものであり、フックやエンドポイントツールはより強制力を持つ。しかし、真のコンテナ化がなければどちらも完全なOSサンドボックスにはならない。
ルール作成ワークフロー
- ルールの設置場所を確認する:個人設定、プロジェクト共有設定、またはその両方。
- カテゴリごとに何をすべきかを決定する:ブロック、確認、監視、許可。
- 最小限で有用なルールセットを草案する。
- ルールをトリガーするアクションの例を含める。
- 既知の制限(追加のサンドボックスやエンドポイント制御が必要なもの)を含める。
- ファイルを書き込む場合は、対象アプリのネイティブな場所を使用する。ポリシーの文言はアプリに依存しないようにする。
推奨デフォルトスタンス
会社からより厳格なポリシーが提供されない限り、以下を使用します:
- 拒否: シークレット漏洩、パイプ→シェル(
curl ... | sh)、サンドボックス/権限の無効化、破壊的なシステムコマンド(再帰削除、ディスクフォーマット、履歴消去)、資格情報ストアへのアクセス。 - 確認: git push/force-push、デプロイ、パッケージインストール、スキーマ変更、プロジェクトディレクトリ外への書き込み、組織承認リストにないMCPツール呼び出し。
- 監視: すべてのシェル実行、プロジェクト内ファイル書き込み、外部API呼び出し — ブロックせずにログ記録・可視化する。
やってはいけないこと
- 明示的なユーザー承認なしにMCPサーバー、フック、永続サービスをインストールしない
.envファイルや資格情報ファイルを読み取ったり、表示したり、コンテキストに渡したりしない- 確認なしに破壊的なシェルコマンドを実行しない
- 何がプッシュされるかをユーザーが正確に確認せずにgitにプッシュしたりデプロイしたりしない
- 現在のプロジェクトディレクトリ外のファイルパスにアクセスしない
- 失敗した操作を黙ってリトライしない — 常に失敗を表示する
- instructionのみのセーフガードファイルをOSレベルの強制とみなさない
- セキュリティレビューなしに未検証のソースからサードパーティのエージェントツールをインストールしない — 事前ビルドされたリリースアーティファクトをインストールするよりもソースレビューを優先し、チェックサム検証とパイロット環境を通じてインストールを行う
出力テンプレート
ガードレールセットを提案する際は、常に以下の形式で応答します:
## ガードレールサマリー
<保護対象の簡単な概要>
## ポリシー
- 拒否: <完全にブロックされるアクション>
- 確認: <ユーザーの明示的な確認が必要なアクション>
- 監視: <ブロックはせずログ記録・可視化するアクション>
## 作成・更新するファイル
- `<パス>`:<このファイルの目的>
## 制限
<このガードレールが強制しないもの — 追加のサンドボックスやエンドポイント制御が必要なもの>