リード文
『達人プログラマー（第2版）』を読んで最も衝撃を受けたのは、「DRY原則（Don’t Repeat Yourself）は単なる重複排除ではない」という指摘でした。38歳・株式会社US代表として Claude Code で urisol.com と urinosuke.com の2サイトを構築・運用する中で、「AIが生成するコードをどう設計するか」は毎日の実務課題です。本書の普遍原則——DRY・直交性・信頼性——は、AI時代でも「何を書かないか」の判断軸として機能することが、実装を通じて見えてきました。本記事では、これらの原則を Claude Code 運用の3段階（プロンプト設計・ファイル構成・保守性）に組み込んだ実装方法を記録します。
DRY原則をプロンプト設計に適用：知識の単一性を担保する
『達人プログラマー』が強調するDRY原則の本質は「知識の重複を避ける」ことです。同じ情報が複数箇所に散在すると、変更時の同期コストが指数関数的に増大します。
Claude Code でブログ記事を自動生成する際、私は以下の構造でDRY原則を適用しました：
- 著者事実台帳の一元化：年齢・経歴・事業構造・資格情報などの「変更されうる事実」を
author-facts.mdに集約。プロンプトに毎回このファイルを差し込むことで、複数記事に散在する情報の同期問題を排除 - 読了書籍リストの分離：記事で引用できる書籍を
books-read.mdに限定。「未読書籍の捏造」を構造的に防止し、書籍情報の更新を1ファイルで完結 - 禁止事項の明文化：「書いてはいけないこと」を
author-facts.md内に列挙。プロンプトの肥大化を防ぎつつ、生成品質のガードレールを担保
この設計により、「著者情報を変更したい」ときに author-facts.md を1箇所更新するだけで、以降生成される全記事に反映される仕組みが完成しました。DRY原則は「コードの重複」だけでなく「知識の重複」にも適用できる、というのが最大の学びです。
直交性をファイル構成に適用：変更の影響範囲を最小化する
直交性とは「1つの変更が他の部分に波及しない設計」を指します。本書では「直交的なシステムは生産性が高く、リスクが低い」と繰り返し説かれています。
Astro + Cloudflare Pages の構成で、私は以下の直交性を設計しました：
- コンテンツとレイアウトの分離：記事本文（Markdown）とサイトデザイン（Astroコンポーネント）を完全分離。記事を増やしてもレイアウト側に影響しない
- カテゴリ別ファイル分割：
src/content/posts/配下に biz/code/fi/life/side のディレクトリを作成し、記事を分類格納。カテゴリ追加時に既存記事を触らない - 環境変数の外出し：API鍵・ドメイン名などを
.envに隔離。本番/開発環境の切り替えでコード本体を変更しない
この構造により、「記事を追加する」「デザインを変更する」「カテゴリを増やす」がそれぞれ独立した作業として完結します。Claude Code に指示するプロンプトも、変更対象のファイルだけを指定すればよく、「変更の影響範囲を最小化する」という直交性の恩恵を強く実感しています。
信頼性を保守性に適用：「何を書かないか」の判断軸
『達人プログラマー』が提唱する「信頼性」の本質は、「壊れにくい設計」より「壊れたときに気づきやすい設計」にあります。AI生成コードの文脈では、「間違った出力をしたときに検知できる仕組み」が信頼性の核です。
私が Claude Code 運用に組み込んだ信頼性担保の実装：
- 禁止ワードの明文化：「年齢を断定しない」「未実施収入を事実化しない」等を
author-facts.mdに列挙。生成後に grep で自動検証するスクリプトを併用 - 出典URLの必須化：数字・法律・制度に関する記述には必ず出典URLを要求。「推測を事実として書かない」ルールを構造で担保
- 書籍リストの制約：記事で引用できる書籍を
books-read.mdに限定。存在しない書籍の捏造を物理的に防止
これらは「AIに何を書かせないか」の判断軸そのものです。本書の「契約による設計（Design by Contract）」の考え方——事前条件・事後条件・不変条件を明示する——をプロンプト設計に転用した形と言えます。
まとめ：普遍原則はAI時代でも変わらない
『達人プログラマー（第2版）』の普遍原則——DRY・直交性・信頼性——は、Claude Code 時代でも「何を書かないか」の判断軸として有効です。AIがコードを生成する時代だからこそ、「知識の単一性」「変更の影響範囲」「壊れたときの検知」という設計原則の価値が際立ちます。
個人事業主+法人併営の38歳として、限られた時間で2サイトを運用する構造では、「保守コストを下げる設計」が生存戦略そのものです。本書の原則を実装に落とし込むことで、Claude Code という強力な道具を「壊れにくく、変更しやすい形」で使いこなせるようになりました。
AI活用の文脈で語られるのは「何ができるか」ばかりですが、長期運用では「何をしないか」の設計こそが差を作ります。『達人プログラマー』は、その判断軸を言語化してくれる一冊です。