そんなCLAUDE.mdで大丈夫か？
CLAUDE.md、更新していますか？
CLAUDE.md、最初にinitしてからそのままにしていませんか？ 随時更新している？ それはよいです。 でも追記した情報はClaude Codeはどのように認識しているのでしょう。 追記した情報も冗長になって行数が増えていませんか？
プラグインを使う
Claude Codeの公式プラグインにはCLAUDE.mdを評価・改善してくれるプラグインがあります。
プラグインから claude-md-management をインストールします。
/plugin コマンドを実行し、リストから claude-md-management を選択してインストールします。
/pluginインストールするとコマンドとスキルが追加されます。
claude-md-management @ claude-plugins-official
Scope: user
Version: 1.0.0
Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.
Author: Anthropic
Status: Enabled
Installed components:
• Commands: revise-claude-md
• Skills: claude-md-improver下記のコマンドとスキルが使えるようになります。
/claude-md-improver
/claude-md-management:revise-claude-mdCLAUDE.mdを評価・改善する/claude-md-improver
/claude-md-improverを実行すると評価して改善案を提示してくれます。 今回は個人で作っているプロジェクトのCLAUDE.mdを評価してもらいます。
CLAUDE.md品質改善を開始します。まずプロジェクト内のCLAUDE.mdファイルを探索します。
コードベースの実態を確認しました。品質レポートを作成します。
---
## CLAUDE.md 品質レポート
### サマリー
- 発見ファイル数: 1
- 総合スコア: **68/100 (Grade: C)**
- 更新が必要なファイル: 1
### ファイル別評価
#### 1. ./CLAUDE.md (プロジェクトルート)
**スコア: 68/100 (Grade: C)**
| 基準 | スコア | 備考 |
| ---------------------- | ------ | ------------------------------------ |
| コマンド/ワークフロー | 17/20 | コマンドは充実。コピペで即実行可能 |
| アーキテクチャの明瞭さ | 12/20 | 新規モデル・ビュー・URLが未記載 |
| 非自明なパターン | 10/15 | ダウンロード履歴の無効化状態が未記載 |
| 簡潔さ | 12/15 | 概ね良好。ライブラリの説明がやや冗長 |
| 最新性 | 7/15 | **複数の重大な不整合あり** |
| 実用性 | 10/15 | 行番号参照が一部ずれている |
### 検出された問題
**重大な不整合（最新性）:**
1. **MariaDBバージョンが不正確**: CLAUDE.mdに「MariaDB 12.1」と記載あるが、実際は `mariadb:11.4`（[docker-compose.yml:24]）
2. **Dockerfileパスが古い**: 旧 `docker/Dockerfile` は削除済み。実際は `docker/django/Dockerfile`（[docker-compose.yml:7]）
3. **DOWNLOAD_DIRの行番号**: 「settings.py:118」と記載あるが、実際は125行目（[settings.py:125]）
**未記載の新機能:**
4. **`Channel`モデルが未記載**: チャンネル管理機能が追加されている（[models.py:19-33]）
5. **`DownloadQueue`モデルが未記載**: ダウンロードキュー機能が追加されている（[models.py:36-77]）
6. **新しいURLルートが未記載**: `/queue/`, `/queue/add/`, `/queue/process/` が追加済み（[urls.py:10-12]）
7. **新しいテンプレートが未記載**: `queue_add.html`, `queue_list.html` が追加済み
**動作上の注意点（非自明なパターン）:**
8. **`download`ビューの履歴保存がコメントアウトされている**: 直接ダウンロードでは履歴が記録されない状態（[views.py:38-44]）。キュー経由のダウンロード（`queue_process`）では履歴が保存される
これらの問題を修正する更新を適用してよろしいですか？主な変更内容：
1. MariaDBバージョンとDockerfileパスの修正
2. Channel・DownloadQueueモデルの記載追加
3. 新しいURLルートの追加
4. 行番号参照の修正
5. ダウンロード履歴の無効化状態についての注記追加
6. ライブラリの冗長な説明の簡潔化評価はC 指摘がかなりありました。 特に最新性への指摘が多く更新をサボっていたことが露呈しました。 内容の更新を適用してもらいます。
更新が完了しました。適用した変更のサマリー：
| 変更箇所 | 内容 |
| ------------------- | --------------------------------------------------------------------- |
| 使用ライブラリ | 冗長な説明を1行に簡潔化 |
| MariaDBバージョン | 12.1 → **11.4** に修正 |
| ダウンロードフロー | 直接ダウンロードとキュー経由の2方式を記載。履歴保存の無効化状態を注記 |
| 行番号参照 | DOWNLOAD_DIR: 118→**125**、opts: 24-30→**25-30** |
| URLルーティング | `/queue/`, `/queue/add/`, `/queue/process/` を追加 |
| データベースモデル | **Channel**と**DownloadQueue**モデルの記載を追加 |
| アプリケーションURL | キュー関連のURL 2件を追加 |
| ファイルの場所 | `docker/django/Dockerfile` を追加 |
更新後の推定スコア: **68 → 88/100 (Grade: B)** に改善されました。スコアが改善しました。 評価もBに上がりました。
現在のセッション内容をCLAUDE.mdに反映する/claude-md-management:revise-claude-md
/claude-md-management:revise-claude-mdを実行すると現在のセッション内容からCLAUDE.mdに反映する必要がある情報を抽出して更新を提案してくれます。
このセッションを振り返り、CLAUDE.mdに追加すべき学びを整理します。
## Step 1: 振り返り
このセッションで判明した点：
- CLAUDE.mdの情報がコードベースの実態と乖離していた（バージョン、パス、行番号、新機能の未記載）
- 先ほどの更新で大部分は修正済み
- 残っている軽微な不整合がないか確認する
## Step 2: CLAUDE.mdファイルの確認
Read [CLAUDE.md]
## Step 3 & 4: 追加提案
先ほどの監査で大部分は修正済みです。残っている改善点は以下の2件です：
---
### Update 1: ./CLAUDE.md (131行目)
**Why:** 動作セクションの行番号参照が先ほどの更新で修正漏れ（24-30 → 25-30）
```diff
- オプションは[views.py:24-30](app/downloader/views.py#L24-L30)の`opts`辞書で設定されています。よく変更されるオプション：
+ オプションは[views.py:25-30](app/downloader/views.py#L25-L30)の`opts`辞書で設定されています。よく変更されるオプション：
```
### Update 2: ./CLAUDE.md (重要な制約セクション)
**Why:** `download`での履歴保存コメントアウトはダウンロードフローに記載済みだが、制約セクションにも明記すると将来のセッションで混乱を防げる
```diff
- **同期ダウンロード**: ダウンロードは完了するまでリクエストをブロック（バックグラウンドタスクなし）
+ - **直接ダウンロードの履歴未記録**: `download`ビューの`DownloadHistory`保存はコメントアウト中。キュー経由のみ記録される
```
---
これら2件の変更を適用してよろしいですか？今回はプログラムの修正などは行っていないので細かい点のみの指摘になります。 こちらも内容の更新を適用してもらいます。
2件とも適用しました。
- 行番号参照を `views.py:24-30` → `25-30` に修正
- 重要な制約セクションに直接ダウンロードの履歴未記録の注記を追加まとめ
公式プラグインでCLAUDE.mdを定期的にチェックして更新することで、Claude Codeが常に最新のコードベースの情報を参照できるようにしましょう。
