GitHub リポジトリを AI に読ませるなら「階層構造 + index.md」と「Obsidian 形式」どちらが速く・安く・正確か
Hiroba による自動要約
Claude Code などのエージェント型 AI とベクトル検索型 RAG では、最適なドキュメント構造が異なる。エージェント探索なら階層構造 + index.md が速く安く迷いにくく、RAG ではメタデータとしてのタグが有効。両者の仕組みと使い分けを具体例・コスト試算・比較表で解説。
読んで良かったら、シェアしてみてください。
同じタグの記事が他に 2095 件あります。
関連する記事
同じタグの記事
AI駆動開発におけるハーネスエンジニアリング完全ガイド
ZennAI駆動開発でのチーム開発は指示の出し方がばらつき、設計規約が守られず、レビューコストが増加する課題を抱えている。これらを解決するため、Claude Codeの指示方法（CLAUDE.md、rules、skills等）を体系化する「ハーネスエンジニアリング」を導入し、AI が安全に開発できる環境を整備する手法を紹介。
Claude Code に「同じ指摘を二度させない」仕組みを作る — 失敗台帳と patch/process 判定の自己改善ループ
ZennClaude Code との対話で同じ修正を繰り返し指摘する問題に対し、セッションログから指摘を抽出し失敗台帳で再発を追跡するスキルを開発。再発 2 回以上は注意書き追記 (patch) を禁止し、根本的な構造修正 (process) を起案する閾値ルールで、指摘の蒸発を防ぎ人間が反映を最終承認するゲートを設ける設計。
Claude Codeのプランモードを使わない開発は非効率——Explore→Plan→Implement→Verify→Commitフローの重要性
QiitaClaude Codeを単なる実装ツールとして使うのではなく、調査（Explore）→計画（Plan）→実装（Implement）→検証（Verify）→コミット（Commit）の5ステップで段階的に活用すべき。特にプランモード（shift+tab）で実装前に設計・影響範囲・テスト方針を明確にすることで、スコープ膨張やレビュー負荷を軽減できる。
Claude Code ハーネスエンジニアリング完全ガイド
QiitaClaude Code を業務継続利用する際の出力のブレ・長文会話での品質低下・トークンコスト膨張に対して、プロンプト改善ではなく AI が動作する「環境」全体を体系的に設計するアプローチ「ハーネスエンジニアリング」を解説。CLAUDE.md・ペルソナ・サブエージェント委譲・トークン管理・Loop・Claude Design連携といった構成要素を組み合わせ、安定した品質と効率性を実現する方法を提示。