PJのドキュメントを全部Git管理にしたら、一番喜んだのはAIだった

プロジェクトのドキュメント管理をGit×Obsidianで管理してみませんか？という話をします。

プロジェクトを進める上で、議事録や、相談内容、決定事項といった情報は、メンバー全員がいつでも確認できる場所にまとめるのが理想です。

しかし、その「場所」をどこにするか問題の話を今日はしてみたいです。

https://qiita.com/oga_aiichiro/items/1eb903562851f4f4a206

Transcript

1. 福岡新卒エンジニアの会 vol.3 PJ のドキュメントを全部 Git 管理にしたら 、 1 番喜んだのはA Iだった 大賀 愛一郎（ @oga_aiichiro ） 2026.02.17
2. 16:9 写真を挿入 ABOUT ME 大賀 愛一郎 おおが あいいちろう 24 卒 新卒2 年目 Web フルスタック（ Next.js / .NET など ） 最近は社内のAI Agent 推進役 趣味: ピアノ / カメラ / ゲーム X / Twitter … @oga_aiichiro
3. LIKE アウトプットが好きです 。 Zenn Books 現在1 位 「 0 から分かる Claude Code 」 全21 章・約 7 万字の無料Book はてなブックマーク 先週 総合ジャンル 1 位 Zenn やQiita でも ちょくちょく記事書いてます 16:9 Zenn Books スクリーンショットを挿入 (↑正直はてブの件は反響大きすぎてビビってます …) Zenn.dev
4. ─ 今日のテーマ ─ ドキュメントを Git ×Obsidian で 管理してみませんか？
5. SECTION 01 よくある ドキュメント管理の手法とその問題 社内Wiki 複数人で同時更新すると 後から保存した人が勝つ 「後勝ち」問題 作業が消える虚無感 Microsoft Loop 複数人で同時に触ると 挙動が不安定に なることがある 急に消える、動かない Notion 個人利用は無制限だが チーム利用（ 2 名以上）は 無料プランでブロック 数に上限 気づいたら上限に到達 共通の問題 「他の人が書いた内容を上書きしにくい」心理的ハードル → 遠慮して新しいファイルを作る → ファイル乱立
6. SECTION 02 1 コンフリクト が検知される 「後勝ち」問題をそもそも起こさない 2 プルリクエスト がある 上書きの心理的ハードルが下がる 議事録などで PR → レビュー依頼も効果的 3 プレーンテキスト で自由 Markdown で管理 ツール固有の制限に振り回されない ただし問題 も …… 非開発者にとって Git 操作はハードルが高 かった ターミナル開いて git add . して git commit -m "..." して git push して … テス トメンバー・デザイナー には難しい面もある Git / GitHub 管理をしたい！
7. SECTION 03 商用ライセンス無料化 2025 年2 月〜 2 人以上の企業での業務利用も ライセンス購入が不要に アカウント登録も広告もなし Git プラグイン ボタン 2 つでGit 操作 commit & push / pull が ボタン 1 つで完了 自動コミット間隔の設定も可能 画像容量の対策 プラグインで自動処理 JPEG 圧縮、 自動掃除など プラグインが豊富 非開発者に「このボタン押して保存、このボタン押して最新化」と伝えるだけ → Git 管理が回る Obsidian による解決
8. SECTION 04 実際にやってみた 運用方法はプロジェクトごとに異なりますが、 弊プロジェクトでの運用例をご紹介
12. SECTION 05 運用まとめと 注意点 フォルダ構成 （ 大きく 4 層） 個人フォルダ → 各自が自由に書くスペース 議事録フォルダ → 議事録突っ込む Q&A フォルダ → 共有ナレッジ まとめフォルダ → リリース単位でリンク集約 他の人に読んでほしいものは 対象者をレビュワーにして PR を出すルール 注意点 workspace.json のコンフリクト → .gitignore に追加しておく Vault 全体のGit 管理が重くなる → 画像/PDF が多い場合は 特定フォルダだけ Git 管理 出口戦略が大事 → リリース区切りで確定情報を社内 Wiki へ → ただのテキストなのでコピペも楽
13. ここまでが「人間にとっての改善」。 Git 管理で後勝ち問題もファイル乱立も解消。 めでたしめでたし。 …で終わるはずだったんですが 。
14. SECTION 06 Notion などのクラウドツール 独自フォーマット でクラウド上に保存 外部AI ツールから直接読み書きが難しい API 経由だと遅延があり、 MCP 経由だと不安定性が報告されている。 → Obsidian （ Git 管理のMarkdown ） ただの Markdown ファイル がローカルにある Claude Code / Cursor / Copilot から 直接読み書きできる 爆速。安定。 なんでもできる。 思いがけず？Claude Code との親和性が最高だった。
15. SECTION 07 実際にClaude Code に何を頼めるのか 「 過去3 回分の議事録を読んで、未解決の TODO を一覧にして 」 → 散らばった議事録から未消化タスクを自動抽出 「 この PJ で「認証」に関する決定事項をすべて探して 」 → 数十ファイルを横断検索して関連箇所だけ返してくれる 「 今週の自分のメモから週報のドラフトを作って 」 → 日々の作業メモが週報に変わる。書く時間ほぼゼロ 「 新メンバー向けに、 PJ の全体像と用語集をまとめて 」 → 既存ドキュメントからオンボーディング資料を自動生成 Vault フォルダを Claude Code / Cursor で開くだけ。特別な設定は不要。
16. SECTION 08 企業での活用事例 YOUTRUST: 議事録要約・エラーメモ検索 エムスリー : 記録→検索→分析→洞察のワークフロー自動化 MCP 連携 Claude Desktop から Obsidian のノートを横断検索 過去のメモ全体を AI の文脈として活用 Obsidian 公式CLI （ v1.12 ） ターミナルから Obsidian 操作可能に スクリプティング・自動化が容易 AI エージェントの "メモリ "として期待 RAG 構築 ローカルファイル → そのままデータソース ローカル LLM と組み合わせで セキュアな PJ 専用Q&A ボット ほかにもできること あれこれ
17. ここらへんの話は私の Qiita に書いてあります https://qiita.com/oga_aiichiro/items/9736d5c579aec7fec075
18. SUMMARY 本日のまとめ 1 素のMarkdown で 持とう！ 2 Git / GitHub で 管理しよう！ 3 AI Agent との 親和性を高めよう！ 特定のツールに依存 しない この組み合わせが 、 今のところ一番柔軟で 、 今後のAI の進化にもそのまま乗れる構成 。 「 ドキュメント管理、何とかしたいな …」 という方の参考に少しでもなれば幸いです。
19. ここらへんの話は私の Qiita に書いてあります 2 https://qiita.com/oga_aiichiro/items/1eb903562851f4f4a206
20. Thank you! 参考リンク Obsidian 公式「 Obsidian is now free for work 」（ 2025/2/20 ） Obsidian Changelog - v1.12 CLI 追加 YOUTRUST 「 Claude Code ×Obsidian で作るナレッジベース開発環境」 エムスリー「 Obsidian + Claude Code を業務アシスタントに」 i3DESIGN 「 Obsidian ×Claude Code ×MCP で変わる開発フロー」