操作と止まる層
左の操作を1つ選んでください。
書く前に止まる
Claudeがファイルを書く直前に、guard_pathsが.claude/protected-pathsの一覧と照らします。db/schema.sqlは一覧にあるので、書く前に止まり、ファイルは変わりません。
BLOCKED by guard_paths: 'db/schema.sql' is protected確認なしで止まる
強制pushは禁止(deny)の一覧にあり、確認のダイアログも出さずに拒否されます。block-destructiveのフックも、同じコマンドを止めます。
[block-destructive] force-push: force pushes. Published history is rewritten and nobody can recover it from their clone.人に聞く
ふつうのpushは確認(ask)の一覧にあり、ダイアログにコマンドが出ます。ブランチ名を見て、人が許可するか拒否するかを決めます。
Push the branch to origin の run を許可しますか書いた直後に知らせる
書いた後のフックcheck-phpverが、PHP 7.4で動かない書き方を見つけてClaudeに返します。Claudeが直さなくても、GitLabのlint-phpverが赤にして止めます。
[check-phpver] code that PHP 7.4 cannot run:コミットの前に止まる
pre-commitがCLAUDE.mdの行数を数え、80行を超えているのでコミットを止めました。
NG CLAUDE.md: 85 lines (max 80) The commit was stopped.GitLabで止まる
手元の検査は--no-verifyで素通りしますが、GitLabのcheck-rulesが同じ約束を見て赤にします。赤のMRには、マージのボタンが出ません。
Merge blocked: 1 check failed Pipeline must succeed.保護されたmainが拒否する
mainに直接pushできる人は、誰もいない設定です。講師もMaintainerも、変更はMRで入れます。
remote: GitLab: You are not allowed to push code to protected branches on this project.実装の直前に止まる
順番が来たジョブは、Claudeを呼ぶ前にIssueを読み直します。承認のラベルが無いので、実装しません。
承認のラベル ai::approved が外れていたので、実装しませんでした。実装せずに質問を返す
Claudeは決められないことを自分で決めず、質問を書いて終えます。スクリプトがai::stoppedを付け、質問をコメントに書きます。
受け入れ条件が決まっていないため、実装しませんでした。Claude が挙げた点は次のとおりです。確認なしで拒否される
夜のClaudeには、pushの権限を渡していません。許可の外の操作は確認を出さずに拒否され、ログに記録が残ります。pushは、ジョブのスクリプトだけが行います。
DENIED: Bash {"command":"git push origin HEAD"}MRを出す前に止まる
ci/は手元のフックの一覧には無いので、書くことはできます。ただし実装ジョブが、MRを出す前にci/の変更を見つけて止めます。
触らない場所に変更があったので、MR を出しませんでした。ai_scopeが止める
REVIEW.mdは実装ジョブの一覧に無いので、MRまで出ます。MRのパイプラインでai_scopeがmainの側の一覧と照らし、赤にします。
NG REVIEW.md AI を止める仕組みか約束の文書です(ci/ai_scope.paths)注意を付けて人に渡す
ai_scopeは止めずに、注意で知らせます。表示だけの変更のように、テストが無くてもよい場合があるからです。マージするかは、注意の行を読んだ人が決めます。
注意 app/ を変えたのに tests/ を変えていません。テストで確かめていない変更です判断は人に残す
ai_gateはP0とP1の指摘で赤になりますが、研修の時点では失敗を許す設定です。黄色の注意で終わり、マージを止めるかは人が決めます。本当に止めるようにするのが、レベル3の課題です。
判定は ai_gate ジョブが行いますClaude Desktopに頼んだ操作の行き先
Claude Desktopに頼んだ操作がそのまま動くか止まるかは、研修リポジトリの設定とフックで決めてあります。聞いてから動く操作では、確認のダイアログが出ます。
| 頼んだこと | 起きることと、決めている所 |
|---|---|
| ファイルを読む、コードを説明する | そのまま動き、ダイアログは出ない。読むだけの操作は、手動のモードでも許可が要らない |
| ファイルを書き換える(Edit、Write) | 1回ごとに確認のダイアログが出る。権限のモードが「手動」のため |
コマンドを打つ(git switch、git commit、テストなど) | 1回ごとに確認のダイアログが出る。allowには何も書いていない |
git push | 必ず確認のダイアログが出る。.claude/のaskに書いてある |
| mainへのpush | ダイアログで許可しても、GitLabの保護ブランチが受け付けない |
| MRのマージ | できない。mainに入るのはMRの画面のマージだけで、押せるのはMaintainerの講師 |
app/、db/、db/をEditやWriteで書き換える | ダイアログが出る前にフックguard_pathsが止め、理由がClaudeに返る。一覧は.claude/ |
| 同じファイルにPowerShellのコマンドで書く | 止まらない。guard_pathsはEditとWriteにしか付いていないので、ダイアログで許可すると書けてしまう(プチ演習4。レベル3で塞ぐ) |
git reset --hard、git push --force、git checkout --、git clean | ダイアログを出さずに止まる。4つともsettings.jsonのdenyにあり、git reset --hardとgit push --forceはフックblock-destructiveも止める |
git restoreで変更を捨てる | ダイアログで許可すれば動く。演習の戻しに使うので止めていない。コミットしていない変更は消える |
rm -rf、Remove-Item -Recurse | ダイアログを出さずに止まる。フックblock-destructiveが止める |
.envと認証情報を読む | 止まる。Readで開くのはsettings.jsonのdenyが、シェルのコマンドで触るのはフックblock-destructiveが止める |
| テストが赤のまま、作業を終える | 研修のPCにはPHPを入れていないので、フックstop-gateは何もせずに終わる。PHPがあるPCでは、ファイルを変えたまま終えるとテストを回し、赤なら直しを続けさせる(1セッションで2回まで) |
| GitLabのIssueやパイプラインの画面を読む | できない。研修のGitLabはログインしないと開けないので、本文やログは受講者が貼って渡す |
Claude Desktopで使えるコマンドと使えないコマンドは、GitLabの基礎の「Claude Desktopへの頼み方」にあります。
層ごとの役割
| 層 | 止めるもの | 飛ばせるか |
|---|---|---|
| 1権限の設定 | 強制push、git reset --hard、.envの読み出し。夜はpushとcurlも | 手元は設定を書き換えれば外せる。夜のジョブは外せない |
| 2書く前のフック | 触らない場所への書き込み、壊すコマンド | 手元は外せる。本体を消すと素通りするので、プチ演習8でラッパー(run_hook)に替え、止まる形を確かめる |
| 3書いた後のフック | PHP 7.4で動かない書き方 | 手元は外せる。GitLabのlint-phpverが拾う |
| 4コミットの前 | CLAUDE.mdの行数の超過 | --no-verifyで飛ばせる。GitLabのcheck-rulesが拾う |
| 5実装ジョブの確かめ | 承認の無いIssue、決まっていないことの残るIssue、触らない場所の変更 | 受講者からは外せない |
| 6 MRのパイプライン | 構文、テスト、AIの止め金の書き換え | 受講者からは外せない |
| 7 mainの保護 | 直接のpush、赤のMRのマージ | 外せるのは管理者の設定だけ |
| 8人の判断 | 受け入れ条件と合わない変更 | ここは人にしか置けない |
上の層ほど速く止まり、下の層ほど外しにくい作りです。手元のフックは飛ばせる速報で、飛ばされても6と7で止まります。