クイズ10問と解説

• rules/core.md は、どのセッションでも開始時に全文が読み込まれるルールのファイル。上限は80行と決めている
• harness/check-guidelines.sh が、コミットの前と push の前に動く。core.md の行数を wc -l で数え、80行を超えていたら止める

• core.md は今79行。1行が600文字のルールを1本足して、80行にした。これをコミットする

check-guidelines.sh の行数の検査はどうなる?

1. A. 通る。80行を超えていないので、コミットできる
2. B. 止まる。1行が長すぎる
3. C. 止まる。上限の80行ちょうどになった
4. D. 警告だけが出て、コミットできる

• CLAUDE.md の中に @ファイル名 と書いたファイルは、セッションを開いた時点で中身ごと読み込まれる
• D2 の CLAUDE.md は、7行目の @AGENTS.md で AGENTS.md を読み込んでいる
• AGENTS.md の「読み分けガイド」には、「コーディングの前に agents/03(コーディング規約)を読むこと」と文章で書いてある。@ は付いていない
• 開始時に動くフック sessionstart_info.ps1 が出すのは、ブランチ名と変更の状態だけ

• D2 のリポジトリで新しいセッションを開いた。まだ何も頼んでいない

この時点で、agents/03 の中身は読み込まれている?

1. A. 読み込まれている。AGENTS.md と一緒に読み込まれる
2. B. 読み込まれていない。コーディングを頼まれたときに、読むかどうかを Claude が決める
3. C. 読み込まれていない。最初の依頼を送ったときに、フックが読み込ませる
4. D. 読み込まれている。開始時のフックが全文を読み込ませる

• D2 では、DB/(SQL ファイルの置き場)を書き換えてよいのは develop と master のブランチだけ
• .claude/hooks/guard_db_branch.ps1 は、Edit と Write の実行前(PreToolUse)に動くフック。今のブランチが develop と master 以外で、書き先が DB/ の中なら、理由を stderr に書いて終了コード 2 を返す

• feature/s6000/s6010_d2_document ブランチで、Claude が Write で DB/sql/x.sql を新しく作ろうとした

どうなる?

1. A. 何も起きず、そのまま作られる
2. B. 作られた後で、警告だけが Claude に返る
3. C. 作られる前に止まり、止めた理由が Claude に返る
4. D. 確認の画面が出て、人が許可すれば作られる

• 既存の migration(app/Database/Migrations/ の中)は書き換えず、新しく足す決まり。backend ユニットの .claude/immutable-paths(書き換え禁止の一覧)に載っている
• guard-write-scope.sh は、Edit と Write の実行前に動く。書き先が担当範囲の外か、immutable-paths に載っていれば止める
• guard-bash-write.sh は、Bash の実行前に動く。止める条件は、書き先が担当範囲の外であることだけ
• app/Database/Migrations/ は、backend ユニットの担当範囲の中にある

• Claude が Bash で sed -i 's/old/new/' app/Database/Migrations/001_init.php を実行しようとした(確認の画面は出ない設定とする)

どうなる?

1. A. guard-bash-write.sh が、immutable-paths に載っているとして止める
2. B. guard-bash-write.sh が、担当範囲の外への書き込みとして止める
3. C. どちらのフックも止めず、ファイルが書き換わる
4. D. guard-write-scope.sh が、Bash の書き込みも見て止める

• D2 では、テキストファイルの改行は CRLF と決めている
• .claude/hooks/check_crlf_bom.ps1 は、Edit と Write の実行後(PostToolUse)に動くフック。LF だけの改行を見つけると、理由を stderr に書いて終了コード 2 を返す

• feature/s6000/s6010_d2_document ブランチで、Claude が Write で、LF 改行の doc/notes/memo.md を新しく作った

どうなる?

