ディレクトリ構造とは、ファイルやフォルダを階層的に整理した体系のことです。
AIはパス（ファイルの住所）でファイルを認識するため、構造が整っているかどうかが、AI業務の精度と効率に直接影響します。
このリポジトリも articles/ / operations/ / research/ というフォルダ構造で動いています。
Claude Codeに「articlesフォルダを読んで」と短く伝えるだけで動けるのは、ファイルの置き場所が決まっているからです。フォルダ設計の考え方を、実務の視点でノートに残します。
フォルダ / パス / 階層——まず3つの概念を整理する
フォルダとディレクトリは同じ意味で使っていい
「ディレクトリ」というと難しそうに聞こえますが、MacのFinderやWindowsのエクスプローラーで見えている「フォルダ」と基本的に同じものです。エンジニアの文脈では「ディレクトリ」、一般的な文脈では「フォルダ」という言葉が使われる傾向がありますが、意味はほぼ同じと理解しておいて問題ありません。
パスとはファイルの「住所」のこと
ファイルの場所を表す文字列を「パス」といいます。
たとえば articles/markdown-basics.md と書かれていれば、「articlesフォルダの中にある markdown-basics.md というファイル」を指しています。
スラッシュ（/）がフォルダの区切りで、左から右へ読むほど場所が詳しくなります。
階層が深くなるほど「場所が詳しくなる」
フォルダの中にフォルダがあり、その中にファイルがある——この入れ子構造が「階層」です。
最上位を「ルート（root）」と呼び、そこから枝分かれして深くなっていきます。
ディレクトリ構造は、ファイルに「住所を持たせる仕組み」です。
住所がなければ、どこに何があるかわからなくなります。
AI業務ではディレクトリ構造が重要になる
AIツールを使う場面が増えるほど、ディレクトリ構造の重要性が上がります。
AIはパスでファイルを認識する
Claude CodeのようなAIツールは、ファイルを開いたり参照したりするとき、パスを使います。
「articles/markdown-basics.md を読んで」という指示が伝わるのは、そのパスにファイルが実際に存在するからです。
逆にいうと、ファイルの名前がわかっても場所がわからなければ、AIは正しくアクセスできません。
「どこにあるか」がわかることで、初めて「中身を使える」状態になります。
構造が整っていないと、AIが迷う
たとえば、記事のドラフトが
デスクトップ、「記事」フォルダ、「temp」フォルダ
に散在していたとします。
この状態でAIに「先月書いた記事を参照して」と伝えても、AIはどこを探せばいいかわかりません。
構造が乱れているのは、住所がない街のような状態です。人間が迷うように、AIも迷います。
AIに「どこを見ればいいか」が伝わる状態にしておくこと。これがディレクトリ構造を整えるいちばんの理由です。
置き場所の設計が、AI業務の精度を決める
構造が整っていると、AIへの指示に「どこを見ればいいか」が自動で含まれます。
情報をどう書くかだけでなく、どこに置くかまで設計することが、AI業務の精度に直結します。
実務に使えるフォルダ設計の3つの考え方
どんなディレクトリ構造が良いかは、プロジェクトによって異なります。
ただし、非エンジニアがAI業務を始めるにあたって押さえておきたい考え方が3つあります。
役割でフォルダを分ける
「何を入れるフォルダか」が明確になるよう、役割単位で分けます。
記事原稿 / 運用ルール / 画像素材 / リサーチメモ は、それぞれ別のフォルダに分ける方が探しやすくなります。
このリポジトリで実際に使っているフォルダも、
articles/（記事）、operations/（運用管理）、images/（画像）、research/（リサーチ）
というように役割で分かれています。
名前にルールを持たせる
フォルダ名やファイル名に統一したルールを持たせると、パスが読みやすくなります。
・小文字のみ使う
・スペースの代わりにハイフン（-）またはアンダースコア（_）を使う
・日本語は使わない
日本語のフォルダ名やファイル名は一部のツールで文字化けする場合があるため、避けておく方が安全です。
深くしすぎない
階層は深くすれば詳細に整理できますが、深くなるほどパスが長くなり、どこに何があるかわかりにくくなります。
大切なのは数字の目安ではなく、探しやすいかどうかです。
「このフォルダを開けばある」という確信が持てるくらいの整理が目安で、それ以上細かくしても管理コストが増えるだけになります。
階層を深くしすぎると、AIへの指示でパスが長くなり、どこに何があるか自分でも把握しにくくなります。整理のためのフォルダが、逆に迷子を生む原因になりがちです。
ディレクトリ構造を整えると何が変わるか
AIへの指示が短くなる
構造が整っていると、「先月のリサーチメモを読んで」「imagesフォルダの画像を確認して」という短い指示で動けます。ファイルが散在していると、毎回「あのファイルはどこにあって……」という説明が必要になります。
指示がシンプルになることは、プロンプトが短くなることでもあります。
トークンの節約にもつながるため、AI業務の効率に直接影響します。
将来の自分やチームも迷わない
AIへの効果だけでなく、自分自身のナビゲーションにもなります。
数週間後・数ヶ月後の自分や、将来チームで共有する場合を想定すると、構造を整えておくことの価値は大きくなります。「このフォルダを開ければある」という状態は、AI業務でも人間の業務でも、生産性の前提条件です。
Markdownとディレクトリ構造はセットで機能する
Markdownは「何を書くか」、ディレクトリは「どこに置くか」
前回の記事で解説したMarkdownは、情報を構造化して「書く」ための形式です。
ディレクトリ構造は、そのファイルを「どこに置くか」を決める仕組みです。
・Markdownで書く → ファイルの内容が整理される
・ディレクトリで置き場所を決める → ファイルの場所が整理される
この2つはセットで機能します。どちらが欠けても、AIが必要な情報を正確に扱うことはできません。
→ Markdownとは？AI時代に全員が使うべき理由を実務視点で解説
次は「変更の管理」へ
ファイルをMarkdownで書き、ディレクトリで整理できるようになると、次に必要になるのが「変更の記録」です。
昨日と今日でファイルがどう変わったか、どのバージョンが最新か——これを管理するのが「Git」の役割です。
次回は、非エンジニアがAI時代に知っておくべきGitの考え方をノートに残します。
＼ ブログ更新が止まっている・記事運用を任せたい方へ ／
企画から執筆・公開まで、まるごとお任せください。お気軽にご相談を。
