inflearn logo
知識共有
inflearn logo

Obsidian × Claude Code LLMウィキ実践:6か月運用した業務ウィキをそのまま(Codex対応可)

AIが作業するたびにプロジェクトWikiに決定事項とその理由を自ら残させ、そのWikiを守り、数か月後も壊れないよう点検します。開示通知ボットを実際に作り、事故が起きるたびにルールを一つずつ定めます。

1名 が受講中です。

難易度 初級

受講期間 無制限

claude
claude
codex
codex
obsidian
obsidian
LLM
LLM
Vibe Coding
Vibe Coding
claude
claude
codex
codex
obsidian
obsidian
LLM
LLM
Vibe Coding
Vibe Coding

受講後に得られること

  • AIが作業するたびに、自らの判断とその理由を記録するプロジェクトWiki(CLAUDE.md、AGENTS.mdのルールファイルを含む)

  • AIがWikiを台無しにするのを防ぐコミット前チェック機構

  • 同じ開示が二重に送られる事故を教訓ページとして残し、新しいセッションがその教訓を別の場所で適用するか確認する方法

  • 6か月運用したWikiが壊れていくパターン(目次の途切れ、孤児ページ、古い情報)を点検する手順と、1か月の運用チェックリスト

この講座は全28本の動画講義が中心で、同じ内容を章ごとのPDF(全158ページ)でもお渡しします。動画で流れを確認し、PDFで指示の原文と画面をもう一度確認する構成です。

Claude CodeやCodexを数日使った人は、同じ場面を経験します。昨日決めたことを、今日の新しいセッションは知りません。同じ決定をAIが何度も覆します。数か月後には、なぜそうしたのかを私もAIも分かりません。この講義では、その解決策としてLLMウィキを作ります。AIが作業するたびに、プロジェクトフォルダ内のMarkdownウィキに決定と理由を自ら残し、人はObsidianでそのウィキを見ます。人が"ウィキに書いておいて"と頼む必要をなくすことが目標です。

6か月運用したウィキの数字から

まず、著者が4月12日から実際に運用してきた業務Wikiを数字で見てみます。ページ452個、コミット1321回、コミットがあった日163日、ページ間のリンク802個。そして、そのWikiがどのように壊れたのかも見てみます。どこからもつながっていないページ146個、存在しないページを指すリンク240個。自動生成されたメモリ目次が277行になると、先頭114行しか読み込まれず、163行が切り捨てられたという警告。作ったばかりの日のWikiは、すべてきれいです。問題は数か月後です。

何を作るのか

実習は空のフォルダから始める開示通知ボットです。金融監督院のOpenDARTからその日の開示情報を受け取り、関心のある銘柄の開示だけを選び、AIによる3行要約を添えてTelegramに送り、サーバー上で平日の昼間に30分ごとに動作します。ボットはあくまで例であり、本当の成果物はボットを作る過程で成長していくWikiです。各章で実際に作業する中で問題が起こり、その問題からWikiのルールが一つずつ生まれます。

章ごとにトラブルが一つずつ起こり、ルールが一つずつ生まれます

1章:Wikiなしで始めます。10-02の公示771件のうち、有価証券市場とKOSDAQの573件だけが表示されるよう意図的に絞り込みましたが、新しいセッションはコミットメッセージからその決定を見つけたにもかかわらずフィルターを広げ、同じフォルダーで開いたCodexはフィルターを丸ごと削除しました。理由が会話の中にしかなかったためです。そこで最初のWikiとルールファイル(CLAUDE.md、AGENTS.md)が生まれます。

第2章:"ウィキに書いておいて"という言葉がなくても、決定事項が残るかを確認します。残りました。しかし、AIが独自に選んだファイル構成まで決定事項として記録され、次のセッションがそれを根拠にユーザーの依頼を拒みました。決定ごとに誰が決めたのか(ユーザー、AIのデフォルト、未確認)を記載し、根拠となる原文を省略しないというルールが生まれます。

3章:AI要約を付けます。セッションは要約5件すべてが原文と一致すると報告し、その文言がWikiの確認欄に入りました。根拠を尋ねると、実際に照合したのは3件でした。確認欄には実際に実行したコマンドと範囲だけを記載するルール、外部資料を出典と日付とともに入れる資料ページ、Wikiで尋ねられたら根拠ページを添えて答えるルールが生まれます。

4章:同じ公示が2回送られました。著者が同じ命令を同時に2回実行する条件を作った場面です。最初の教訓ページが作成され、新しいセッションは別の機能でその教訓を名前で呼び出して適用しました。偽の部品で5つを同時に実行するテストを20回繰り返し、20回すべてで正確に2つだけが送られました。

5章:サーバーにアップロードし、平日の決まった時間ごとに実行されるようにします。そして、キーをWikiに整理してほしいというもっともらしい依頼をわざとします。2章で正直であろうとして作った"未確認"欄が、3章後にキーを守りました。

6章: "ちょっと整理して"の一言で、変更履歴の過去の記録26行が書き換えられ、確認範囲が消えました。コミット前の点検装置を作ろうとすると、今度はコーデックスが点検を通過するためにルールファイルと点検スクリプトを修正してコミットしようとしました。装置を修正して通過できないようにする方法を見ます。

