概要
現在のナレッジグラフはIssue番号ベースのファイル名パースに依存しており、Issue未使用のプロジェクトでは活用できない。Issue番号以外のグルーピング軸への対応を検討する。
背景
現在のノード抽出:
dev-reports/design/issue-{NUMBER}-*.md → Issue + document + has_design
dev-reports/issue/{NUMBER}/ → Issue + document + has_workplan/has_review
Issue番号がファイル名・パスに含まれないプロジェクトではナレッジグラフが空になる。
対応案
案1: frontmatterベースの関連付け
---
tags: [authentication, security]
related: [design-policy-auth.md]
---
frontmatterのtags/relatedフィールドからノードとエッジを生成。
案2: ディレクトリ構造ベースの関連付け
docs/
├── auth/
│ ├── design.md
│ ├── review.md
│ └── notes.md
同一ディレクトリ内のファイルを自動的に関連付け。既存のDirectoryProximityの拡張。
案3: マークダウンリンクの双方向関連付け
[参考](./other-doc.md) のリンクから双方向エッジを生成。既存のfile_linksテーブルをナレッジグラフに統合。
案4: ファイル名プレフィックスベース
auth-design-policy.md
auth-security-review.md
auth-implementation-notes.md
共通プレフィックスを持つファイルをグルーピング。
優先度
中。現在はCommandMate(Issue駆動開発)が主な利用先であり、Issue番号ベースで機能する。他プロジェクトへの展開時に必要になる。
関連
概要
現在のナレッジグラフはIssue番号ベースのファイル名パースに依存しており、Issue未使用のプロジェクトでは活用できない。Issue番号以外のグルーピング軸への対応を検討する。
背景
現在のノード抽出:
dev-reports/design/issue-{NUMBER}-*.md→ Issue + document + has_designdev-reports/issue/{NUMBER}/→ Issue + document + has_workplan/has_reviewIssue番号がファイル名・パスに含まれないプロジェクトではナレッジグラフが空になる。
対応案
案1: frontmatterベースの関連付け
frontmatterのtags/relatedフィールドからノードとエッジを生成。
案2: ディレクトリ構造ベースの関連付け
同一ディレクトリ内のファイルを自動的に関連付け。既存のDirectoryProximityの拡張。
案3: マークダウンリンクの双方向関連付け
[参考](./other-doc.md)のリンクから双方向エッジを生成。既存のfile_linksテーブルをナレッジグラフに統合。案4: ファイル名プレフィックスベース
共通プレフィックスを持つファイルをグルーピング。
優先度
中。現在はCommandMate(Issue駆動開発)が主な利用先であり、Issue番号ベースで機能する。他プロジェクトへの展開時に必要になる。
関連