docs: 教材化プロジェクト - Config層独立性の整合性修正

- DESIGN_DECISIONS.md: レイヤー構造図を4層+Config層（完全独立）に分離
- LEARNING_PATH.md: Config層の独立性を学習ポイントとして追記
- scripts/README.md: 依存関係ルールをARCHITECTURE.mdと整合

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

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

Author: web-flow

EpisodicRAG/docs/dev/DESIGN_DECISIONS.md

@@ -80,6 +80,8 @@
 
 ## レイヤー構造
 
+### Clean Architecture 4層
+
 ```
 ┌─────────────────────────────────────────────────────────┐
 │                    Interfaces Layer                      │
@@ -100,19 +102,27 @@
 └─────────────────────────────────────────────────────────┘
                           ↓ 依存
 ┌─────────────────────────────────────────────────────────┐
-│                      Config Layer                        │
-│  (facade.py, threshold_provider.py, path_resolver.py)   │
-│  設定管理、パス解決                                       │
-└─────────────────────────────────────────────────────────┘
-                          ↓ 依存
-┌─────────────────────────────────────────────────────────┐
 │                      Domain Layer                        │
 │  (types.py, constants.py, exceptions.py, protocols.py)  │
 │  ビジネスルール、型定義、例外（外部依存なし）                │
 └─────────────────────────────────────────────────────────┘
 ```
 
-**重要な制約**: 依存は常に下方向のみ。上位層が下位層に依存し、逆は許可されない。
+### Config層（完全独立）
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                      Config Layer                        │
+│  (facade.py, threshold_provider.py, path_resolver.py)   │
+│  設定管理、パス解決                                       │
+│  ※ 4層とは独立 - domain/を含む全層に依存しない             │
+└─────────────────────────────────────────────────────────┘
+```
+
+**重要な制約**:
+- 4層は常に下方向のみ依存。上位層が下位層に依存し、逆は許可されない
+- Config層は**完全独立**であり、domain/を含むすべての層に依存しない
+- 詳細: [ARCHITECTURE.md](ARCHITECTURE.md#clean-architecture)
 
 ---
 

EpisodicRAG/docs/dev/LEARNING_PATH.md

@@ -8,7 +8,7 @@
 
 ## このプロジェクトで学べること
 
-### 1. Clean Architecture（4層構造）
+### 1. Clean Architecture（4層構造 + Config層）
 
 EpisodicRAGは依存関係ルールに基づく4層構造を採用しています。
 
@@ -18,12 +18,21 @@ EpisodicRAGは依存関係ルールに基づく4層構造を採用していま
 | Infrastructure | `scripts/infrastructure/` | 外部I/Oの抽象化（JSON、ファイル、ログ） |
 | Application | `scripts/application/` | ユースケースの実装 |
 | Interfaces | `scripts/interfaces/` | エントリーポイント |
+| **Config** | `scripts/config/` | **完全独立** - 設定管理、パス解決 |
 
 **学習ポイント**:
 - `scripts/domain/` を読む → 外部依存のない純粋な定義を理解
 - `scripts/application/` を読む → 依存関係ルールの実践を確認
 - 参照: [ARCHITECTURE.md](ARCHITECTURE.md#clean-architecture)
 
+> ⚠️ **Config層の独立性**（重要な学習ポイント）
+>
+> Config層は4層とは別に**完全独立**しており、domain/を含む全層に依存しません。
+> これはプラグインとして単独ロード可能にするための設計判断です。
+> 「なぜ独立させるか」を学ぶことで、アーキテクチャ判断の実践例を理解できます。
+>
+> 参照: [ARCHITECTURE.md](ARCHITECTURE.md#clean-architecture)
+
 ### 2. Single Source of Truth (SSoT)
 
 情報の重複を避け、一元管理する原則を徹底しています。

EpisodicRAG/scripts/README.md

@@ -36,16 +36,19 @@ domain/           ← 何にも依存しない（純粋なビジネスロジッ
     ↑
 infrastructure/   ← domain/ のみ
     ↑
-config/           ← domain/ + infrastructure/（設定管理層）
-    ↑
-application/      ← domain/ + infrastructure/ + config/
+application/      ← domain/ + infrastructure/
     ↑
 interfaces/       ← application/
+
+config/           ← 何にも依存しない（完全独立）
 ```
 