7章:Obsidianで初めてウィキを人の目で確認します。開く前にファイルの指紋を取り、後で比較して、18個のうち変更されたファイルが0個であることを確認します。グラフ上の薄い点の一つは、チェック用スクリプトは通過した壊れたリンクでした。AIがObsidianのコマンドライン(CLI)で直接ウィキを点検する場面もあります。

8章:人間がコードだけを修正した日を作り(著者が作った条件)、AIに点検(Lint)をさせます。ウィキとローカルコードとサーバーが互いに異なっている箇所、そして条件とは関係なくすでに古くなっていた資料ページまで明らかになります。新しいセッションが作業前に本当に先に点検しているのか、もう一度確認します。

第9章:この方式を、すでにルールファイルが87行積み上がっている別のプロジェクトに移し、移したツールとは別のツールで再度突き合わせます。原文284行から文字は抜けていないのに、いつも自動的に読まれていた注意事項が、探して読まなければならない内容になっていることを見つけました。最後に、初日から1か月までの運用チェックリストをお渡しします。

計画したものの起きなかった事故については起きなかったと記し、著者が条件を作った場面については、その旨を明記しました。

講義でセッションに送った指示65件が原文のままPDFに収録されており、画面キャプチャは138枚です。ターミナル画面は実際に出力された文字を描き直したもので、ユーザー名とパスだけを変更しており、Obsidianの画面は実際のウィンドウを撮影したものです。

ルールファイルはCLAUDE.mdとAGENTS.mdに同じ内容で配置し、Claude CodeとCodexのどちらで作業しても1つのWikiに蓄積されるようにします。講義本編はClaude Codeで進め、Codexが同じWikiに続きを書く場面が1章、2章、5章、6章、9章に登場します。ObsidianはプラグインなしでWikiを見るためのウィンドウとしてのみ使用し、初日はWikiを壊さないための5つの設定から始めます。

実習リポジトリ:https://github.com/JCLab-coder/disclosure-radar(公開リポジトリ、章ごとのタグ)。各章の終了時点でch01からch09までのタグがあり、行き詰まった場合はその章のタグを取得して照合できます。コードはリポジトリに記載されたライセンスに従います。

この講義の開示画面と要約は、公開開示を示す実習例であり、投資の勧誘ではありません。ボットは売買や銘柄の推奨を行いません。

準備物と費用

  • Claude Code または Codex(すでに保有):サブスクリプションまたは使用量に応じた課金。この講義の前提

  • Obsidian(1章):無料。有料機能(同期、公開)は使用しない

  • OpenDART認証キー(1章):無料

  • Telegramボット(2章):無料

  • AI要約(OpenRouter)(3章):使用量に応じた課金。実習全体でキーが使用した金額は0.0032ドル

  • サーバー(Railway)(5章):初めて登録すると、30日間使える5ドル分が一度付与され、その後のHobby料金プランは月額5ドル(5ドル分の利用を含む)です。実習でのサーバー使用額は10-03までで0.00044ドルです。ない場合は5章のサーバー画面だけ再現できず、Wikiの内容はローカルですべて実行できます。

そのほかにNode 21.7以上、gitが必要です。料金は変更される場合があります。


資料利用案内

この講座の動画、本文、画面キャプチャ、PDFファイルは、購入者本人の学習目的に限り使用できます。ほかの人に渡したり、公開された場所にアップロードしたり、再販売したりすることは許可されていません。実習リポジトリのコードはリポジトリに記載されたライセンスに従い、コードと講座資料は別の条件が適用されます。

こんな方に
おすすめです

学習対象は
誰でしょう?

  • 新しいセッションのたびに、昨日決めたことを最初から説明し直すClaude Code、Codexユーザー

  • AIが同じ決定を何度も覆して、もどかしさを感じる開発者、個人開発者

  • コードはAIに任せて結果を見るだけで、数か月後にはなぜそうしたのか誰も分からないバイブコーダー

  • ObsidianをAIと一緒に仕事で使ってみたいけれど、ノート整理ではなくプロジェクトの記録が必要な人

前提知識、
必要でしょうか?

  • Claude CodeまたはCodexをすでに使用している必要があります。インストールや基本的な使い方については扱いません。

  • ターミナルとgitを使える必要があります。JavaScriptは読めればよく、コードはAIが書きます。

こんにちは
jclabです。

キャリア認証

サービスを作り、運用する開発者です。

Claude Codeを実務で使う中で経験したことと、そこから生まれたルールを共有します。理論よりも、実際に起きた問題とコードの原文をもとにお話しします。

開発、運用、データ、自動化まで、必要なものは自分で作って使います。

もっと見る

カリキュラム

全体

36件 ∙ (1時間 8分)

講座資料:

授業資料
講座掲載日: 
最終更新日: 

受講レビュー

まだ十分な評価が集まっていない講座です。
ぜひ最初のレビューをお寄せください。

似ている講座

同じ分野の他の講座を見てみましょう!

期間限定セール

¥74,250

25%

¥12,518