Claude Codeを使っていて指示通りに動かない本当の理由を解説します。多くの人が手順（Loop）で悩んでいますが、重要なのは土台となるHarness設計です。キッチンとレシピの関係に例えながら、.claude/フォルダを活用した正しい構造について説明します。
ねえ、Claude Codeを使ってて「指示通りに動かない！」って悩んでない？実はそれ、あなたのプロンプトのせいじゃないかもしれないよ。 多くの人が「ループ（手順）」と戦ってるけど、本当の問題は、その下の「土台」が整ってないことにあるんだ。 例えるなら、Harness（土台）はキッチン。Loop（手順）はレシピ。レシピだけあっても、キッチンがなければ料理は作れないよね。 成功しているプロジェクトには必ず「.claude/」っていうフォル…
シーン 1
ねえ、Claude Codeを使ってて「指示通りに動かない！」って悩んでない？実はそれ、あなたのプロンプトのせいじゃないかもしれないよ。
Kurage VTuber looking confused at a computer screen with error messages, vertical 9:16, clean virtual studio, light gradient background, presenter safe zone, 5600K key light
シーン 2
多くの人が「ループ（手順）」と戦ってるけど、本当の問題は、その下の「土台」が整ってないことにあるんだ。
A person trying to build a house on sand vs solid rock, vertical 9:16, floating UI panels, soft rim light, friendly AI explainer atmosphere
シーン 3
例えるなら、Harness（土台）はキッチン。Loop（手順）はレシピ。レシピだけあっても、キッチンがなければ料理は作れないよね。
A kitchen layout vs a recipe book side by side, vertical 9:16, white tech studio, subtle data particles, caption-safe lower area
シーン 4
成功しているプロジェクトには必ず「.claude/」っていうフォルダがあるよ。ここを正しく構成するのが鍵なんだ。
Zoom in on a folder named .claude inside a code editor, vertical 9:16, professional educational set, calm motion graphics, bright optimistic lighting
シーン 5
具体的には、CLAUDE.md、settings.json、hooks、agents、skills、MCP設定、そしてMEMORY.mdの計7つ。
Seven icons representing different config files floating around, vertical 9:16, clean virtual studio, light gradient background, presenter safe zone, 5600K key light
シーン 6
これがAIの行動を規定するルールになるよ。
Seven icons representing different config files floating around, vertical 9:16, floating UI panels, soft rim light, friendly AI explainer atmosphere
シーン 7
まずはCLAUDE.mdから。でも注意！300行を超えると、逆に精度がガタ落ちすることが研究でわかってるんだ。常に削って最適化してね。
A text document being trimmed with scissors to stay small, vertical 9:16, white tech studio, subtle data particles, caption-safe lower area
シーン 8
次にsettings.json。プロジェクト固有のルールや環境変数をここに書くことで、AIが勝手に迷走するのを防げるよ。
A settings menu with toggles and checkboxes, vertical 9:16, professional educational set, calm motion graphics, bright optimistic lighting
シーン 9
もっと高度にするなら、agentsフォルダで検証用エージェントを分けるとか、skillsで頻出タスクを専門化させるのがプロの技。
Multiple small robot icons working on different tasks, vertical 9:16, clean virtual studio, light gradient background, presenter safe zone, 5600K key light
シーン 10
トークンが爆発するのはHarnessの問題。ループが収束しないのはLoopの問題。原因を層で切り分けるだけで、デバッグは劇的に楽になるよ。
A diagram showing two layers: Harness (bottom) and Loop (top), vertical 9:16, floating UI panels, soft rim light, friendly AI explainer atmosphere
シーン 11
大事なのは順番！必ず「土台」を先に作ってから、「手順」を乗せること。土台がない状態でループを回すのは、穴の上に家を建てるようなものだからね。
Building a solid floor before placing a loop structure on top, vertical 9:16, white tech studio, subtle data particles, caption-safe lower area
シーン 12
今夜からできること。まずは.claudeフォルダを開いてファイル数を数えてみて。足りなければCLAUDE.mdから作り始めよう！
Kurage pointing at a checklist of files to create, vertical 9:16, professional educational set, calm motion graphics, bright optimistic lighting
シーン 13
土台がしっかりしていれば、AIは迷わなくなる。まずは床を作るところから始めようね！
Kurage smiling and giving a thumbs up in front of a stable structure, vertical 9:16, clean virtual studio, light gradient background, presenter safe zone, 5600K key light
Kurage URL2Earn — この動画ページのURLをXやブログで紹介すると、10,000 URLAI トークンをKurageさんがお届け（1人1回・先着制）。受け取り方を見る →
