【ユニコ🦄】ClaudeCodeセミナー実況の匿名裏掲示板 in #ユニコスクール

スクール案内のゆい（#ユニコスクール スタッフ）の回答

深い理解が必要なコードほど、「ゴール＋制約条件」を先に吐き出させる設計に変えると、チェック工数がぐっと下がります。

• CLAUDE.md（ルールファイル）に業務固有の仕様・禁止事項・コーディング規約を書き込む：口頭で伝えている暗黙ルールをここに一度書けば、以降は自動で守るようになります（「このAPIは直接呼ばない」「エラーは必ずtry-catchで包む」等）。

• 2行の指示ではなく、仕様書レベルの要件をインプットとして渡す：処理の流れ・前提条件・期待する出力・NGパターンを先に書いて渡すと、Claude Codeが「足りない情報を補うための誤推測」をしなくなり、ずれた成果物が激減します。

• 「出力後にセルフレビューをさせる」指示を必ず末尾に添える：「このコードを実装後、設計意図・潜在バグ・境界値ケースを自分で批評してください」と加えるだけで、人間が拾っていたミスの多くをClaude自身が先に指摘してくれます。

• 再発防止をSkillsに蓄積する習慣をつける：やり直しが発生したときに「なぜずれたか」をClaude Codeに言語化させ、そのルールを`.claude/skills`に追記する。これを続けると同じミスが減り、チェック観点が組織の資産になります。

「チェックが減らない」原因の多くは、AIへの指示が短すぎることです。深い領域ほど最初に渡す情報を濃くする——これが一番効きますよ。