Myr-Aya/GouvernAI-claude-code-plugin

GouvernAI-claude-code-plugin は何をしますか？

Claude Code のランタイムガードレール。安全な操作を自動承認し、リスクのある操作にゲートをかけ、危険な操作をブロックします。二重実行防止と完全な監査証跡を提供します。MIT ライセンス。

概要

GouvernAI は Claude Code のエージェントアクションを実行前に評価・制御するセキュリティプラグインです。以下の3つのカテゴリでアクションを分類します：

1. 自動承認 (Auto-approve) - 安全なコマンド（例: ls, git status）や読み取り専用操作は自動的に実行されます。
2. ゲート (Gate) - ファイル変更やネットワーク通信などリスクのある操作は、ユーザー承認が必要です。
3. ブロック (Block) - rm -rf / や機密情報の漏洩など危険な操作は即座にブロックされ、実行されません。

特徴

• 二重実行防止 (Dual enforcement) - プラグインと Claude Code の両方でポリシーを強制します。
• 完全な監査証跡 (Full audit trail) - すべてのアクション評価と決定をログに記録します。
• カスタマイズ可能なポリシー - YAML 設定ファイル (gouvernai.yaml) でルールを柔軟に定義できます。
• MIT ライセンス - 自由に使用、変更、再配布できます。

インストール

# リポジトリをクローン
$ git clone https://github.com/Myr-Aya/GouvernAI-claude-code-plugin.git

# Claude Code の設定にプラグインを追加
$ cp -r gouvernai-claude-code-plugin/* ~/.claude/plugins/

# 設定ファイルを編集（必要に応じて）
$ vim ~/gouvernai.yaml

設定例 (gouvernai.yaml)

policies:
  auto_approve:
    - command: "^ls$"
    - command: "^git status$"
    - command: "^cat .+$"

  gate:
    - command: "^git push$"
    - command: "^rm .+$"
    - command: "^curl .+$"

  block:
    - command: "^rm -rf /$"
    - command: ".*secret.*"
    - command: ".*password.*"

使用方法

# Claude Code を起動（プラグインが自動的にロードされます）
$ claude code

# ログを確認
$ cat ~/.claude/plugins/gouvernai/audit.log

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください。

コントリビューション

バグ報告や機能リクエストは Issues へお寄せください。プルリクエストも歓迎します。