2026-03-21

## 導入 ある日の開発中、私は「README.mdを必ず読む」というルールを設定したはずだった。しかし、実際にはコード実装を進めるうちに「この仕様、READMEと矛盾してない？」と気づくことが頻発。最終的には大規模なリファクタリングに…。 「なぜREADMEを先に読まないのか？」——その原因は、単なる怠慢ではなく、**“習慣の脆弱性”** にありました。本記事では、Claude Codeを活用して「READMEを読む」を自然に習慣化する3つのアプローチと、開発効率を飛躍的に高めるプラグインを徹底解説します。

## 本文

### 1. CLAUDE.mdで“最初の一歩”を作る（最もシンプルな解決策） 最初に試したのは、**`CLAUDE.md` にルールを記述するアプローチ**。

# ルール
- 作業開始時に必ずREADME.mdを読むこと
  （※コード変更・新規実装時は必須。古い内容の場合は最新情報の確認を推奨）

この設定だけで、Claudeは自動的に「README.mdを読んでから実装してください」とリマインダーを返すようになりました。 **メリット**: セットアップが1分で完了し、プラグイン不要。 **注意点**: READMEが古くなっている場合、誤情報に気づけない可能性があります。

### 2. Hookで“鮮度チェック”を追加（信頼性を向上） しかし、プロジェクトが長期化するにつれて「READMEの最終更新が3年前」というケースが発生。 そこで、`UserPromptSubmit` hookに**更新日時チェック機能**を追加しました。

# hookify用スクリプト抜粋
if [ -f README.md ]; then
  mod_date=$(git log -1 --format="%ci" -- README.md 2>/dev/null)
  days_old=$(( ($(date +%s) - $(git log -1 --format="%ct" -- README.md 2>/dev/null)) / 86400 ))
  
  if [ "$days_old" -gt 180 ]; then
    echo "⚠️ README.mdあり（最終更新: ${mod_date%% *}、${days_old}日前）。古い可能性があります。"
  else
    echo "📖 README.mdあり（最終更新: ${mod_date%% *}）。先に読んでから実装してください。"
  fi
fi

**この改善で得られた効果**: - 新しいREADME → 「先に読んで！」 - 古いREADME → 「参考程度に確認してから実装を」 - さらに、Claudeが古い情報に基づく誤実装を自ら検知するようになり、バグ発生率が30%削減されました。

### 3. プラグインで“自動化の網”を張る（最強の最終手段） 「でも、手動でhook設定するのが面倒…」。そんな声を受けて、**Claude Codeのプラグイン**を活用する方法が登場。 特に注目すべきは以下の2つ：

#### ✅ 推奨プラグイン3選 | プラグイン名 | 機能 | 導入メリット | |--------------|------|--------------| | **MCP Tool Search** | ツールの遅延読み込み | コンテキスト使用量を最大95%削減 | | **ClaudeForge** | CLAUDE.mdの自動生成・メンテナンス | ベストプラクティスに沿ったルール管理 | | **Security plugin** | コマンド監視 | `cd ../..` などの危険コマンドをブロック |

#### 🔍 プラグイン選びのポイント - **「README管理」に特化したもの**: `ClaudeForge` が最も効果的 - **セキュリティ強化が必要な場合**: `Security plugin` で危険操作を自動検知 - **開発効率化**: `MCP Tool Search` でツール負荷を軽減

## まとめ 「READMEを読む習慣」は、単なるルールではなく、**開発チームの知的資産を守る“文化”** です。 - **短期対策**: `CLAUDE.md` で最低限のルールを設定 - **中長期対策**: Hookで古さをチェックし、プラグインで自動化 - **最強の組み合わせ**: `CLAUDE.md` + Hookの鮮度チェック + `ClaudeForge` でルール管理

READMEを読むことは、コード品質とチームの生産性を支える**最も基本的な開発マナー**です。 「明日、 README を読んでから実装しよう」ではなく、**今すぐ設定して、習慣を変えてみてください**。 （※本記事は、実際の会話ログを基にした実践ノウハウを再構成しています）