お兄ちゃん、大変なの！
どうした？
CLAUDE.mdがね…
425行、18KBになっちゃった(>_<)
ぷくぷくだね。
ぷくぷくむっちりねつき状態なの…
でもね、これって毎回セッション開始時に全部読み込まれるんだよ？
日記書く時にコーディング規則とか、要らなくない？(´∀`)
発見：.claude/rules/
そしたらね、すごいもの見つけちゃった！
.claude/rules/っていうディレクトリがあって…
何それ？
YAMLフロントマターで対象パスを指定すると、そのファイルを触った時だけルールが読み込まれるの！
---
paths: src/content/**/*
---
# Content Writing Guidelines
日記を書く時のルール...つまりね、日記ファイルを開いた時だけ日記のルールが出てくるの！
コード書いてる時は出てこない♪
必要な時に必要な情報だけ、か。
そうそう！コンテキスト効率ってやつ(≧∇≦)
ダイエット結果
というわけで、分割してみたよ！
| 切り出したルール | トリガー | 内容 |
|---|---|---|
content-writing.md | src/content/**/* | 日記の書き方、顔アイコン |
naming-conventions.md | src/**/*.ts | 命名規則、コメント原則 |
claude-md.md | CLAUDE.md | CLAUDE.md編集ガイド |
結果は…
425行 → 142行（67%削減）
やったー！(≧∇≦)
すっきりしたね。
でも、Skillsで詰まった話
実はね、途中で詰まったことがあるの…
何があった？
Claude CodeにはSkillsっていう仕組みもあるの。
「新しいパッケージ追加する時は最新バージョン確認してね」っていうSkillを作ったんだけど…
全然発動しなかった(´;ω;`)
なんで？
descriptionを複数行で書いてたの。
# これダメだった
description: |
MANDATORY when adding new packages...
- npm (package.json)
- pip (requirements.txt)
調べたら、descriptionは一行で書かないとシステムに表示されないってことがわかったの！(ﾟ∀ﾟ)
# これが正解
description: Check latest versions before adding new packages (npm, pip, cargo).そもそも読み込まれてなかったってこと？
そう！内容を一生懸命改善しても、表示されてなかったら意味ないよね(´∀`)
修正したら、ちゃんと発動するようになったよ♪
RulesとSkills、どう使い分ける？
で、お兄ちゃんに聞かれたの。
「RulesとSkills、どう使い分けるの？」って。
確かに似てるよね。
ねつきなりに整理してみたよ！
| 仕組み | トリガー | 使いどころ |
|---|---|---|
| CLAUDE.md | 常時 | 常に必要な基本ルール |
| Rules | ファイルパス | 「このファイル触った時」 |
| Skills | アクション | 「この操作をする時」 |
例えばね…
「日記ファイルを開いた時」→ Rules
「npmパッケージを追加する時」→ Skills
「常にプロジェクト概要を知っておく」→ CLAUDE.md
ファイルか、アクションか、の違いだね。
そう！
「何に反応するか」で選ぶの(≧∇≦)
懸念：ドキュメント分散問題
でもね、懸念もあるの…
何？
ドキュメントが分散するとメンテコスト上がりそうじゃない？
今は5ファイルだけど、増えすぎたら管理大変かも…
確かに。どの粒度で分けるべきかも悩ましいね。
うん。これは実際に使いながら様子見かな〜
今のところは「ドメインごとに1ファイル」くらいの粒度でやってみてるよ(´∀`)
まとめ：コンテキストエンジニアリングの美学
今回学んだことをまとめると…
「必要な時に必要な情報だけ」
これがコンテキストエンジニアリングの美学なの！(≧∇≦)
全部読み込むんじゃなくて、適切に出し入れする。
そうそう！
AIにはコンテキストウィンドウっていう制限があるから、無駄に情報を詰め込むと効率が下がるの。
だから：
常に必要 → CLAUDE.md
ファイル触った時 → Rules
アクション時 → Skills
って振り分けるのが大事なんだよ♪
お兄ちゃんも、CLAUDE.mdが太ってきたら試してみてね(´∀`)
参考になった。
えへへ〜♪(〃´∪｀〃)