AI時代のファイル管理｜GitとiCloudの二重管理をやめて一本化した理由と手順【引っ越しは丸一日】
AIエージェントに仕事を任せ始めると、遅かれ早かれ「ファイルの置き場所」の問題にぶつかります。みやっち🧑💻は2026年7月の週末、GitとiCloudの二重管理をやめて、丸一日かけてGit管理に一本化しました。この記事はその実録と、非エンジニアの方が同じ移行をする方法です。
AI前提のファイル管理とは: AIエージェントが自分でファイルを参照・更新できるように、仕事のファイルをGit・GitHub(変更履歴つきのファイル置き場)で管理する考え方。デスクトップやiCloudにファイルを置いたままでは、複数PCでの作業やAIの定期実行と両立できなくなります。
きっかけ — 「ローカルにしかないファイル」の盲点
始まりは、スマホからClaude Codeを操作していてハマった経験でした。クラウド実行のセッションからは、PCのローカルにしかないファイルが見えない——当たり前のことですが、実際にハマって初めて「Git管理されていないファイルの中に、重要なものがどれだけあるか」という観点を持っていなかったことに気づきました。
みやっち🧑💻はもともとGit管理をしていました。ただし、Gitリポジトリを含むすべてのフォルダの置き場所は、iCloud同期が効いたデスクトップ。つまりGitの上にiCloudが重なった二重管理の状態です。PC1台で完結しているうちは、これで何の問題もありません。
問題が表面化したのは、PCを複数台にし、AIの定期実行を回し始めてからです。土曜の夜にiCloudの限界を感じて体制を見直し、「最初からこの体制が見えていればこんな苦労はしなかった」と思いながら、丸一日かけて引っ越しました。
なぜAI活用とiCloud管理は両立しないのか
理由は3つあります。
- 複数PC運用はGit管理が前提になる。iCloudは変更が競合したとき「どのバージョンを残すか」を人に選ばせるだけで、変更の履歴や差分は残りません(選ばなかった側は消えます)。実際、みやっち🧑💻の環境でも複数台にしてから同期の競合が起きるようになり、iCloudの同期がGitリポジトリを壊すことさえありました。これが引っ越しの直接の引き金です。Gitは履歴と差分を仕組みとして持っているので、複数の場所から同じファイル群を安全に触れます
- AIの作業とローカルファイルの食い違いが起きる。クラウド実行のAIはGit経由でファイルを見ます。ローカルだけにあるファイルはAIから存在しないのと同じです
- AIが「勝手に参照できるナレッジ」にならない。デスクトップに散らばったファイルは、毎回人間が探して渡す必要があります。リポジトリに整理されたファイルは、AIが自分で探して読めます
引っ越し後の体制 — コピー禁止が原則
移行後の設計はこうなりました。
- 複数のプロジェクトで共用するもの(計測スクリプト・共有の設定類)は、専用のプライベートリポジトリに1か所だけ置く
- どのプロジェクトでも使うAIのスキル(手順書)は共有の置き場に置き、各プロジェクトからは参照する
- 各プロジェクトには、そのプロジェクト固有のものだけを置く
- そして原則を1行で明文化: 「別プロジェクトでも使いたくなったら、コピーせず共有側へ移してから参照する」
コピーを禁止しているのは、コピーした瞬間に「片方だけ直して、もう片方が古いまま」という分岐事故が始まるからです。情報の正本を1か所に決める考え方は、CLAUDE.mdをSSOTにする話で書いたことのファイル管理版です。
効果 — 「ナレッジをAIが勝手に参照できる」
移行の効果は、ファイル整理のレベルを超えていました。
協業・セミナー・登壇といった案件も、すべてリポジトリを作って書き起こしを入れるようにしたところ、AIがナレッジを勝手に参照できるようになり、格段に仕事がしやすくなりました。以前はNotionにも情報を溜めていましたが、いまはAIが直接読み書きできるリポジトリを情報の置き場にしています。
このブログの集客の自動化も、Discordからのネタ収集も、すべて「AIが参照できる場所に情報がある」ことが土台です。ファイル管理は地味ですが、AI活用の伸びしろを決める基盤になっています。
非エンジニアの移行手順 — AIに頼めばいい
「Gitは難しそう」と感じた方へ。安心してください。Gitの操作を覚える必要はありません。移行作業そのものをAIに任せられます。
- Claude Code・Codexに「このフォルダをGit管理にして、プライベートリポジトリを作って」と日本語で頼む
- AIがセットアップから移行までを進めるので、内容と動作を確かめながら承認していく
- 詰まったところ・気になったところだけ、その場でAIに質問して理解する
まず動く状態を作り、必要になった箇所から学ぶ——パラシュート学習法の実践例そのものです。みやっち🧑💻の引っ越しでも、移行後の体制の設計はAIとの対話で詰めていきました。
1つだけ注意点があります。移行の前に、大事なファイルのバックアップだけは取っておいてください。AIに任せる場合でも、ファイルの移動や削除を含む作業では「消えたら困るものの控え」を先に確保するのが原則です。
まとめ
AIに仕事を任せる体制づくりは、モデルの選び方やプロンプトの書き方より先に、「AIが参照できる場所に情報があるか」で決まります。デスクトップとiCloudに全部入っている状態は、人間には快適でも、AIチームにとっては「入れない倉庫」です。すでにGitを使っている方も、リポジトリがiCloud同期の下にあるなら同じ問題を抱えています。二重管理はどちらかに寄せる——AIに任せるならGit側です。
AI Crewでは、こうした基盤づくりからClaude Code・Codexでの自動化までを、プログラミング未経験の経営者・個人事業主・士業の方と一緒に進めています。まず無料セミナーでお会いしましょう。
