工具介绍
カルパシー・インスパイア・クロード・コード・ガイドライン
> 再利用可能なスキルを持つコーディングエージェントを実行および管理するためのオープンソースプラットフォームである、新しいプロジェクトMulticaをチェックしてください。
ツイート
> Xでフォローしてください: https://x.com/jiayuan jy
LLM コーディングの落とし穴の Andrej カルパシーの観察から得られる、Claude コードの動作を改善する単一の `CLAUDE.md` ファイル。
日本語 | English
問題点
Andrejの投稿から:
> 「モデルは、あなたの代りに誤った仮定を犯し、チェックせずにそれらと一緒に実行します。 それらは混乱を管理しません、明確化を求めません、矛盾を直さない、トレードオフを提示しないでください。
> 「コードと API の複雑化、抽象化、デッドコードのクリーンアップは本当に好きです。100 が行われると 1000 行上の膨らみのある構造を実装しません。」
> 「それでもコメントやコードを変更したり削除したりしても、タスクに反論しても、副作用として十分に理解できない」
ソリューション
これらの問題に直接対処する1つのファイルの4つの原則:
| 原則 | 所在地 |
お問い合わせ
|**コーディング前の考え方** | 間違った前提、隠れた混乱、欠落したトレードオフ |
|**シンプルさ第一** | 合併症・贈収賄 |
|** 外科的変更** | 正統的な編集、タッチコードを使わない |
|**ゴール駆動の実行** | 試験・検証の成功基準によるレバレッジ |
詳細の4原則
1. コーディングの前に考える
**想定しない。 混乱を隠さない。 表面のトレードオフ。**
LLMは、解釈をサイレントに受け取り、それを実行することが多い。 この原則は、明示的な推論を強制します:
- **ステータスを明示的に** — 不確実な場合は、推測ではなく
- **複数の解釈を提示** - 曖昧さが存在するときに静かに選択しないでください
- **保証された場合の戻り値** — より単純なアプローチが存在する場合、そう言う
- **混乱した時停止** — 不明な名前と明確に要求
2. シンプルさファースト
**問題を解決する最小限のコード。 スペクティブなし**
オーバーエンジニアリングに対する傾向を戦う:
- 要求されたものを超えて機能なし
- シングルユースコードの抽象化なし
- 要求されなかった「柔軟性」か「構成性」無し
- 不可能なシナリオのエラー処理なし
- 200行が50の場合、書き換え
**テスト:** シニアエンジニアはこれが重複していると言いますか? もしそうなら、単純に。
3. 外科変更
※お持ちのものだけに触れてください。 あなた自身の混乱だけをきれいにする。**
既存のコードを編集するとき:
- "improve" の隣接するコード、コメント、またはフォーマットをしない
- 壊れていないものを再ファクターしないでください
- 既存のスタイルを一致させても、異なる
- 関係のないデッドコードに気づいたら、それを言及してください - 削除しないでください
あなたの変更が孤児を作成するとき:
- あなたの変更が使用されていないことの輸入/変数/機能を削除して下さい
- 要求しない限り、既存のデッドコードを削除しないでください
**テスト:** 変更された行は、ユーザーのリクエストに直接トレースする必要があります。
4. ゴール駆動の実行
**防衛成功基準. 検証されるまでループ**
衝動的なタスクを検証可能な目標に変換:
| 代わりに... | 変換する... |
お問い合わせ
| 「検証を追加」 | 「無効な入力の書き込みテスト」 |
| 「バグの修正」 | 「それを再現するテストを書いて、それを渡す」 |
| 「Refactor X」 | 「試験合格前後」 |
マルチステップのタスクについては、簡単な計画を記述します。
強力な成功基準は、LM ループを独立させてくれます。 弱い基準(「作業する」)は一定の明確化を必要とします。
インストール
**Option A: クロード コード プラグイン (推奨)**
Claudeコード内で、最初にマーケットプレースを追加します。
次に、プラグインをインストールします。
これは、Claudeコードプラグインとしてガイドラインをインストールし、すべてのプロジェクトで利用可能なスキルを作成します。
**オプションB:CLAUDE.md(プロジェクトごとに)**
新しいプロジェクト:
既存のプロジェクト(応用):
Cursorでの使用
このリポジトリには、Cursorプロジェクトルール(`.cursor/rules/karpathy-guidelines.mdc`)が含まれているため、Cursorでプロジェクトを開くと同じガイドラインが適用されます。 他のプロジェクトでルールを使用して、セットアップのために**CURSOR.md**を参照してください。
主なインサイト
Andrej から:
> 「LLMは、特定の目標を達成するまでループで例外的に優れています... 何をすべきか、それを成功基準にし、それを見守らないでください。
「Goal-Driven Execution」の原則はこれをキャプチャします。検証ループで宣言的な目標に従属する命令を変換します。
それが働く知っている方法
これらのガイドラインは、以下を参照してください。
-**Fewer 不要な変更