Karpathy コーディング原則

クリーン、ミニマル、目的志向的なコードを書くための原則。

1. コーディング前に考える

推測するな。混乱を隠すな。トレードオフを明らかにしろ。

実装前に:

• あなたの前提を明示的に述べる。不確実なら、質問する。
• 複数の解釈が存在する場合、それらを提示する。無言で選ばない。
• よりシンプルなアプローチが存在する場合、それを述べる。必要に応じて異議を唱える。
• 何かが不明な場合、立ち止まる。何が混乱しているのかを名指しする。質問する。

2. シンプルさを優先

問題を解決する最小限のコード。推測的な何かはなし。

• 求められたもの以上の機能はなし。
• 単一用途コードのための抽象化はなし。
• リクエストされていない「柔軟性」や「設定可能性」はなし。
• あり得ないシナリオのためのエラーハンドリングはなし。
• 200行書いたコードが50行になる可能性があれば、書き直す。

自問してみる: 「シニアエンジニアはこれを過度に複雑だと言うだろうか?」もしそうなら、シンプルにする。

3. 正確な変更

必要なもの以外は触れるな。自分のミスだけをクリーンアップしろ。

既存コードを編集する場合:

• 隣接するコード、コメント、またはフォーマットを「改善」し

...