Upgrade to Pro — share decks privately, control downloads, hide ads and more …

スピンアウト講座02_ファイル管理

 スピンアウト講座02_ファイル管理

Claude Codeが情報を探す順序(CLAUDE.md → SKILL.md →ファイル検索)を理解し、AIが見つけやすいフォルダ構造を設計します。番号プレフィックス方式やPARAメソッドなど3つの設計方法論を比較。

OffersにはAI Talent(トップクラスAI人材)が多数登録しています。その方たちとチームを組み、AIコンサルティングサービスを開始しています。ご関心のある方はこちらからご登録ください。順次、弊社よりご連絡させていただきます。
https://share-na2.hsforms.com/13F_F95BrTLaqRMk1hYhxQg3rs27

Avatar for overflow ,Inc

overflow ,Inc

March 21, 2026
Tweet

More Decks by overflow ,Inc

Other Decks in Technology

Transcript

  1. なぜディレクトリ管理が重要なのか CONFIDENTIAL © Offers All rights reserved. 1 AI活用の品質は「ディレクトリ構造」で決まる BEFORE

    情報が散在している状態 ✕ どのファイルを参照すべきか不明 ✕ 毎回手動で「このファイルを見て」と指示が 必要 ✕ 回答の品質がバラバラで安定しない AFTER 情報が整理されている状態 ✓ 関連ファイルを自動で発見・参照 ✓ 指示は最低限で済む ✓ 常に高品質な回答が得られる
  2. なぜディレクトリ管理が重要なのか CONFIDENTIAL © Offers All rights reserved. 2 ディレクトリ管理が必要な3つの理由 01

    ナレッジの蓄積 整理されていれば情報が増えるほ ど賢くなる。散在していれば増え るほど混乱する。 02 情報探索性の向上 Claude Codeはフォルダ名・ファ イル名を手がかりに検索。構造が 良ければ自動で必要な情報を発 見。 03 チームでの共有 誰が見ても「どこに何があるか」 がわかる構造は、引き継ぎコスト を最小化する。
  3. なぜディレクトリ管理が重要なのか CONFIDENTIAL © Offers All rights reserved. 3 Claude Codeの情報探索ステップ

    1 ▶ CLAUDE.md プロジェクトのルール と 構造を把握 2 ▶ SKILL.md スキル実行時に必要な 情報源を把握 3 ▶ Glob / Grep ファイル名・フォルダ 名を 手がかりに検索 4 ファイル読込 見つけたファイルの 中身を読んで回答
  4. なぜディレクトリ管理が重要なのか CONFIDENTIAL © Offers All rights reserved. 4 ファイルが見つかりやすい5つの条件 条件

    悪い例 良い例 フォルダ名が意味を持つ folder1/ 20.strategy/ ファイル名に日付がある メモ.md 2026-03-18_商談メモ.md 階層が深すぎない 5階層以上のネスト 2〜3階層が理想 命名規則が統一されている 英語・日本語が混在 統一したルールを適用 CLAUDE.mdに構造説明がある フォルダ説明なし Vault構造セクションを記載 Tip: CLAUDE.md に Vault構造テーブルを書くだけで、Claude Codeの情報到達率が大幅に向上します
  5. ディレクトリ設計の3つの方法論 CONFIDENTIAL © Offers All rights reserved. 5 方法1: PARAメソッド

    P Projects 締切あり・完了する 例: A社への提案書作成 採用面接の準備 A Areas 継続的に管理する 例: 営業活動 チームマネジメント R Resources 参考情報・ナレッジ 例: AI活用ノウハウ 業界レポート A Archive 終了・非アクティブ 例: 完了したプロジェクト 古い資料 メリット: シンプルで迷いにくい | デメリット: ビジネス用途では粒度が粗い
  6. ディレクトリ設計の3つの方法論 CONFIDENTIAL © Offers All rights reserved. 6 方法2: 番号プレフィックス方式(推奨)

    番号で用途を一目で把握 00.Inbox/ 未整理のメモ 10.metadata/ 個人情報、チーム情報 20.strategy/ 戦略・KPI・タスク 30.product/ プロダクト定義 40.bizdev/ 営業・マーケティング 50.hiring/ 採用関連 60.contents/ コンテンツ制作 99.archive/ アーカイブ メリット ✓ 表示順序が固定(アルファベット順で崩れな い) ✓ 番号を見るだけで「どの領域か」がわかる ✓ Claude Codeが構造を理解しやすい ✓ 空き番号(70〜98)があるので拡張しやすい
  7. ディレクトリ設計の3つの方法論 CONFIDENTIAL © Offers All rights reserved. 7 方法3: 機能軸

    × 時間軸のハイブリッド 上位は「機能」で分け 下位は「時間」で分ける データが時系列で蓄積され、AIが「先月のKPI」「今 月のKPI」を自然に比較できる。日次・月次のデータ 管理に最適。 メリット: AIが時系列比較しやすい デメリット: 構造がやや深くなりがち 20.strategy/ 20_02.KPI/ 20_02_01.Day/ 商談/ 2026-03/ 2026-03-18_商談.md
  8. Claude Codeのためのディレクトリ設計 CONFIDENTIAL © Offers All rights reserved. 8 .claude/

    ディレクトリの構造 設定ファイル CLAUDE.md メインの指示ファイル settings.json 共有設定(チーム用) settings.local.json 個人設定 ルール & スキル rules/*.md 自動読込ルール skills/*/SKILL.md Agent Skills定義 commands/ カスタムコマンド 運用ファイル scripts/ シェルスクリプト logs/ 実行ログ teams/ チーム設定
  9. Claude Codeのためのディレクトリ設計 CONFIDENTIAL © Offers All rights reserved. 9 ファイル自動読み込みの仕組み

    ステータス ファイル 読み込みタイミング 説明 常時 ✅ CLAUDE.md 起動時に自動 プロジェクトのルール・構造定義 常時 ✅ .claude/rules/*.md 起動時に自動 追加ルール(CLAUDE.mdの分割先) 都度 ⚡ .claude/skills/*/SKILL.md スキル呼出時 スキル固有の手順・参照先 手動 ❌ その他のファイル 指示がないと読まない 明示的にパスを指定する必要あり 重要: rules/ フォルダに入れたMarkdownは自動で読み込まれます。CLAUDE.mdが長くなったらrules/に分割しましょ う。
  10. Claude Codeのためのディレクトリ設計 CONFIDENTIAL © Offers All rights reserved. 10 CLAUDE.mdにVault構造を書く効果

    これだけで変わる CLAUDE.mdにVault構造セクションを書くだけで、 Claude Codeは「KPIの情報は20.strategy/を探せばい い」と自動判断できるようになります。 テンプレート例 フォルダ 用途 10.metadata/ プロフィール、日報 20.strategy/ 事業戦略、KPI、タスク管理 30.product/ プロダクト定義 40.bizdev/ 営業資料、マーケティング ファイル命名規則 種類 パターン 例 日次データ YYYY-MM-DD_<種類>.md 2026-03-18_商談.md 月次データ YYYY-MM_<種類>.md 2026-03_KPI.md マスタ <種類>_master.md 商談_master.md
  11. 実践:ゼロからVault構造を作る CONFIDENTIAL © Offers All rights reserved. 11 4ステップでVault構造を設計する 1

    ▶ 業務の棚卸し 自分の業務を全て 書き出す 2 ▶ フォルダ割当 業務をフォルダに 分類する 3 ▶ 下位フォルダ設計 時間軸で下位構造 を設計 4 Claude Codeで生成 構造を伝えて 自動作成
  12. 実践:ゼロからVault構造を作る CONFIDENTIAL © Offers All rights reserved. 12 避けるべき4つのアンチパターン NG

    1 階層が深すぎる strategy/KPI/Day/ ✕ 商談/2026-03/18/details/ strategy/KPI/Day/ ✓ 商談/2026-03-18_商談.md 3階層以内に抑える NG 2 日付がないファイル名 メモ ✕ .md → メモ2.md → メモ_最新_v2.md 2026-03-18_ ✓ 商談メモ.md 必ずYYYY-MM-DD_を先頭に NG 3 1フォルダにファイル過多 docs/ ✕ の中にreport1〜report150.md docs/2026-01/ , docs/2026-02/ ... ✓ 月別フォルダで分割 NG 4 用途が曖昧なフォルダ名 stuff/ misc/ temp/ other/ ✕ 98.instant/ 99.archive/ ✓ 番号+用途を明示
  13. 実践:ゼロからVault構造を作る CONFIDENTIAL © Offers All rights reserved. 13 月1回のVault健康チェック #

    チェック項目 確認内容 対応アクション 1 空フォルダ 空のフォルダはないか 削除 or 活用開始 2 ファイル過多 50件以上のフォルダはないか 月別フォルダに分割 3 命名規則違反 ルール外のファイルはないか YYYY-MM-DD_ にリネーム 4 長期未更新 3ヶ月以上更新なしのファイル 99.archive/ へ移動 5 構造ズレ CLAUDE.mdと実態の差異 CLAUDE.md を更新 Claude Codeプロンプト例: 「Vaultのフォルダ構造を分析して、上記5項目をレポートしてください」
  14. 実践:ゼロからVault構造を作る CONFIDENTIAL © Offers All rights reserved. 14 実践課題 01

    業務棚卸し & 設計 自分の業務を棚卸し し、フォルダ構造を設 計する 02 フォルダ作成 設計した構造で Obsidian Vaultのフォル ダを作成する 03 CLAUDE.md整備 Vault構造セクションと ファイル命名規則を追 加する 04 動作検証 「〇〇の情報を探し て」と依頼し自動で見 つかるか検証する
  15.     ── AI時代のエンジニア転職プラットフォーム AIにできないことが1つだけあります。それは「何がしたいか」という夢を持つこと。 人間ならではの好奇心や違和感こそが、未来で最も価値ある「問い」になる。 Offersは、個人の「問い」と企業の「問い」が響き合い、新しい価値を生み出す場所です。 求職者の方へ Offersは「今すぐ転職する人」だけのサービスではありません。AI 時代のキャリア相談、先端AI企業への転職、職務経歴の棚卸しやAI による強み分析も可能です。 offers.jp

    ─ まずは無料登録 Offers職務経歴 AIx人間ハイブリッドの職務経歴作成サービス 企業の方へ OffersはAI RPOサービスです。35,000人以上の登録ユーザーからAI が最適な候補者を発見し、心理フェーズに合わせたスカウトを自動 配信。採用戦略の設計は専任CSチームが伴走し、「再現性ある採 用」を実現します。 サービスを見てみる PR
  16. FIN