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

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

既存システム全体をClaude Codeに任せるなら、「ゴール→制約→構造→詳細」の順で渡すのが最も失敗しにくい設計です。

• まず「何を達成したいか＝ゴール」を1〜2行で先に宣言する（例：『この機能を設計変更して、既存テストが全部通る状態にして』）。ゴールが曖昧だとClaude Codeが「良かれと思って」余計な箇所まで書き換えてしまうリスクが上がります。

• 渡す順番のおすすめは ①運用ルール＆制約（絶対に変えてはいけない箇所）→②要件定義書＆ER図（全体構造）→③API仕様書（インターフェース）→④既存コード（実装）→⑤テストコード（期待挙動）→⑥過去障害履歴（地雷マップ） の順です。制約を最初に渡すことで、AIが「やってはいけないこと」を踏み越えるのを防げます。

• 粒度は「全部一気に渡さない」が鉄則です。フォルダ分けして、今回のタスクに関係するファイルだけを渡す。全コードを一気に読ませるとトークン（AIの処理量）が溢れて重要な部分を見落とします。「今回はこのモジュールだけ触って」と範囲を絞るのが実務の正解です。

• AIが最もやらかしやすい勘違いトップ3：①「暗黙の前提」の読み飛ばし（例：『このフラグはレガシー互換のために残している』を知らずに削除）②テスト通過を「完成」と判断して設計の意図がズレていても気づかない③過去障害の再現条件を知らずに同じ設計パターンを繰り返す。

• これを防ぐには CLAUDE.mdに「触ってはいけないファイル・関数・フラグ一覧」と「過去にやらかしたパターン＝再発防止ルール」を書いておくのが一番効きます。ミスが出たらその都度ルールを追記していくと、2回目以降は同じミスをしなくなります。

• レビュー手順は 「差分だけを見る（全体を見ない）」→「テストを先に通す」→「変更理由をAIに言語で説明させる」 の3ステップがおすすめです。特に「なぜこう変えたか」を書き出させると、AIが誤解したまま進んでいるケースをすぐ発見できます。

今日からCLAUDE.mdに制約ルールを1行追加するだけでも、ぐっと失敗が減りますよ。