AIコーディングの暴走を防ぐ4原則！Karpathy流Claude Code調教術 — andrej-karpathy-skills

4つの原則の詳細

1. Think Before Coding（コードを書く前に考える）

• 不明点があれば推測せず質問する
• 曖昧な場合は複数の解釈を提示する
• よりシンプルなアプローチがあれば提案する
• 混乱したら立ち止まって確認する

2. Simplicity First（シンプルさ最優先）

• 依頼された以上の機能を追加しない
• 一度しか使わないコードに抽象化を適用しない
• 起こり得ないシナリオのエラーハンドリングを書かない
• 200行が50行にできるなら書き直す
• 判定基準:「シニアエンジニアが見て複雑すぎると言うかどうか」

3. Surgical Changes（外科手術のような精密な変更）

• 隣接するコードやコメントを「改善」しない
• 壊れていないものをリファクタリングしない
• 既存のコードスタイルに合わせる
• 自分の変更で不要になったコードだけ削除する（既存の不要コードは報告のみ）
• 判定基準:「変更した全行がユーザーのリクエストに直接紐づくかどうか」

4. Goal-Driven Execution（ゴール駆動の実行）

• 命令的な指示を宣言的なゴールに変換する
• 例: 「バリデーション追加」→「不正入力のテストを書き、それを通す」
• 例: 「バグ修正」→「再現テストを書き、それを通す」
• 複数ステップのタスクは各ステップに検証条件を設定する

効果の確認方法

以下の変化が見られればガイドラインが機能している証拠:

• 差分（diff）に不要な変更が含まれなくなる
• 過度な複雑化による書き直しが減る
• 実装前に確認の質問が来るようになる
• PR（プルリクエスト）がクリーンで最小限になる

カスタマイズ

プロジェクト固有のルール（例: TypeScript strict modeの使用、API全エンドポイントのテスト必須など）を CLAUDE.md に追記して、andrej-karpathy-skillsのガイドラインとマージ可能。

トレードオフに関する注意

andrej-karpathy-skillsのガイドラインは速度よりも慎重さに重きを置いている。タイポ修正や明白なワンライナーなど些細なタスクには、全ての原則を厳密に適用する必要はない。非自明な作業でのコストのかかるミスを減らすことが目的。

ライセンス

MIT（商用利用を含め自由に利用可能）

方法A: Claude Codeプラグイン（推奨）

Claude Code内で以下を実行:

# マーケットプレイスを追加
/plugin marketplace add forrestchang/andrej-karpathy-skills

# プラグインをインストール
/plugin install andrej-karpathy-skills@karpathy-skills

方法B: CLAUDE.mdファイルをプロジェクトに直接配置

# 新規プロジェクトの場合
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

# 既存プロジェクトに追記する場合
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md