-> **Note**: `config/` 層は設定管理を担当し、`DigestConfig` クラスやパス解決、
-> 閾値管理などを提供します。`application/` 層が設定にアクセスする際は
-> この層を経由します。
+> ⚠️ **CRITICAL: Config層の独立性**
+>
+> `config/` パッケージは **domain/ を含む他のすべての層から完全に独立** しています。
+> これは `digest-config` スキルがClaudeプラグインとして単独でロード可能である必要があるためです。
+>
+> 詳細: [ARCHITECTURE.md](../docs/dev/ARCHITECTURE.md#clean-architecture)
 
 ---
 

EpisodicRAG/scripts/application/shadow/cascade_processor.py

@@ -47,7 +47,7 @@
 
 from domain.types import LevelHierarchyEntry, OverallDigestData
 from domain.validators import is_valid_overall_digest
-from infrastructure import get_structured_logger, log_info
+from infrastructure import get_structured_logger
 
 # 構造化ロガー
 _logger = get_structured_logger(__name__)
@@ -111,7 +111,7 @@ def get_shadow_digest_for_level(self, level: str) -> Optional[OverallDigestData]
         """
         指定レベルのShadowダイジェストを取得
 
-        finalize_from_shadow.pyで使用: これがRegularDigestの内容になります
+        finalize_from_shadow.pyで使用: ShadowGrandDigestからoverall_digestを取得
 
         Args:
             level: レベル名
@@ -128,7 +128,7 @@ def get_shadow_digest_for_level(self, level: str) -> Optional[OverallDigestData]
         )
 
         if not is_valid_overall_digest(overall_digest):
-            log_info(f"No shadow digest for level: {level}")
+            _logger.info(f"No shadow digest for level: {level}")
             return None
 
         # is_valid_overall_digest は TypeGuard なので、
@@ -149,11 +149,11 @@ def promote_shadow_to_grand(self, level: str) -> None:
         digest = self.get_shadow_digest_for_level(level)
 
         if not digest:
-            log_info(f"No shadow digest to promote for level: {level}")
+            _logger.info(f"No shadow digest to promote for level: {level}")
             return
 
         file_count = len(digest.get("source_files", []))
-        log_info(f"Shadow digest ready for promotion: {file_count} file(s)")
+        _logger.info(f"Shadow digest ready for promotion: {file_count} file(s)")
         # 実際の昇格処理はfinalize_from_shadow.pyで実行される
 
     def clear_shadow_level(self, level: str) -> None:
@@ -171,7 +171,7 @@ def clear_shadow_level(self, level: str) -> None:
         )
 
         self.shadow_io.save(shadow_data)
-        log_info(f"Cleared ShadowGrandDigest for level: {level}")
+        _logger.info(f"Cleared ShadowGrandDigest for level: {level}")
 
     def cascade_update_on_digest_finalize(self, level: str) -> None:
         """
@@ -186,7 +186,7 @@ def cascade_update_on_digest_finalize(self, level: str) -> None:
         Args:
             level: レベル名
         """
-        log_info(f"[Step 3] ShadowGrandDigest cascade for level: {level}")
+        _logger.info(f"[Step 3] ShadowGrandDigest cascade for level: {level}")
         _logger.state("cascade_update", starting_for_level=level)
 
         # 1. Shadow → Grand 昇格の確認
@@ -201,17 +201,17 @@ def cascade_update_on_digest_finalize(self, level: str) -> None:
             _logger.file_op(f"find_new_files({next_level})", found=len(new_files))
 
             if new_files:
-                log_info(f"Found {len(new_files)} new file(s) for {next_level}:")
+                _logger.info(f"Found {len(new_files)} new file(s) for {next_level}:")
                 file_names = [f.name for f in new_files[:5]]
                 suffix = "..." if len(new_files) > 5 else ""
                 _logger.file_op("new_files", names=f"{file_names}{suffix}")
 
                 # 3. 次のレベルのShadowに増分追加
                 self.file_appender.add_files_to_shadow(next_level, new_files)
         else:
-            log_info(f"No next level for {level} (top level)")
+            _logger.info(f"No next level for {level} (top level)")
 
         # 4. 現在のレベルのShadowをクリア
         self.clear_shadow_level(level)
 
-        log_info(f"[Step 3] Cascade completed for level: {level}")
+        _logger.info(f"[Step 3] Cascade completed for level: {level}")

EpisodicRAG/scripts/application/shadow/file_detector.py

@@ -89,8 +89,5 @@ def find_new_files(self, level: str) -> List[Path]:
             # 初回は全ファイルを検出
             return all_files
 
-        # max_file_number is already int (from DigestTimesData)
-        max_num = max_file_number
-
         # 統一関数を使用してフィルタリング
-        return filter_files_after(all_files, max_num)
+        return filter_files_after(all_files, max_file_number)

EpisodicRAG/scripts/application/validators.py

@@ -27,6 +27,16 @@
 # =============================================================================
 # 公開API（後方互換性維持）
 # =============================================================================
+#
+# NOTE: これらの関数はdomain層の検証関数への薄いラッパーです。
+# domain.validation および domain.validators に直接アクセスすることも可能ですが、
+# 既存コードとの後方互換性を維持するためにこのモジュールを提供しています。
+#
+# 新規コードでは、用途に応じて以下を直接使用することを推奨:
+#   - domain.validation.validate_type() - 型検証（例外を投げる）
+#   - domain.validators.is_valid_type() - 型チェック（boolを返す）
+#   - domain.validators.get_or_default() - デフォルト値付き取得
+#
 
 
 def validate_dict(data: Any, context: str) -> Dict[str, Any]: