Claude CodeやCodexなど、パソコン上のファイルを直接読み書きできる「生成AIエージェント」を使う機会が増えてきました。
私も最近は、プログラム開発だけではなく、ブログ記事の作成、投資データの分析、ランニング記録の整理など、かなり多くの作業を生成AIエージェント経由で行っています。
そこで最近、かなり重要だと感じていることがあります。
それが、
プロジェクトフォルダの構造を、最初に決めておくこと
です。
地味な話に見えますが、これが意外と大事です。
生成AIエージェントを使い始めたばかりの頃は、とりあえず適当なフォルダを作って始めてしまいます。
私もそうでした。
しかし、プロジェクトが増えてくると、
「このファイル、どこに置いたっけ？」
「Claude Code用のフォルダだっけ？ Codex用だっけ？」
「Obsidianのデータはどこだっけ？」
と、だんだん訳がわからなくなってきます。
しかも一度プロジェクトが動き始めると、後からフォルダを移動するのは結構面倒です。
なので、これから生成AIエージェントを使い始める人には、最初にプロジェクトフォルダの構造を決めておくことをおすすめします。
しかも、私自身も現段階でフォルダの位置を失敗していて。新しい場所にAI専用のプロジェクトフォルダを作って、今後はそちらで作業していこうと考えています。その辺の話もできればと考えています。
私は「AI-Projects」フォルダを作った
現在、私はMacのDocumentsフォルダの下に、
└── AI-Projects/
├── blog-to-movie/
├── freee/
├── iwashi-design/
├── kaereaba-series/
├── wakattablog-renewal/
├── kankichi-note/
└── Obsidian/
└── second-brain/
という構造を作っています。
※これ、いまは少し後悔しています。Documentフォルダの下ではなく、ホームディレクトリの下にAI専用のフォルダとして設置して、サイドバーに表示させるのがベストかなと思ってます。
AI-Projects/ というフォルダを作って、その中に生成AIを使って作業するプロジェクトをまとめています。
たとえば、
- blog-to-movie/：ブログ記事を台本に動画を作るプロジェクト
- freee/：会計アプリ「freee」の操作
- iwashi-design/：「群れ工房」の開発
- kaereaba-series/：カエレバシリーズの開発
- wakattablog-renewal/：わかったブログデザインのリニューアル
- kankichi-note/：わかったnoteのコンテンツ作成
- Obsidian/second-brain/：自分の知識やメモの保管庫
といった感じです。
AIツールごとにフォルダを作らない
ここで大事なのは、
Codex/
ChatGPT/
のように、AIツールごとにフォルダを分けないことです。
最初は、ついやってしまいがちです。
私も以前は、
├── Claude Code/
├── CODEX/
└── その他いろいろ/
のように、使うツールを基準にフォルダを作っていました。
でも、この構造だと困ることがあります。
たとえば「カエレバシリーズ」という一つのプロジェクトを、今日はClaude Codeで作業し、明日はCodexでチェックしたい場合です。
ツールごとにフォルダが分かれていると、
「どちらが最新版なのか？」
という問題が発生します。
ファイルをコピーし始めると、さらにややこしくなります。
なので、
ツールではなく、プロジェクトを基準にする。
これが大事です。
└── kaereaba-series/
という一つのプロジェクトがあり、そこをClaude Codeから開いてもいいし、Codexから開いてもいい。
生成AIは「道具」です。
主役はプロジェクトです。
この考え方にしておくと、かなり整理しやすくなります。
Claude CodeでもCodexでも、同じフォルダを使う
たとえば、
└── AI-Projects/
└── blog-to-movie/
というフォルダがあれば、Claude Codeを使うときは、
cd ~/Documents/AI-Projects/blog-to-movie
と移動して作業します。
Codexを使うときも、同じフォルダを開けばよいです。
そうすれば、
プログラム
データ
AGENTS.md、CLAUDE.md(AIへの基本指示書)
などを、すべて一か所にまとめられます。生成AIを変えても、プロジェクトそのものは変わりません。
AGENTS.mdは、Codexへの指示書、CLAUDE.mdはClaudeCodeへの指示書なのですが、最近はCodexはAGENTS.mdがない場合は、ClaudeCode用のCLAUDE.mdを読みに行く設定になっています。
これは、今後AIツールが増えていくことを考えても重要だと思っています。
現在はClaude CodeやCodexを使っていますが、数年後には別のAIエージェントを使っているかもしれません。
そのたびにファイルを移動する必要はありません。
ObsidianもAI-Projectsの中に入れている
私はObsidianでアイデアを整理しているのですが、Obsidianの保管庫も、
└── Obsidian/
└── second-brain/
に入れています。
ここは、人によって考え方が分かれるところだと思います。
Obsidianは独立した知識管理ツールなので、
├── AI-Projects/
└── Obsidian/
と分ける方法もあります。
それも十分ありです。
ただ、私は今後、
自分が持っているデータを生成AIに横断的に分析させたい
と考えています。
たとえば、
- 過去のブログ記事
- 投資記録
- ランニング記録
- 開発中のサービス
- Obsidianに保存したメモ
などをまとめてAIに読ませて、
「最近、自分が考えているテーマを整理して」
「過去20年で考え方がどう変化したか分析して」
といった使い方をしたい。
その場合、
の下にすべてまとまっている方が扱いやすいのです。
普段はプロジェクト単位でAIを起動する
ただし、いつもAI-Projects全体をClaude Codeなどで開いているわけではありません。
通常は、
のように、作業するプロジェクトだけを開きます。
これが重要です。
生成AIエージェントは、指定されたフォルダ内のファイルを読み書きできます。
つまり、範囲を広くしすぎると、関係のないファイルまで対象になってしまいます。
なので、
普段は小さく開く。必要なときだけ広く開く。
という運用にしています。
たとえば、
↑
全体を横断分析するとき
↑
カエレバシリーズを開発するとき
コメント