概要
https://speakerdeck.com/onikun94/ai-shi-dai-nodokiyumentoguan-li-shu
詳細内容
## AI時代のドキュメント管理術：Obsidian×GitHub×AIによる実践的アーキテクチャ
https://speakerdeck.com/onikun94/ai-shi-dai-nodokiyumentoguan-li-shu
Obsidianをプロキシ、GitHubを単一情報源とするドキュメント管理アーキテクチャを提示し、AIコーディング時代に最適化された実装パターンを解説している。
**Content Type**: 📊 Presentation
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:5/5
**Main Journal**: 86/100 | **Annex Potential**: 88/100 | **Overall**: 84/100
**Topics**: [[Obsidian, AIファーストドキュメント管理, GitHub中心設計, ドキュメント自動アーカイブ, 重複生成防止]]
AI時代におけるドキュメント管理の重要性は大きく変化しました。従来は「チームメンバーや新規参加者がプロダクトを理解できるように残す」ことが目的でしたが、現在は「AIを用いて開発するためのコンテキストとして残す」必要があります。AIに正確かつ最新のコンテキストを渡す必要があり、参照が難しい、古い情報が残っている、ドキュメントが複数で管理されている、似たドキュメントが複数存在するといった従来の課題が、AI活用において致命的な問題となります。
**Obsidianによるドキュメント管理構成**
著者が提案する最適解は、Obsidianをプロキシとして使用することです。ObsidianはAIとの親和性が高いメモツールであり、ドキュメント管理構成の核となります。重要なのはGitHubによる一元管理とObsidianのプロキシ活用です。すべてのドキュメント・データはGitHubに集約させることが大切で、既存サービスを剥がして移行するのはコストがかかるため、既存サービスはそのままGitHubに集約し、GitHub Actionsと組み合わせることで定期的に取得できます。
GitHubとObsidianを同期させることでGitHub上の内容をすべてObsidianに取り込みます。取り込んだデータはすべてread-onlyフォルダもしくはread-onlyタグを付与して管理します。これらを読み取り専用とし、プロキシ以外にもAIで生成した内容を出力させるai_outputフォルダも定義します。Obsidianは「Obsidian Git」というプラグインを用いることで自動でGitHub上から最新のドキュメントを自動取得することができます。したがってObsidianを使うことでNotionや他ツールで管理している状態は気にすることなく一元管理することができます。
外部から取り込んだドキュメントを読み取り専用にするためには、使用するAIでルールを設定する必要があります。CursorならCursor Rules、ClaudeならClaudeでのルール設定が必要です。読み取り専用フォルダ配下のファイルは参照のみ可能で編集不可とし、AIで新規作成したファイルは指定がない限りai_outputフォルダ配下に出力するよう設定します。
**MCPとの比較**
GitHubとObsidianを介さずともNotion MCPで直接参照すればいいのではという意見もありますが、Notion MCPでは参照したいファイルをうまく参照できない問題があります。ローカルと比較すると速さが劣るなどAIとの親和性を考えたときはObsidianを活用することに軍配が上がります。なによりAIファーストなドキュメント管理をしたいのでGitHub上で再構成するのが理想です。
**AIファーストな設計**
ドキュメントは時間経過に弱く情報が古くなります。古い情報もAIは最新の情報と等しく扱ってしまうため、生成するドキュメントの品質が低下してしまいます。そこでそれぞれのドキュメントの日付プロパティから一定期間経過したドキュメントはアーカイブフォルダに移動させることで品質を担保することができます。これはGitHub Actionsで更新日時でファイルをArchiveフォルダに振り分ける仕組みで実現します。
Notionなどでドキュメント管理がうまくできていないと同じ内容のドキュメントを作成してしまいドキュメントが乱雑化します。既存で重複しているものはAIを活用することで発見することができます。また新規でアウトプットする際もAIに既存で同じ内容のドキュメントが存在しないかチェックしてもらうことで重複を防ぐことができます。これは重複検知と重複生成抑制という2つの機能として実装できます。
本発表は、AIコーディング時代に最適化された実践的なドキュメント管理システムの構築方法を、具体的なツール選定理由、アーキテクチャパターン、自動化手法とともに示しており、AI活用を前提としたチーム開発において即座に導入可能な知見を提供しています。