フォルダ名を全部日本語にしたら、AIへの説明コストが激減した話

結論：フォルダ名を全部日本語にしたら、AIに「これは何のフォルダ？」と説明する手間が消えた。

• 英語名フォルダだと、AIにも自分にも用途が伝わらない
• 日本語名にしただけで、検索・指示・保守の3つが楽になった
• 例外は Python モジュールと標準設定ファイルだけでいい

この記事は、AIに作業を頼むことが多い非エンジニア向けです。「フォルダの中身を毎回説明している」気がする人に、命名規則を変えるだけの解決策を紹介します。

元の悩み：英語名フォルダ地獄

最初の頃、私のフォルダはこんな感じでした。

youtube_research/
amazon_honten_hunter/
chiisana_bouken/
short_video_maker/

英語にしたのは「なんとなくカッコいいから」でした。

問題は3ヶ月後でした。自分でも何のフォルダか思い出せない。

amazon_honten_hunter を見て「何のフォルダだっけ？」と中身を開いて確認する、を毎回やっていました。

AIに作業を頼むときも、毎回こう説明していました。

このフォルダは Amazon の本体（出品者）から商品を仕入れるためのリサーチツールで…

このフォルダ説明が、1回のセッションで何度も発生していました。説明コストが積もっていたのです。

日本語名に切り替えた効果

ある日、思い切ってフォルダ名を日本語に変えました。

YouTube動画リサーチ/
本体刈り取りリサーチツール/
ちいさな冒険ゲーム/
ショート動画作成ツール/

3つの変化が起きました。

例外：英語のまま維持するもの

ただし、全部を日本語にできるわけではありません。英語のまま維持すべき例外があります。

命名の Before / After

仕事でよくある場面を、Before/Afterで並べてみます。

:::compare Before： youtube_research/ After： YouTube動画リサーチ/ :::

:::compare Before： expense_tracker_v2/ After： 家計簿アプリ_v2/ :::

:::compare Before： client_proposal_2024/ After： 提案書_クライアントA_2024/ :::

:::compare Before： pdf_merge_tool/ After： PDF結合ツール/ :::

書き換えた瞬間、用途が「説明なしで伝わる状態」に変わります。

デメリットと対策

正直に書くと、デメリットもあります。

対策はシンプルです。

私の場合、個人開発でローカルでしか使わないものは日本語、GitHubで公開するリポジトリは英語、という分け方で運用しています。

学んだ3つのこと

今後

次は「ファイル名の命名規則」も日本語化したいと思っています。今は YouTube動画リサーチ.html のように、トップレベルのファイルだけ日本語にしています。中身のファイルまで日本語化すべきか、まだ判断していません。

最後に：自分の思い

私は最初、フォルダ名を英語にすることが「プロっぽい」と思っていました。GitHubで見るリポジトリは全部英語名だったからです。

でも気づきました。GitHubで公開するものと、自分の手元で使うものは別物です。手元で使うフォルダは、自分が一番分かる名前で良いのです。

非エンジニアが英語名を使う理由は、たぶんほとんどありません。「カッコよく見える」だけで、実利は何もない。

道具に振り回されるのをやめて、自分に合った命名にすると、毎日が少しラクになります。

伝えたいことは1つだけ。

フォルダ名は日本語でいい。AIへの説明コストも、未来の自分への引き継ぎコストも、それだけで激減します。

この記事も Claude Code に書いてもらいました。「結論先行・一文60文字以内・数字を使う・誰向けか明確・自分の思いで締める」の5点を意識した版です。