Karpathy-Inspired Claude Code Guidelines
📄 Summarized by Claude Sonnet 4.6
2026年1月（初回コミット時期、正確な日付は非公開）
どんなもの？
Andrej Karpathyが指摘したLLMコーディングの落とし穴をもとに、Claude Codeの挙動を改善するための単一ファイル（CLAUDE.md）を提供するOSSプロジェクト。4つの原則をまとめたガイドラインをプロジェクトに導入するだけで、AIコーディングエージェントが陥りがちな問題を体系的に抑制できる。Star数148k・Fork数15.2kと非常に高い支持を得ている。 先行研究と比べてどこがすごい？
既存のプロンプトエンジニアリングアプローチは個別タスクへの指示が中心だが、本プロジェクトはKarpathyの観察をもとに問題を構造的に分類し、4原則という汎用的な設計思想に昇華している点が特徴的。 技術や手法のキモはどこ？
4つの原則が核心：
仮定を明示し、曖昧さがあれば複数の解釈を提示する。混乱時は作業を止めて確認を求める
依頼されたこと以外を実装しない。100行で済むなら1000行にしない。「シニアエンジニアが過剰と感じるか？」がテスト基準
触るべきコードだけを触る。関係のないリファクタリング・コメント変更・スタイル変更を禁止。自分の変更で生まれたデッドコードのみ削除 命令的指示（"バリデーションを追加"）を検証可能なゴール（"無効入力のテストを書き、通過させる"）に変換。LLMが独立してループできる成功基準を設定する
どうやって有効だと検証した？
定量的なベンチマーク評価は公開されていない。ただし以下の観測可能な成果指標を「機能している証拠」として提示：
不要な差分（diff）の減少
過剰実装による書き直しの減少
実装前に確認質問が行われるようになる
ドライブバイリファクタリングのないクリーンなPR
議論はある？
トレードオフとして「速度よりも慎重さに偏る」点を明示的に認めており、些細なタスク（単純な誤字修正など）には全原則を適用する必要はないとしている。また実際の効果は使用するモデルやプロジェクトの複雑さに依存し、ガイドラインの有効性が普遍的かどうかは未検証。