CLAUDE.mdのたった1行で「過剰設計」癖を折る
Dev.to / 2026/6/2
💬 オピニオンSignals & Early TrendsIdeas & Deep AnalysisTools & Practical Usage
要点
- この記事は、ユーザーの「言い直し（recadrage）」にもかかわらずClaudeが毎回過剰に設計（Strategy pattern、registry、複数の統合テストなど）してしまう経緯を説明しています。
- それを抑えるため、著者はCLAUDE.mdのConventionsに「適合する最小の変更にデフォルトし、抽象化は2回目以降にのみ追加する」という規約を追記しました。
- 著者は、文言の選び方が重要である理由も掘り下げており、「Avoid」ではなく「Default to」を使うことで、モデルが逆効果な抽象化の反射を起こさないようにしています。
- 「3回目ではなく2回目」は、Claude Codeでのソロ開発という前提に合わせた調整で、2回目が抽象化導入を見直せる最後のタイミングだと述べています。
- 最初の判断では内部の交渉を封じるために「Never the first（最初は決してしない）」のようにあえて厳しめに書き、例外が来たときには反対を論じる必要がある点を示しています。
この記事の続きは原文サイトでお読みいただけます。
原文を読む →