1. A. ファイルは作られたまま残り、検査の結果が Claude に返る
2. B. 書く前に止められ、ファイルは作られない
3. C. 書いた後で、フックが自動で CRLF に直す
4. D. 何も起きず、LF のまま残る

• ハーネスのフックの本体(正本)は、smart3pm_guidelines フォルダに1つだけある
• 各ユニットの .claude/settings.json のフックは、親のフォルダをたどって正本を探し、見つけた本体を呼ぶ短いコマンドになっている。Bash の実行前に動くコマンドの要所は [ -r "$H" ] || { …; exit 2; }
• $H は見つけた本体のパス。[ -r "$H" ] は「そのファイルが読めるか」を確かめる書き方で、読めなければ || の後ろが動く

• 親のどこにも smart3pm_guidelines が無い場所でユニットを開いた。Claude が最初に Bash で ls を実行しようとした

どうなる?

1. A. ls は実行され、エラーの文が画面に出るだけ
2. B. 確認の画面が出て、人が決める
3. C. ls は実行され、その後で Claude に警告が返る
4. D. ls は実行されず、正本が見つからないことが Claude に返る

• D2 の作業の順番は、実装 → レビュー②(人が行う2回目のレビュー)→ マージ待ち → マージ
• .claude/agents/d2-code-reviewer.md は、レビュー②の前に差分を読むサブエージェント。定義ファイルで permissionMode を plan(読むだけ)にし、「コードを直さない」「人が確かめる点を分けて書く」と決めている

• 実装が終わり、d2-code-reviewer を動かした

実際に起こるのはどれ?

1. A. 見つけた誤りを、レビュー役がその場で直してコミットする
2. B. 指摘が無ければ、状態が自動でマージ待ちに進む
3. C. 重大な指摘があれば、実装の担当に自動で差し戻される
4. D. 差分の問題点が根拠つきで報告される。コードは変わらず、次に進めるかは人が決める

• ゲート①は、人が計画書を承認する工程。承認すると new-approval-receipt.sh が、計画書の sha256 をレシートに書く
• sha256 は、ファイルの中身から計算する指紋のような値。1文字でも変わると別の値になる
• verify-approval-receipt.sh は、作業フォルダにある今の計画書から sha256 を計算し直し、レシートの値と比べる

• 承認(レシートの発行とコミット)の後で、担当ユニットの plan-backend.md の誤字を1文字直した。まだコミットしていない

verify-approval-receipt.sh の結果は?

1. A. レシートが自動で書き直され、有効のまま
2. B. 警告は出るが、有効(終了コード 0)
3. C. 失効(終了コード 1)
4. D. まだコミットしていないので、変更は見られず有効(終了コード 0)

• D2 では、push、マージ、ブランチ作成は人の作業と決めている
• .claude/settings.json の deny に Bash(git push:*) と PowerShell(git push:*) がある
• guard_shell_policy.ps1 も、Bash と PowerShell の実行前に git push を見つけると、終了コード 2 を返す

• 夜、誰も画面を見ていない状態で Claude に Issue を実装させた。実装の後で、Claude が git push origin feature/s7000/s7001_x を実行しようとした

どうなる?

1. A. 確認の画面が出て、朝に人が許可するまで待ち続ける
2. B. 実行の前に拒否される。push は人の作業として残る
3. C. push された後で、ログに警告が出る
4. D. 夜間の実行では deny が効かず、push される

• smart3pm の最後の検査は、git の pre-push フック。push の直前に、手元の PC で動く
• GitLab 側(サーバ)には検査を置いていない(design/harness-server-free.md)
• ワークスペースでセッションを開くと、検査を通っていない push があれば警告を出す

• 人が端末で git push --no-verify を実行した

何が起こる?

1. A. 検査を通らずに push される。あとでセッションを開いたときに警告が出る
2. B. pre-push のフックが止め、push は失敗する
3. C. GitLab 側の検査が止め、push は拒否される
4. D. Claude Code の確認の画面が出て、人が決める