From 898b52edcb47bcb3e9d6106e74ca73e74ea01e70 Mon Sep 17 00:00:00 2001
From: sillylaird <sillyfanboy@gmail.com>
Date: Thu, 3 Sep 2026 00:33:59 +0000
Subject: import live www.sillylaird.ca webroot

---
 .../references/factory_pattern.md                  | 53 ++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 .agents/skills/architecture-design/references/factory_pattern.md

(limited to '.agents/skills/architecture-design/references/factory_pattern.md')

diff --git a/.agents/skills/architecture-design/references/factory_pattern.md b/.agents/skills/architecture-design/references/factory_pattern.md
new file mode 100644
index 0000000..f700dd4
--- /dev/null
+++ b/.agents/skills/architecture-design/references/factory_pattern.md
@@ -0,0 +1,53 @@
+# Factory Pattern
+
+## Overview
+
+The Factory pattern allows dynamic creation of instances without specifying the exact class. Each module uses a factory to decouple creation from usage.
+
+## Structure
+
+```python
+# In module __init__.py (e.g., data_module/dataset/__init__.py)
+DATASET_FACTORY: Dict[str, type] = {}
+
+def DatasetFactory(data_name: str):
+    """Create dataset instance by name."""
+    dataset = DATASET_FACTORY.get(data_name, None)
+    if dataset is None:
+        # Fallback to default
+        dataset = DATASET_FACTORY.get('simple')
+    return dataset
+```
+
+## Usage
+
+```python
+# Consumer code doesn't need to know concrete class
+dataset = DatasetFactory(cfg.dataset.name)
+```
+
+## Benefits
+
+- **Loose coupling**: Consumer doesn't import concrete classes
+- **Extensibility**: Add new types without changing consumer code
+- **Fallback handling**: Graceful degradation for unknown types
+- **Centralized registry**: Single source of truth for available types
+
+## Implementation Details
+
+1. Define factory dict at module level
+2. Factory function handles lookup and fallback
+3. Return class (not instance) for deferred initialization
+4. None result triggers fallback to default implementation
+
+## Common Patterns
+
+```python
+# With config integration
+def DatasetFactory(cfg):
+    data_name = cfg.dataset.name
+    dataset_cls = DATASET_FACTORY.get(data_name)
+    if dataset_cls is None:
+        raise ValueError(f"Unknown dataset: {data_name}")
+    return dataset_cls(cfg)
+```
-- 
cgit v1.2.3