willink-claude-kit

導入手順

Claude Code に、危ない操作を止める hook と、
exit code で合否を決めるゲートを入れる開発キットです。

何をするか

hook が、既定ブランチへの直接 push や .env などの秘匿ファイルへの書き込みを、実行される前に止めます（止める hook 3 本と、止めずに記録や注意だけを出す hook 7 本）。
合否はモデルの自己申告ではなく、スクリプトの exit code で決めます（決定論のゲートを skill として同梱）。
探索 → 計画 → 実装 → 並列検証 → 修正 / コミットの /build と、役割を分けた 4 つのサブエージェントを提供します。
MIT ライセンスの Claude Code plugin です。

前提

Claude Code（`claude plugin` コマンドが使える版）
git
python3（hook とスクリプトが使います）

個人で入れる

このマシンのすべてのプロジェクトで使います。

1
マーケットプレイスを追加
kit の配布元を Claude Code に登録します。2 回打っても問題ありません。
Terminal
```
claude plugin marketplace add willink-oss/willink-claude-kit
```
2
プラグインをインストール
`--scope user` で、このマシンのあなたのすべてのプロジェクトに入ります。
Terminal
```
claude plugin install willink-claude-kit@iwillink --scope user
```
3
Claude Code を起動し直す
起動し直すと hook・skill・/build が読み込まれます。

チームで入れる（リポジトリ単位）

リポジトリに設定を commit し、メンバーはそれぞれ 1 回だけ入れます。

1
1 人が: リポジトリの .claude/settings.json に書いて commit
値は boolean の true で書きます。["2.9.0"] のような配列にすると、有効と表示されたまま何も読み込まれなくなります。版は配布元の tag で固定されるので、ここで版を指定する必要はありません。
.claude/settings.json
```
{
  "extraKnownMarketplaces": {
    "iwillink": {
      "source": { "source": "github", "repo": "willink-oss/willink-claude-kit" }
    }
  },
  "enabledPlugins": {
    "willink-claude-kit@iwillink": true
  }
}
```
2
各メンバーが clone した後に 1 回: 2 つのコマンドを打つ
settings.json に書いてあっても、各自のマシンには自動では入りません。マーケットプレイスの追加を先に打たないと、インストールは「not found in marketplace」で失敗します。
Terminal
```
claude plugin marketplace add willink-oss/willink-claude-kit
claude plugin install willink-claude-kit@iwillink --scope project
```
3
打ち忘れを防ぐなら: clone 直後の手順を 1 つにまとめる
Makefile などの setup ターゲットに入れておくと、メンバーは make setup だけで済みます。
Makefile
```
setup:
	claude plugin marketplace add willink-oss/willink-claude-kit
	claude plugin install willink-claude-kit@iwillink --scope project
```

入ったかを確かめる

「インストールされている」と「読み込まれて効いている」は別です。両方を確かめます。

1
インストールされているか
一覧に willink-claude-kit@iwillink が出れば入っています。
Terminal
```
claude plugin list
```
2
読み込まれているか
リポジトリの中で、kit に同梱の診断スクリプトを実行します。版のフォルダ名を確かめてから、その版のものを実行します。HEALTHY と表示され exit 0 なら正常です。
Terminal
```
ls ~/.claude/plugins/cache/iwillink/willink-claude-kit/
bash ~/.claude/plugins/cache/iwillink/willink-claude-kit/<版>/scripts/check-kit-enabled.sh
```
3
hook が効いているか
Claude Code に「このリポジトリに .env を作って」と頼みます。次のように止められれば hook が効いています。止まらずに作られた場合は hook が効いていないので、作られた .env は消して、上の 2 つを確かめ直してください。
止められたときの表示
```
BLOCKED: .env files may contain secrets.
```

更新する・外す

更新の後は Claude Code を起動し直すと反映されます。

1
更新する
配布元の情報を取り直してから、プラグインを更新します。
Terminal
```
claude plugin marketplace update iwillink
claude plugin update willink-claude-kit@iwillink
```
2
外す
入れたときと同じ scope を指定します。チームで入れた場合は、settings.json の該当行も消して commit します。
Terminal
```
claude plugin uninstall willink-claude-kit@iwillink --scope project
claude plugin marketplace remove iwillink
```

もっと詳しく

各機能の説明・設計の考え方・既知の失敗パターンは GitHub の README とドキュメントにあります。

GitHub: willink-oss/willink-claude-kit プロダクト紹介