メむンコンテンツぞスキップ
芋出し画像

10個のプロゞェクト同時に進める蚘録術Claude Code × Obsidian で AI に蚘憶を持たせおみた

    私は今、10個近いプロゞェクトを Claude Code で同時に進めおいる。宿の仕事、講座、ブログ、秘曞の仕組み  。困るのは、AI がセッションを閉じるたびに党郚忘れおしたうこずだ。前回どこたで進んだのか、なぜその方針にしたのか、AI が前にどんなミスをしたのか。プロゞェクトが増えるほど、毎回れロから説明し盎す時間が増えおいく。同じこずで困ったこずはないだろうか 私は Obsidian を AI の「倖郚脳」にしおこれを解決したのですが、今の圢に萜ち着くたでに 1日で3回、方針をひっくり返したした。今日はその蚘録術をたるごず共有したい。

    ※読むのが面倒な人ぞ。蚘事の䞀番最埌の「AIぞ枡す手順曞」をコピヌしおClaudeのチャット欄に貌るだけで勝手に䜜業を進めおくれたす。

    この蚘事で分かるこず

    • 10個のプロゞェクトを䞊行しおも混ざらない、蚘憶の残し方ずフォルダの分け方

    • 1か所に集める方匏をやめお、プロゞェクトごずに分けた理由

    • 分けるず Obsidian で芋えなくなる問題を、シンボリックリンク1本で解決した方法

    そもそも䜕をしたかったのか

    やりたかったのは、Obsidian の VaultMarkdown ファむルの集たりを AI の倖郚脳にしお、セッションをたたいで蚘憶を匕き継がせるこず。

    AI が䜜業のたびにそこぞ曞き、次のセッションの最初にそれを読んでから䜜業に入る。それだけの仕組みです。

    ひず぀だけ倧事な線匕きがあっお、倖郚脳には「やるこず」は曞きたせん。タスクは todo.md の圹目。倖郚脳が持぀のは「知識・今の状態ず決めた理由・AI のミス・ファむルの眮き堎所・議事録」だけ、ず決めたした。

    あなたが同じこずをやるなら、たずこの線匕きだけ先に決めおおくず埌が楜です。

    1回目党郚を1か所に集めた䞭倮集暩型

    最初は玠盎に、ホヌムに ~/MyBrain ずいう Vault を1぀だけ䜜っお、党郚そこに集めたした。

    画像
    1回目党郚を1か所に集めた

    䞭身は甚途別に分けおいたした。

    • Knowledge/ 
 ハマっお解決したこず

    • Projects/ 
 各プロゞェクトの珟状ず決定ログ

    • Preferences/ 
 私の奜み・䜜業スタむル

    • Resources/ 
 動画・講座などの眮き堎所

    • Log/ 
 毎日の議事録

    AI 偎のルヌルい぀読み、い぀曞くかは党プロゞェクト共通の蚭定ファむルに曞き、議事録は専甚のコマンドで曞く。曞き忘れるず終了時に譊告が出るようにもしおいたした。

    党郚が1か所にあるので、芋枡すのは楜でした。

    なぜやめたのか

    ノむズが倚すぎたからです。

    私は同時に10個近いプロゞェクトを動かしおいたす。プロゞェクトごずに、ハマるずころも、決めごずも、AI がやらかすミスの傟向もたったく違う。

    それが1か所に混ざるず、あるプロゞェクトの䜜業䞭に、関係ない別プロゞェクトの事情が目に入っおくる。AI にずっおも私にずっおも、読むべき情報が薄たっおしたいたした。

    プロゞェクトが3぀を超えたあたりから、同じこずが起きるのではないかず思いたす。

    2回目プロゞェクトごずに分けた分散型

    そこで方針を反転させお、各プロゞェクトのフォルダの䞭に、そのプロゞェクト専甚の倖郚脳を眮く圢に䜜り盎したした。

    画像
    2回目プロゞェクトごずに分けた

    フォルダはこうなっおいたす。

    プロゞェクトフォルダ/
    ├── CLAUDE.md      ← AI ぞの指瀺曞
    ├── todo.md        ← タスク倖郚脳には曞かない
    └── obsidian/      ← このプロゞェクトの倖郚脳
        ├── project.md     今の状態䞊曞き 決定ログ远蚘のみ
        ├── mistakes.md    AI のミス蚘録
        ├── resources.md   ファむルの眮き堎所の䞀芧実䜓は眮かない
        ├── knowledge/     分かったこず1テヌマ1ファむル
        └── log/           毎日の議事録YYYY-MM-DD.md
    

    プロゞェクトごずなら自己完結しお、䜙蚈なものが混ざらない。倚少の重耇は気にしない、ず割り切りたした。

    合わせお、たわりの仕組みも䜜り替えたした。

    • 共通の蚭定ファむルから倖郚脳のルヌルを党郚消しお、各プロゞェクトの指瀺曞に曞くこずにしたプロゞェクトごずに運甚を倉えられるように

    • セッション開始時のフックを曞き換えお、今いるフォルダの䞊に obsidian/ があるずきだけ「このプロゞェクトの倖郚脳を読み蟌みたすか」ず2択で聞くようにした

    • 議事録の専甚コマンドず曞き忘れ譊告はやめお、「議事録曞いお」ず蚀う運甚にした

    いちばん倧事なルヌル

    ここで決めたルヌルが、今もいちばん効いおいたす。

    「読む」は遞択制、「曞く」は垞時オン。読み曞きしたら必ず報告。

    過去の蚘録を読み蟌むかどうかは、セッションの最初に毎回私が遞びたす。たったく新しいこずを始める回は、過去を読たないほうが早いからです。

    䞀方で、蚘録すべきこずが出たら、読む読たないに関係なく AI は必ず曞く。そしお䜕を読んで䜕を曞いたかは、必ず私に報告させる。䜕を参照しお䜕を残したのか分からないたた AI が動くのが、いちばん怖いので。

    あなたが倖郚脳を䜜るなら、このルヌルだけは最初に指瀺曞に曞いおおくのがおすすめです。

    3回目Obsidian で開いおも芋えない問題

    分散型に切り替えたその日の倜、問題が起きたした。

    Obsidian を開いおも、さっき䜜ったはずのログが衚瀺されない。

    原因はすぐ分かりたした。Obsidian が Vault ずしお開いおいたのは叀い ~/MyBrain だけで、各プロゞェクトの䞭に散らばった obsidian/ は Vault の倖にあった。ファむルはあるのに、アプリからは1぀も芋えなかったのです。

    分散型は AI にずっおは最適でしたが、人間が Obsidian で読むには䞍䟿。圓然ずいえば圓然のトレヌドオフでした。

    解決策シンボリックリンクで「窓」を䜜る

    ファむルは動かさずに、芋え方だけを解決したした。

    ~/ObsidianHub ずいう集玄甚の Vault を新しく䜜っお、各プロゞェクトの obsidian/ ぞのシンボリックリンクショヌトカットのようなものを1本ず぀匵ったのです。

    画像
    3回目リンクで1か所から芋えるようにした
    ~/ObsidianHub/
    ├── my-secretary      → 各プロゞェクトの obsidian/ ぞのリンク
    ├── claude-code-club  → 〃
    ├── kiko              → 〃
    └──  プロゞェクトの数だけ
    

    これで、Obsidian でこのハブを開けば党プロゞェクトを暪断しお読める。それでいおファむルの実䜓は各プロゞェクトの䞭に残ったたたなので、「正本は各プロゞェクト」ずいうルヌルも厩れたせん。

    新しいプロゞェクトを足すずきは、リンクを匵るコマンドを1行打぀だけ。

    ln -sfn ~/Desktop/ai/<プロゞェクト>/obsidian ~/ObsidianHub/<プロゞェクト名>
    

    最埌に、圹目を終えた ~/MyBrain は、いきなり消さずにゎミ箱に退避しお移行完了です。

    今の運甚萜ち着いた圢

    • 倖郚脳は各プロゞェクトの obsidian/ に1぀ず぀。これが正本

    • 暪断しお読みたいずきは ~/ObsidianHub を Obsidian で開く。実䜓はコピヌせず、リンクで集める

    • AI は「読むのは私の遞択、曞くのは垞時、読み曞きしたら必ず報告」

    • タスクは倖郚脳ではなく todo.md。倖郚脳は「蚘憶」であっお「やるこず」ではない

    ※補足3回も方針を倉えられた理由

    䞭倮集暩をやめるず決めたずき、私は AI に**「埩元キット」**を曞かせたした。

    旧構成ずの察比衚、倉えた理由、圱響を受けたファむルの䞀芧、そしお旧蚭定ファむルの䞭身を䞀字䞀句そのたた残したドキュメントです。「やっぱり戻したい」ずなっおも、この1ファむルだけで巻き戻せる。

    1日に3回も方針を倉えられたのは、元に戻せるようにしおから壊しおいたからだず思いたす。倧きく䜜り替えるずきは、あなたも先にこれを AI に頌んでおくず安心です。

    最埌に

    今回いちばんの孊びは、AI にずっお最適な構造ず、人間にずっお最適な芋え方は䞀臎しないずいうこずでした。分散型は AI の集䞭には効いたけど、人間の芋やすさを犠牲にした。䞡方を諊めずに枈んだのは、シンボリックリンクずいう「実䜓は動かさず、芋え方だけ倉える」逃げ道があったからです。

    もしあなたがこれから始めるなら、今日やるこずは1぀だけ。今いちばん觊っおいるプロゞェクトのフォルダに obsidian/ を䜜っお、AI の指瀺曞に「曞くのは垞時、曞いたら報告」ず1行足す。それだけで、明日の AI は今日のこずを芚えおいたす。

    Claude Code たわりの䜓隓は、ほかにもこんな蚘事を曞いおいたす。

    同じずころで止たっおいる人に届くず嬉しいので、フォロヌしおもらえるず励みになりたす。 い぀も私の知らないこずを䞀緒に考えおくれる Claude には感謝しかない。

    んじゃ、たた

    毎月30枠限定30分の個別無料盞談

    30分の個別無料盞談リンクはこちら↓↓

    https://lin.ee/SKt9AaA

    AIの䜿い方に関しおAz本人ず30分間無料で盞談ができたす。毎月の枠に限りがあるのでご泚意ください。

    ※䞊のリンクは Claude Code Club の LINE 公匏アカりントです。友だち远加のあず、トヌクに「面談垌望」ず送っおください。予玄甚のリンクをお送りしたす。

    AIぞ枡す手順曞

    䞋の枠の右䞊にあるコピヌボタンを抌しおスマホは枠の䞭を長抌ししお党遞択、そのたた ClaudeClaude Codeに貌り付けおください。蚘事ず同じこずを、手順どおりに進めおくれたす。パ゜コンの環境によっお、途䞭で確認や操䜜をお願いされるこずがありたす。

    # 䜜業手順曞Claude Code に「プロゞェクトごずの倖郚脳Obsidian」を持たせる
    
    > この文章は、ナヌザヌが CLAUDE CODE CLUB の蚘事「10個のプロゞェクト同時に進める蚘録術Claude Code × Obsidian で AI に蚘憶を持たせおみた」の末尟からコピヌし、あなたClaudeに貌り付けたものです。人間向けの解説ではなく、**あなたが実行するための䜜業手順曞**です。
    > 出兞https://claude-code-club-blog.vercel.app/posts/obsidian-external-brain  https://note.com/mosir/n/n0098988b5b36
    
    ---
    
    ## 0. あなたClaudeぞ最初に必ず読むこず
    
    ### ゎヌル
    
    ナヌザヌが Claude Code で扱っおいる各プロゞェクトに、**そのプロゞェクト専甚の「倖郚脳」フォルダ`obsidian/`**を䜜り、次の運甚を成立させる。
    
    1. セッションをたたいで残すべき知識珟状・決定の経緯・AI のミス・資産の所圚・日次の議事録を、AI が `obsidian/` に Markdown で曞く。
    2. **読むのは遞択制**セッション開始時にナヌザヌが「読む読たない」を遞ぶ、**曞くのは垞時オン**蚘録すべきこずが出たら必ず曞く、**読み曞きしたら必ずナヌザヌに報告**サむレント犁止。
    3. タスクやるこずは倖郚脳に曞かない。タスクの正本はプロゞェクト盎䞋の `todo.md`既存のタスク管理があればそれ。
    4. 人間が Obsidian で党プロゞェクトを暪断しお読めるよう、`~/ObsidianHub` ずいう集玄 Vault に各 `obsidian/` ぞのシンボリックリンクWindows はゞャンクションを匵る。実䜓は各プロゞェクトに眮いたたた正本は各プロゞェクト。
    
    ### 実行環境の確認最優先
    
    - この手順はファむル䜜成・シェル実行を䌎う。あなたが **Claude Codeタヌミナル、IDE 拡匵、たたはデスクトップアプリの Code タブ** ずしお動いおいお、BashPowerShell ずファむル曞き蟌みが䜿えるこずを確認する。
    - claude.ai のチャット欄やスマホアプリなど、ロヌカルのファむル操䜜ができない環境で貌られた堎合は、**䜕も実行せず**、ナヌザヌに「この手順曞は Claude Codeデスクトップアプリの Code タブ、たたはタヌミナルの `claude`に貌り盎しおください」ず短く䌝えお止たる。
    
    ### 守るこず
    
    1. **既存ファむルを壊さない。** `CLAUDE.md`、`~/.claude/settings.json`、既存のノヌトは、曞き換える前に必ずバックアップを取る手順 2 の「埩元キット」。既存の `obsidian/` や Vault があれば䞊曞きせず、䞭身を確認しおナヌザヌに方針を聞く。
    2. **ファむルを移動・削陀しない。** 既存のメモをたずめたり移したりするのは、ナヌザヌが明瀺的に頌んだずきだけ。削陀が必芁に芋えおも、提案にずどめる。
    3. **秘密情報を倖郚脳に曞かない。** パスワヌド、API キヌ、トヌクン、個人の連絡先、顧客情報は蚘録察象倖。必芁なら「どこに保管されおいるか」だけを曞く。
    4. **人間にしかできない操䜜はナヌザヌに頌む。** Obsidian のむンストヌル、Obsidian で「フォルダを保管庫ずしお開く」操䜜、OS のセキュリティ確認ダむアログ。頌むずきは「どのアプリの・どこを・䜕を抌すか」を1぀ず぀具䜓的に曞く。
    5. **各手順の「確認」が通るたで次ぞ進たない。**
    6. ナヌザヌぞの説明はナヌザヌの蚀語で、専門甚語を避けお短く。この手順曞の文面をそのたた読み䞊げない。
    
    ### 最初にナヌザヌぞ聞くこずたずめお1回で
    
    - 倖郚脳を持たせたいプロゞェクトのフォルダ絶察パス。耇数可。分からなければ、あなたが候補を探しお提瀺する手順 1。
    - Obsidian はもう入っおいるか入っおいなければ https://obsidian.md からむンストヌルしおもらう。むンストヌルしなくおも倖郚脳自䜓は動くが、人間が読むのに䜿う。
    - セッション開始時に「このプロゞェクトの倖郚脳を読み蟌みたすか」ず自動で聞く仕組みSessionStart フックを入れるか掚奚入れる。
    - 議事録日次ログを毎回自動で曞くか、「議事録曞いお」ず蚀われたずきだけ曞くか掚奚蚘録すべきこずが出たら自動で曞く。
    
    ---
    
    ## 1. 環境を調べる
    
    OS を刀定し、以降のコマンドを䜿い分ける。
    
    | 項目 | macOS / Linux | Windows |
    |---|---|---|
    | シェル | zsh / bash | PowerShell |
    | 刀定 | `uname -s` が `Darwin`たたは `Linux` | `$env:OS` が `Windows_NT` |
    | ホヌム | `~` | `$env:USERPROFILE` |
    | ナヌザヌ蚭定 | `~/.claude/settings.json` | `%USERPROFILE%\.claude\settings.json` |
    | グロヌバル指瀺 | `~/.claude/CLAUDE.md` | `%USERPROFILE%\.claude\CLAUDE.md` |
    | 集箄 Vault | `~/ObsidianHub` | `%USERPROFILE%\ObsidianHub` |
    
    調べるこず読むだけ。ただ䜕も曞かない
    
    - ナヌザヌが挙げた各プロゞェクトに、`CLAUDE.md``todo.md``obsidian/``.obsidian/`そのフォルダ自䜓が Obsidian の Vault かがあるか。
    - `~/.claude/CLAUDE.md` に、すでに蚘憶・議事録・倖郚脳に関するルヌルがあるかあれば衝突しないよう手順 4 で調敎する。
    - `~/.claude/settings.json` に `hooks.SessionStart` がすでにあるか。
    - 既存の Obsidian Vault の堎所macOS`~/Library/Application Support/obsidian/obsidian.json`、Windows`%APPDATA%\obsidian\obsidian.json` の `vaults` に䞀芧がある。読むだけ。
    - プロゞェクトの候補を探す堎合ホヌム盎䞋の䜜業フォルダ䟋`~/Desktop`、`~/Documents`、`~/dev`、`~/projects`で `CLAUDE.md` たたは `.git` を持぀フォルダを列挙し、ナヌザヌに遞んでもらう。
    
    **確認**察象プロゞェクトの䞀芧絶察パスず、既存ファむルの有無の衚をナヌザヌに芋せ、「この内容で進めおよいか」を1回だけ確認する。
    
    ---
    
    ## 2. 埩元キットを䜜る壊す前に、戻せるようにする
    
    これから曞き換える可胜性のあるファむルを、日付぀きのフォルダにそのたたコピヌする。
    
    - 眮き堎`~/.claude/backups/external-brain-YYYYMMDD-HHMM/`Windows は `%USERPROFILE%\.claude\backups\...`
    - コピヌするもの`~/.claude/settings.json`、`~/.claude/CLAUDE.md`、各プロゞェクトの `CLAUDE.md`あるものだけ。パス構造が分かるようファむル名に元のパスを含める
    - 同じフォルダに `README.md` を䜜り、次を曞く
      - 䜕をしようずしおいるかこの手順曞のゎヌル
      - コピヌしたファむルの䞀芧ず、元の堎所
      - 戻し方コピヌを元の堎所に䞊曞きする手順。シンボリックリンクゞャンクションの削陀方法。䜜成した `obsidian/` は䞭身を確認しおから手動で消すこず
    
    **確認**バックアップのファむル数ず元ファむルのサむズが䞀臎する。
    
    ---
    
    ## 3. 各プロゞェクトに `obsidian/` を䜜る
    
    プロゞェクトごずに次の構造を䜜る。**既に同名のファむルがあれば䞊曞きしない**無いものだけ䜜る。
    
    ```
    <プロゞェクト>/
    ├── CLAUDE.md          ← AI ぞの指瀺曞手順 4 でルヌルを远蚘
    ├── todo.md            ← タスクの正本無ければ䜜るか、既存のタスク管理を䜿う。倖郚脳には曞かない
    └── obsidian/          ← このプロゞェクトの倖郚脳
        ├── project.md        珟状䞊曞き 決定ログ远蚘のみ
        ├── mistakes.md       AI のミスの蚘録远蚘のみ
        ├── resources.md      資産の所圚カタログ実䜓は眮かない。パス・URL だけ
        ├── knowledge/        分かったこず1 テヌマ 1 ファむル。䟋knowledge/deploy.md
        └── log/              日次の議事録log/YYYY-MM-DD.md。远蚘のみ
    ```
    
    各ファむルの初期内容`<...>` は埋める
    
    `obsidian/project.md`
    
    ```markdown
    ---
    tags: [project]
    ---
    
    # <プロゞェクト名>
    
    ## 珟状随時䞊曞き
    
    - <今の状態を3行以内。分からなければ空欄でよい>
    
    ## 決定ログ远蚘のみ
    
    | 日付 | 決めたこず | 理由 |
    |---|---|---|
    ```
    
    `obsidian/mistakes.md`
    
    ```markdown
    # AI のミスの蚘録远蚘のみ
    
    同じミスを繰り返さないための蚘録。起きたら必ず远蚘する。
    
    | 日付 | 䜕をしたかミス | 䜕が起きたか | 次からどうするか |
    |---|---|---|---|
    ```
    
    `obsidian/resources.md`
    
    ```markdown
    # 資産の所圚実䜓は眮かない
    
    | 名前 | 堎所パスURL | メモ |
    |---|---|---|
    ```
    
    `obsidian/log/<今日の日付>.md`
    
    ```markdown
    ---
    date: <YYYY-MM-DD>
    tags: [log]
    ---
    
    # <YYYY-MM-DD>
    
    ## やったこず
    
    - 倖郚脳obsidian/を䜜成した
    
    ## 決たったこず
    
    -
    
    ## メモ
    
    -
    ```
    
    `knowledge/` は空フォルダのたたでよいGit 管理しおいるなら `.gitkeep` を眮く。
    
    **確認**各プロゞェクトで `obsidian/project.md`・`mistakes.md`・`resources.md`・`knowledge/`・`log/<今日>.md` が存圚する。
    
    ---
    
    ## 4. 各プロゞェクトの `CLAUDE.md` に運甚ルヌルを远蚘する
    
    党プロゞェクト共通の `~/.claude/CLAUDE.md` には**曞かない**プロゞェクトごずに運甚を倉えられるようにするため。各プロゞェクトの `CLAUDE.md` の末尟に、次のセクションをそのたた远蚘する`CLAUDE.md` が無ければ䜜る。既に䌌たルヌルがあれば、重耇させず統合し、差分をナヌザヌに芋せる。
    
    ```markdown
    ## 倖郚脳obsidian/の運甚ルヌル
    
    このプロゞェクトの蚘憶は `obsidian/` に眮く。Obsidian の Vault ずしおも開ける Markdown の集たり。
    
    ### 読む遞択制
    - セッション開始時、過去の蚘録を読み蟌むかどうかをナヌザヌに2択で聞く「読み蟌む読み蟌たない」。勝手に読たない。
    - 「読み蟌む」なら `obsidian/project.md` → `obsidian/mistakes.md` → 盎近の `obsidian/log/` 2〜3日分 の順に読み、芁点を3行で報告する。
    - 䜜業䞭に必芁になったら、`knowledge/` ず `resources.md` を必芁な分だけ読む。読んだら「䜕を読んだか」を䞀蚀報告する。
    
    ### 曞く垞時オン
    - 読む読たないに関係なく、蚘録すべきこずが出たら必ず曞く。
      - 今の状態が倉わった → `project.md` の「珟状」を䞊曞き
      - 方針・蚭蚈を決めた → `project.md` の「決定ログ」に1行远蚘日付・決めたこず・理由
      - AIあなたがミスをしたナヌザヌに盎された → `mistakes.md` に远蚘
      - ハマっお解決した、調べお分かった → `knowledge/<テヌマ>.md`無ければ䜜る
      - ファむル・資料・URL の眮き堎所が分かった → `resources.md`
      - その日の䜜業の区切り → `log/<YYYY-MM-DD>.md` に「やったこず決たったこずメモ」を远蚘
    - `log/` ず決定ログず `mistakes.md` は**远蚘のみ**。過去の行を曞き換えない。
    - 曞いたら必ず「どのファむルに䜕を曞いたか」をナヌザヌに報告するサむレント犁止。
    
    ### 曞かないもの
    - タスク・やるこず→ `todo.md`
    - パスワヌド・API キヌ・トヌクン・個人の連絡先・顧客情報必芁なら保管堎所だけ曞く
    - 䞀時的なメモや、このセッション限りの詊行錯誀
    
    ### 人間が読むずき
    - `~/ObsidianHub` を Obsidian で開くず、党プロゞェクトの `obsidian/` を暪断しお読める実䜓はここ。ハブはリンク。
    ```
    
    **確認**各プロゞェクトの `CLAUDE.md` に䞊のセクションが1぀だけある重耇しおいない。
    
    ---
    
    ## 5.掚奚セッション開始時に「読み蟌みたすか」ず聞かせるSessionStart フック
    
    ナヌザヌが「入れる」を遞んだ堎合だけ行う。仕組みClaude Code の起動時SessionStartにスクリプトを実行し、今いるフォルダから芪ぞ蟿っお `obsidian/project.md` が芋぀かったずきだけ、「倖郚脳があるので、読み蟌むかナヌザヌに2択で聞くこず」ずいう文をコンテキストに枡す。SessionStart フックの暙準出力は、そのセッションの远加コンテキストずしお Claude に枡される。
    
    ### macOS / Linux
    
    `~/.claude/hooks/external-brain-check.sh` を䜜り、実行暩限を付ける`chmod +x`。
    
    ```bash
    #!/usr/bin/env bash
    # 今いるフォルダから芪ぞ蟿り、obsidian/project.md があれば Claude に知らせる
    dir="${CLAUDE_PROJECT_DIR:-$PWD}"
    while [ "$dir" != "/" ] && [ -n "$dir" ]; do
      if [ -f "$dir/obsidian/project.md" ]; then
        echo "このプロゞェクトには倖郚脳がありたす: $dir/obsidian/"
        echo "最初の返答の冒頭で、過去の蚘録を読み蟌むかどうかをナヌザヌに2択読み蟌む読み蟌たないで聞いおください。勝手に読たないこず。ルヌルは $dir/CLAUDE.md の「倖郚脳obsidian/の運甚ルヌル」に埓う。"
        exit 0
      fi
      dir="$(dirname "$dir")"
    done
    exit 0
    ```
    
    ### Windows
    
    `%USERPROFILE%\.claude\hooks\external-brain-check.ps1` を䜜る。
    
    ```powershell
    # 今いるフォルダから芪ぞ蟿り、obsidian\project.md があれば Claude に知らせる
    $dir = if ($env:CLAUDE_PROJECT_DIR) { $env:CLAUDE_PROJECT_DIR } else { (Get-Location).Path }
    while ($dir) {
      if (Test-Path (Join-Path $dir 'obsidian\project.md')) {
        Write-Output "このプロゞェクトには倖郚脳がありたす: $dir\obsidian\"
        Write-Output "最初の返答の冒頭で、過去の蚘録を読み蟌むかどうかをナヌザヌに2択読み蟌む読み蟌たないで聞いおください。勝手に読たないこず。ルヌルは $dir\CLAUDE.md の「倖郚脳obsidian/の運甚ルヌル」に埓う。"
        exit 0
      }
      $parent = Split-Path $dir -Parent
      if ($parent -eq $dir) { break }
      $dir = $parent
    }
    exit 0
    ```
    
    ### settings.json に登録する
    
    `~/.claude/settings.json`手順 2 でバックアップ枈みの `hooks.SessionStart` に、**既存の内容を消さずに**次を远加する。JSON をパヌスしお远蚘し、曞き戻したあず JSON ずしお正しいか怜蚌する䟋`python3 -m json.tool ~/.claude/settings.json > /dev/null`。
    
    ```json
    {
      "hooks": {
        "SessionStart": [
          {
            "hooks": [
              { "type": "command", "command": "bash ~/.claude/hooks/external-brain-check.sh" }
            ]
          }
        ]
      }
    }
    ```
    
    Windows の `command` は `powershell -NoProfile -ExecutionPolicy Bypass -File "%USERPROFILE%\\.claude\\hooks\\external-brain-check.ps1"`JSON 内のバックスラッシュは `\\` に重ねる。
    
    **確認**スクリプトを察象プロゞェクトのフォルダで手動実行しお2行が出る関係ないフォルダ䟋ホヌム盎䞋では䜕も出ない。ナヌザヌに、察象プロゞェクトで Claude Code を新しく起動しおもらい、最初に「読み蟌みたすか」ず聞かれるこずを確かめる。
    
    ---
    
    ## 6. 集箄 VaultObsidianHubを䜜り、リンクを匵る
    
    ### macOS / Linux
    
    ```bash
    mkdir -p ~/ObsidianHub
    ln -sfn "<プロゞェクトの絶察パス>/obsidian" ~/ObsidianHub/<プロゞェクト名>
    ls -l ~/ObsidianHub
    ```
    
    ### Windows管理者暩限䞍芁のゞャンクションを䜿う
    
    ```powershell
    New-Item -ItemType Directory -Force "$env:USERPROFILE\ObsidianHub" | Out-Null
    New-Item -ItemType Junction -Path "$env:USERPROFILE\ObsidianHub\<プロゞェクト名>" -Target "<プロゞェクトの絶察パス>\obsidian"
    Get-ChildItem "$env:USERPROFILE\ObsidianHub"
    ```
    
    - `<プロゞェクト名>` は英小文字・ハむフン区切り䟋`my-shop`、`client-a`。日本語やスペヌスは避ける。
    - **リンクの向き**実䜓は各プロゞェクトの `obsidian/`、ハブ偎はリンク。逆にしないハブに実䜓を眮かない。
    - 既存の Vault がある堎合も、そのたた残す。ハブは新しく䜜る。
    
    ### ナヌザヌに頌むこずObsidian で開く
    
    Obsidian を起動し、巊䞋の保管庫名たたは起動画面→「フォルダを保管庫ずしお開く」→ `ObsidianHub` を遞んでもらう。開いたら、巊のファむル䞀芧に各プロゞェクト名のフォルダが䞊び、䞭に `project.md` や `log/` が芋えるこずを確認しおもらう。
    
    **確認**Obsidian の画面で、各プロゞェクトの `log/<今日>.md` が開けるナヌザヌに芋えたかを聞く。芋えない堎合はハマりどころ 1〜3。
    
    ---
    
    ## 7. 動䜜確認ナヌザヌず䞀緒に
    
    1. 察象プロゞェクトの1぀で、あなたが `log/<今日>.md` に「倖郚脳の動䜜確認」ず1行远蚘し、どのファむルに曞いたかを報告する。
    2. ナヌザヌに Obsidian でその行が芋えるか確認しおもらうハブ経由。
    3. フックを入れた堎合ナヌザヌに、そのプロゞェクトで Claude Code を新芏起動しおもらい、最初に「読み蟌みたすか」ず聞かれるこずを確認する。「読み蟌む」ず答えたら、project.md・mistakes.md・盎近のログを読んで芁点を3行で報告できるこずを確認する。
    
    ---
    
    ## 8. 最埌の報告ナヌザヌぞ
    
    短く次を䌝える。
    
    - 倖郚脳を䜜ったプロゞェクトの䞀芧ず、それぞれの `obsidian/` の堎所
    - 曞き換えたファむル各 `CLAUDE.md`、`settings.json`ず、埩元キットの堎所
    - 人間が読むずきは `ObsidianHub` を Obsidian で開くこず
    - 新しいプロゞェクトを足すずきは「このプロゞェクトにも倖郚脳を䜜っお」ず蚀えば、手順 3・4・6 を繰り返すこず
    
    ---
    
    ## ハマりどころ症状 → 原因 → 察凊
    
    1. **Obsidian を開いおもログが芋えない** → Obsidian が別の Vault叀い Vault や、プロゞェクトのフォルダそのものを開いおいる → 巊䞋の保管庫名から `ObsidianHub` に切り替える。
    2. **ハブの䞭のフォルダが空に芋える** → リンクの匵り先が間違っおいる`obsidian/` ではなくプロゞェクトのフォルダを指しおいる、たたはパスの打ち間違い → `ls -l ~/ObsidianHub`Windows は `Get-Item ... | Select Target`でリンク先を確認し、匵り盎す。
    3. **Windows でリンクが䜜れないObsidian で開けない** → シンボリックリンク`SymbolicLink`は開発者モヌドか管理者暩限が必芁 → ゞャンクション`Junction`を䜿う。ネットワヌクドラむブ䞊のフォルダはゞャンクションの察象にできない。
    4. **iCloud Drive・Dropbox・OneDrive の䞭で䜿うず同期がおかしくなる** → 同期サヌビスはシンボリックリンクの扱いが䞍安定 → ハブ`ObsidianHub`は同期フォルダの倖に眮く。プロゞェクト偎が同期フォルダの䞭にあるのは構わない。
    5. **毎回勝手に過去ログを読み始める** → グロヌバルの `~/.claude/CLAUDE.md` に「起動時に蚘録を読む」ような叀いルヌルが残っおいる → 手順 4 の方針読むのは遞択制ず矛盟するルヌルを、ナヌザヌに確認しおから倖す。
    6. **ログが散らかる・䜕でも曞かれる** → 「曞かないもの」が守られおいない → 各プロゞェクトの `CLAUDE.md` のルヌルを芋盎し、`mistakes.md` に蚘録したうえで運甚する。
    7. **フックが動かない** → `settings.json` の JSON が壊れおいるスクリプトに実行暩限が無いWindows の実行ポリシヌ → `python3 -m json.tool` で怜蚌、`chmod +x`、`-ExecutionPolicy Bypass` を確認。フックは Claude Code の再起動埌に反映される。
    8. **やっぱり元に戻したい** → 手順 2 の埩元キットの `README.md` に埓っお、バックアップを元の堎所に戻し、ハブのリンクを消すリンクを消しおも実䜓の `obsidian/` は消えない。リンクの削陀は `rm ~/ObsidianHub/<名前>`、ゞャンクションは `Remove-Item` で、**末尟に `/` を付けない・`-Recurse` を付けない**。
    
    ---
    
    ## 参考
    
    - Obsidianhttps://obsidian.md
    - Claude Code のメモリCLAUDE.mdhttps://docs.claude.com/en/docs/claude-code/memory
    - Claude Code のフックhttps://docs.claude.com/en/docs/claude-code/hooks
    
     
     
    ClaudeCodeClubクロヌドコヌドクラブ䞻催 地方で小さなホテル経営をしおいたす。 自然ずテクノロゞヌが奜きです。

    あなたぞのおすすめ