docs: improve navigation and add CI/coverage badges

- Add breadcrumb navigation with root link to all docs
- Add terminology index to glossary (JP/EN)
- Add CI and Codecov badges to README (JP/EN)
- Add version badge to AI Spec Hub
- Expand API reference with detailed method docs
- Sync English documentation with Japanese updates

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: web-flow

EpisodicRAG/README.en.md

@@ -336,6 +336,27 @@ Examples: 2025-07-01_W0001_CognitiveArchitecture.txt
 
 ---
 
+## Terminology Index
+
+| Term | Section |
+|------|---------|
+| base_dir | [Basic Concepts](#base_dir) |
+| Cascade | [8-Layer Hierarchy](#hierarchical-cascade) |
+| Digest | [Basic Concepts](#digest) |
+| Essences | [Basic Concepts](#essences) |
+| GrandDigest | [Memory Structure](#granddigest) |
+| Loop | [Basic Concepts](#loop) |
+| Mottled Memory | [Processes & Operations](#mottled-memory-まだらボケ) |
+| paths | [Basic Concepts](#paths) |
+| Placeholder | [Processes & Operations](#placeholder) |
+| plugin_root | [Basic Concepts](#plugin_root) |
+| Provisional Digest | [Memory Structure](#provisional-digest) |
+| Regular Digest | [Memory Structure](#regular-digest) |
+| ShadowGrandDigest | [Memory Structure](#shadowgranddigest) |
+| Threshold | [Processes & Operations](#threshold) |
+
+---
+
 ## Related Documents
 
 - [Main README](../README.md) - Project Overview

EpisodicRAG/README.md

@@ -336,6 +336,27 @@ L00001追加 → `/digest`せず → L00002追加
 
 ---
 
+## 用語インデックス
+
+| 用語 | セクション |
+|------|----------|
+| base_dir | [基本概念](#base_dir) |
+| Cascade | [8階層構造](#階層的カスケード) |
+| Digest | [基本概念](#digest) |
+| Essences | [基本概念](#essences) |
+| GrandDigest | [記憶構造](#granddigest) |
+| Loop | [基本概念](#loop) |
+| paths | [基本概念](#paths) |
+| Placeholder | [プロセス・操作](#プレースホルダー) |
+| plugin_root | [基本概念](#plugin_root) |
+| Provisional Digest | [記憶構造](#provisional-digest) |
+| Regular Digest | [記憶構造](#regular-digest) |
+| ShadowGrandDigest | [記憶構造](#shadowgranddigest) |
+| Threshold | [プロセス・操作](#threshold閾値) |
+| まだらボケ | [プロセス・操作](#まだらボケ) |
+
+---
+
 ## 関連ドキュメント
 
 - [メインREADME](../README.md) - プロジェクト概要

EpisodicRAG/docs/README.md

@@ -1,5 +1,7 @@
 # EpisodicRAG AI Specification Hub
 
+[![Version](https://img.shields.io/badge/version-3.0.0-blue.svg)](https://github.com/Bizuayeu/Plugins-Weave)
+
 AI/Claudeエージェント向けの技術仕様ハブです。
 
 > 📖 **ユーザー向けドキュメント**は [プロジェクト README](../../README.md) を参照してください。

EpisodicRAG/docs/dev/API_REFERENCE.md

@@ -1,4 +1,4 @@
-[Docs](../README.md) > API_REFERENCE
+[EpisodicRAG](../../README.md) > [Docs](../README.md) > API_REFERENCE
 
 # API リファレンス
 

EpisodicRAG/docs/dev/ARCHITECTURE.md

@@ -1,4 +1,4 @@
-[Docs](../README.md) > ARCHITECTURE
+[EpisodicRAG](../../README.md) > [Docs](../README.md) > ARCHITECTURE
 
 # Architecture - EpisodicRAG Plugin
 

EpisodicRAG/docs/dev/ERROR_RECOVERY_PATTERNS.md

@@ -1,3 +1,5 @@
+[EpisodicRAG](../../README.md) > [Docs](../README.md) > ERROR_RECOVERY_PATTERNS
+
 # エラーリカバリーパターン
 
 EpisodicRAGプラグインで使用されているエラーハンドリングと

EpisodicRAG/docs/dev/api/application.md

@@ -1,9 +1,11 @@
-[API Reference](../API_REFERENCE.md) > Application層
+[EpisodicRAG](../../../README.md) > [Docs](../../README.md) > [API](../API_REFERENCE.md) > Application
 
 # Application層 API
 
 ビジネスロジックの実装。
 
+> 📖 用語・共通概念は [用語集](../../../README.md) を参照
+
 ```python
 from application.shadow import ShadowTemplate, ShadowUpdater
 from application.grand import GrandDigestManager, ShadowGrandDigestManager
@@ -208,10 +210,77 @@ class ShadowUpdater:
 
 ## GrandDigest管理（application/grand/）
 
-| クラス | 説明 |
-|--------|------|
-| `GrandDigestManager` | GrandDigest.txt CRUD操作 |
-| `ShadowGrandDigestManager` | ShadowGrandDigest.txt管理 |
+### GrandDigestManager
+
+GrandDigest.txt の CRUD操作を担当。
+
+```python
+class GrandDigestManager:
+    def __init__(self, config: DigestConfig): ...
+```
+
+| メソッド | 説明 | 例外 |
+|---------|------|------|
+| `get_template() -> GrandDigestData` | テンプレート生成（全8レベル対応） | - |
+| `load_or_create() -> GrandDigestData` | 読み込みまたは新規作成 | `FileIOError` |
+| `save(data: GrandDigestData) -> None` | GrandDigest.txtを保存 | `FileIOError` |
+| `update_digest(level, digest_name, overall_digest) -> None` | 指定レベルのダイジェスト更新 | `DigestError` |
+
+**使用例**:
+
+```python
+from application.grand import GrandDigestManager
+from config import DigestConfig
+
+config = DigestConfig()
+manager = GrandDigestManager(config)
+
+# テンプレート取得
+template = manager.get_template()
+
+# 読み込みまたは作成
+data = manager.load_or_create()
+
+# ダイジェスト更新
+manager.update_digest("weekly", "W0001_タイトル", overall_digest_data)
+```
+
+### ShadowGrandDigestManager
+
+ShadowGrandDigest.txt 管理のFacade。Shadow更新・カスケード処理を統括。
+
+```python
+class ShadowGrandDigestManager:
+    def __init__(self, config: Optional[DigestConfig] = None): ...
+```
+
+| メソッド | 説明 |
+|---------|------|
+| `add_files_to_shadow(level, new_files) -> None` | Shadowに新規ファイル追加（増分更新） |
+| `clear_shadow_level(level) -> None` | 指定レベルのShadow初期化 |
+| `get_shadow_digest_for_level(level) -> Optional[OverallDigestData]` | Shadowダイジェスト取得 |
+| `promote_shadow_to_grand(level) -> None` | Shadow→Grand昇格 |
+| `update_shadow_for_new_loops() -> None` | 新規Loop検出→weekly Shadow更新 |
+| `cascade_update_on_digest_finalize(level) -> None` | 確定時カスケード処理 |
+
+**使用例**:
+
+```python
+from application.grand import ShadowGrandDigestManager
+from config import DigestConfig
+
+config = DigestConfig()
+manager = ShadowGrandDigestManager(config)
+
+# 新しいLoopファイルを検出してShadowを更新
+manager.update_shadow_for_new_loops()
+
+# Weeklyダイジェスト確定時のカスケード処理
+manager.cascade_update_on_digest_finalize("weekly")
+
+# 指定レベルのShadowダイジェストを取得
+shadow = manager.get_shadow_digest_for_level("weekly")
+```
 
 ---
 

EpisodicRAG/docs/dev/api/config.md

@@ -1,4 +1,4 @@
-[API Reference](../API_REFERENCE.md) > 設定・Config
+[EpisodicRAG](../../../README.md) > [Docs](../../README.md) > [API](../API_REFERENCE.md) > Config
 
 # 設定 API
 

EpisodicRAG/docs/dev/api/domain.md

@@ -1,9 +1,11 @@
-[API Reference](../API_REFERENCE.md) > Domain層
+[EpisodicRAG](../../../README.md) > [Docs](../../README.md) > [API](../API_REFERENCE.md) > Domain
 
 # Domain層 API
 
 コアビジネスロジック。外部に依存しない純粋な定義。
 
+> 📖 用語・共通概念は [用語集](../../../README.md) を参照
+
 ```python
 from domain import (
     # 定数
@@ -323,4 +325,79 @@ LEVEL_CONFIGから階層関係（source/next）を抽出した辞書を構築。
 
 ---
 
+## エラーフォーマット（domain/error_formatter.py）
+
+エラーメッセージの標準化を担当。一貫したパス表記、コンテキスト情報、メッセージフォーマットを提供。
+
+### ErrorFormatter
+
+```python
+class ErrorFormatter:
+    def __init__(self, project_root: Path): ...
+```
+
+| メソッド | 説明 |
+|---------|------|
+| `format_path(path)` | パスを相対パスに正規化 |
+
+#### Level/Config エラー
+
+| メソッド | 説明 |
+|---------|------|
+| `invalid_level(level, valid_levels)` | 無効レベルエラー |
+| `unknown_level(level)` | 不明レベルエラー（`invalid_level`のエイリアス） |
+| `config_key_missing(key)` | 設定キー欠落エラー |
+| `config_invalid_value(key, expected, actual)` | 設定値不正エラー |
+| `config_section_missing(section)` | 設定セクション欠落エラー |
+
+#### File I/O エラー
+
+| メソッド | 説明 |
+|---------|------|
+| `file_not_found(path)` | ファイル未検出エラー |
+| `file_already_exists(path)` | ファイル既存エラー |
+| `file_io_error(operation, path, error)` | ファイルI/Oエラー |
+| `directory_not_found(path)` | ディレクトリ未検出エラー |
+| `directory_creation_failed(path, error)` | ディレクトリ作成失敗エラー |
+| `invalid_json(path, error)` | JSON不正エラー |
+
+#### Validation エラー
+
+| メソッド | 説明 |
+|---------|------|
+| `invalid_type(context, expected, actual)` | 型不正エラー |
+| `validation_error(field, reason, value)` | バリデーションエラー |
+| `empty_collection(context)` | 空コレクションエラー |
+
+#### Digest固有エラー
+
+| メソッド | 説明 |
+|---------|------|
+| `digest_not_found(level, identifier)` | ダイジェスト未検出エラー |
+| `shadow_empty(level)` | Shadow空エラー |
+| `cascade_error(from_level, to_level, reason)` | カスケードエラー |
+| `initialization_failed(component, error)` | 初期化失敗エラー |
+
+### ファクトリ関数
+
+```python
+def get_error_formatter(project_root: Optional[Path] = None) -> ErrorFormatter
+def reset_error_formatter() -> None  # テスト用リセット
+```
+
+**使用例**:
+
+```python
+from domain.error_formatter import get_error_formatter
+
+formatter = get_error_formatter()
+msg = formatter.file_not_found(Path("/path/to/file.txt"))
+# -> "File not found: path/to/file.txt"
+
+msg = formatter.invalid_level("xyz", ["weekly", "monthly"])
+# -> "Invalid level: 'xyz'. Valid levels: weekly, monthly"
+```
+
+---
+
 **EpisodicRAG** by Weave | [GitHub](https://github.com/Bizuayeu/Plugins-Weave)

EpisodicRAG/docs/dev/api/infrastructure.md

@@ -1,9 +1,11 @@
-[API Reference](../API_REFERENCE.md) > Infrastructure層
+[EpisodicRAG](../../../README.md) > [Docs](../../README.md) > [API](../API_REFERENCE.md) > Infrastructure
 
 # Infrastructure層 API
 
 外部関心事（ファイルI/O、ロギング）。
 
+> 📖 用語・共通概念は [用語集](../../../README.md) を参照
+
 ```python
 from infrastructure import load_json, save_json, log_info, log_error
 from infrastructure.file_scanner import scan_files, get_max_numbered_file