📚 Entity-Relation Based Documentation

Version: 2.0.0
Last Updated: 2025-11-22
Priority: ⭐⭐⭐ (P2 Level)
Purpose: Miyabi Entity-Relationモデルに基づくドキュメント自動生成

---

📋 概要

Miyabiの14エンティティ・39リレーションモデルに基づいた
ドキュメント生成、Mermaidダイアグラム作成を提供します。

---

🎯 P0: 呼び出しトリガー

トリガー	例
ドキュメント化	"document this feature"
アーキテクチャ	"update the architecture docs"
説明	"explain how X works"
新機能後	"after implementing new features"

---

🔧 P1: Entity-Relationモデル

14 Entities

Entity	説明	関連数
Issue	GitHub Issue	8
Task	分解されたタスク	6
Agent	実行Agent	7
PR	Pull Request	4
Label	ラベル	5
QualityReport	品質レポート	3
Command	CLIコマンド	2
Escalation	エスカレーション	3
Deployment	デプロイメント	3
LDDLog	学習ログ	2
DAG	タスクグラフ	4
Worktree	Git Worktree	4
DiscordCommunity	Discordコミュニティ	4
SubIssue	サブIssue	3

39 Relations（カテゴリ別）

カテゴリ	Relations	数
Issue処理	R1-R4	4
Agent実行	R9-R15	7
ラベル制御	R16-R18	3
品質管理	R19-R23	5
並列実行	R24-R27	4
コミュニティ	R28-R35	8
階層	R36-R39	4
その他	R5-R8	4

---

🚀 P2: ドキュメントパターン

Pattern 1: 機能ドキュメント

# [機能名]

## 概要
[1-2文で説明]

## Entity関係
- 主要Entity: [Entity名]
- 関連Entity: [Entity1], [Entity2]
- 使用Relations: R1, R9, R16

## 実装ファイル
- `crates/miyabi-xxx/src/lib.rs`
- `crates/miyabi-xxx/src/feature.rs`

## 使用方法
[コード例]

## 関連ドキュメント
- [リンク1]
- [リンク2]

Pattern 2: Mermaidダイアグラム

graph TD
    Issue[Issue] -->|R1| Task[Task]
    Task -->|R9| Agent[Agent]
    Agent -->|R12| PR[PR]
    Agent -->|R19| QualityReport[QualityReport]

Pattern 3: アーキテクチャドキュメント

# [コンポーネント名] Architecture

## レイヤー構造

[ASCII図]

## データフロー
[Mermaid sequence diagram]

## 依存関係
[依存グラフ]

---

⚡ P3: 自動生成ワークフロー

Step 1: Entity特定

# コードからEntity参照を抽出
grep -r "Issue\|Task\|Agent" crates/

Step 2: Relation特定

# 関係性パターンを検出
# creates, updates, triggers, etc.

Step 3: ドキュメント生成

自動生成セクション:
- [ ] 概要
- [ ] Entity関係図
- [ ] ファイルマッピング
- [ ] API リファレンス
- [ ] 使用例

---

✅ 成功基準

チェック項目	基準
Entity特定	関連Entity全て
Relation特定	使用Relation全て
ダイアグラム	Mermaid生成
ファイルマッピング	実装ファイル紐付け
例示	コード例含む

---

🔗 関連ドキュメント

ドキュメント	用途
docs/ENTITY_RELATION_MODEL.md	ERモデル詳細
context/miyabi-definition.md	定義一覧
docs/TEMPLATE_MASTER_INDEX.md	テンプレート

---

📝 関連Skills

• Rust Development: 実装コード確認
• Issue Analysis: Issue分析結果
• Git Workflow: 変更履歴参照