AIにGitHubリポジトリを認識させるなら「階層構造＋index.md」と「Obsidian形式」どっちが速くて安くて正確か

はじめに 「ドキュメントやナレッジをAIに読ませたい」というニーズが一気に増えました。Claude Code のようなエージェントにリポジトリを丸ごと渡す、RAG の知識ベースとして食わせる、社内 Wiki をそのまま参照させる——用途はさまざまですが、そこで必ず出てくる問いがあります。 ディレクトリがきれいに整理されていて index.md もあるリポジトリと、Obsidian のようにタグ付けされたフラットな Markdown 群。AIにとって、どっちが「速く・安く・正確に」contextを認識できるのか？ 結論から先に書きます。 AIエージェントに「探索」させるなら → 階層構造＋index.md が有利（速い・安い・迷いにくい） RAG（ベクトル検索）で「引っ張る」なら → タグ（メタデータ）は強力な武器になる ベストは両取り：ディレクトリで構造を、frontmatterのタグでメ

[otchy210]

AI 臭さが前面に出てる文章は内容の如何に関わらず読む気が起きなくなる現象にそろそろ名前が欲しい。自分で AI に聞いた時は読んでるのにね。「どうせ聞けば分かる」と分かるからこそ読む気が無くなるのかも。

[kijtra]

はじめに→なぜ→方法→まとめ　という文書構成はどれもAI生成記事に思えてしまうようになってしまった

[north_korea]

「光る」という表現はAIしかしないからこれはAIが書いてる

[hoge_hoge_123]

Obsidian = フラット構造だっけ？自分の使ってるObsidianと違うやつなのか、出だしで違和感あって頭に入ってこないな

[yarumato]

“RAG（ベクトル検索）で検索するなら、タグ（メタデータ）は強力な武器になる。ベストは両取り：ディレクトリで構造を、frontmatterのタグでメタデータを持たせる”