AIナレッジ管理ガイド

なぜAIナレッジ管理が必要か

4つのAIツールを使い分けるだけでは足りない。知識を「蓄積・検索・再利用」する仕組みが生産性の鍵。

前提条件

必要なツールを確認。

インストール

3ステップで完了。

git clone https://github.com/breferrari/minimal-second-brain.git my-brain
cd my-brain

my-brain/
├── Inbox/          # 未整理のメモ・AIとの会話ログ
├── Projects/       # プロジェクト単位の作業メモ
├── Knowledge/      # 整理済みナレッジベース
├── AGENTS.md       # AIツール共通指示ファイル
├── MANIFEST.md     # Vault構造の自動更新マップ
└── .obsidian/      # Obsidian設定（任意）

3フォルダ構造

CODE (Collect → Organize → Distill → Express) メソッドに基づく設計。

フォルダ運用ルール

4ツール対応マトリクス

各AIツールがどのファイルを参照するか。AGENTS.md が全ツール共通のブリッジになる。

AGENTS.md テンプレート

全ツールが読む共通指示ファイルの書き方。

# AGENTS.md

## Project Context
このVaultはAI開発ナレッジベースです。
- Inbox/: 未整理メモ。整理を手伝ってください。
- Projects/: アクティブプロジェクト。
- Knowledge/: 確定済みナレッジ。

## Rules
1. 新しい知見は Inbox/ にファイルを作成してください。
2. ファイル名は `YYYY-MM-DD_topic.md` 形式。
3. Knowledge/ のファイルを変更する前に確認してください。
4. MANIFEST.md を更新してください（追加・移動時）。

## Style
- 日本語で記述。技術用語は英語のまま。
- 見出しは ## から開始（# はタイトルのみ）。
- コードブロックには言語指定をつける。

ツール別ブリッジ設定

## Knowledge Base
See AGENTS.md for shared rules.
Vault location: ./my-brain/

## Knowledge Base
See AGENTS.md for shared rules.
Vault location: ./my-brain/

## Knowledge Base
Refer to AGENTS.md in project root.
Use @workspace to search Knowledge/.

AGENTS.md を直接読み込むため、
追加設定は不要です。

MANIFEST.md 自動更新

Vaultの構造マップ。AIツールがフォルダ全体を把握するために使う。

# MANIFEST.md (自動生成)

## Inbox (3 files)
- 2026-04-01_react-server-actions.md
- 2026-04-03_gemini-api-changes.md
- 2026-04-05_copilot-cloud-agent.md

## Projects (2 folders)
- ai-news-site/ (5 files)
- mobile-app/ (3 files)

## Knowledge (4 files)
- git-workflow-best-practices.md
- python-async-patterns.md
- docker-compose-cheatsheet.md
- prompt-engineering-tips.md

Last updated: 2026-04-06T10:00:00Z

# MANIFEST.md 自動生成スクリプト (Bash)
#!/bin/bash
echo "# MANIFEST.md" > MANIFEST.md
echo "" >> MANIFEST.md
for dir in Inbox Projects Knowledge; do
  count=$(find "$dir" -name "*.md" 2>/dev/null | wc -l)
  echo "## $dir ($count files)" >> MANIFEST.md
  find "$dir" -name "*.md" -printf "- %P\n" 2>/dev/null | sort >> MANIFEST.md
  echo "" >> MANIFEST.md
done
echo "Last updated: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> MANIFEST.md

日常ワークフロー

毎日5分のルーティンでナレッジが蓄積される。

実践例: バグ修正で得た知見の保存

# Claude Code での例
You: このバグの原因と対策をInbox/に保存して

# Claude Code が以下のファイルを作成:
# Inbox/2026-04-06_react-hydration-mismatch.md
---
tags: [react, debugging, hydration]
---
# React Hydration Mismatch の原因と対策
## 原因
- サーバー側とクライアント側で異なるデータを参照していた
## 対策
- useEffect 内でクライアント固有の処理を行う
- suppressHydrationWarning は最終手段

Agentfiles プラグイン（推奨）

Obsidian + AI ツールの連携をさらに強化。

インストール方法

1. Obsidian → Settings → Community plugins → Browse
2. 「obsidian-mind」で検索してインストール
3. Enable して Vault ルートを指定

ワークフロー例

ツール横断での具体的な活用パターン。

パターン1: 新技術の調査 → ナレッジ化

パターン2: チーム内ナレッジ共有

パターン3: プロジェクト引き継ぎ