クイズ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のフックは、この開始時の1本と、ツールの実行の前後に動くものだけ。依頼を送ったときに動くフックは無い

• 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の確認の画面が出て、pushするかを人が決める