feat(examples): refine flow examples with clean import structure (#51)

Author: keli-wen

examples/flow/01_custom_flow/README.md

@@ -8,6 +8,7 @@ This example demonstrates how to create a simple custom flow using the new Quant
 examples/flow/01_custom_flow/
 ├── flows/
 │   └── greeting_flow/
+│       ├── __init__.py     # Module exports
 │       ├── prompts.yaml    # Prompt templates
 │       └── flow.py         # Flow implementation
 ├── config.yaml             # Flow configuration
@@ -38,6 +39,18 @@ examples/flow/01_custom_flow/
 - Separated from code for easy editing
 - Loaded dynamically
 
+## Easy Import Structure
+
+With the new `__init__.py` files, you can now import flows cleanly:
+
+```python
+# Import from flow directory
+from flows.greeting_flow import GreetingFlow, GreetingFlowConfig
+
+# Use in major pipelines
+flow = GreetingFlow(config)
+```
+
 ## Running the Demo
 
 ```bash

examples/flow/01_custom_flow/flows/greeting_flow/__init__.py

@@ -0,0 +1,5 @@
+"""Greeting flow module."""
+
+from .flow import GreetingFlow, GreetingFlowConfig
+
+__all__ = ["GreetingFlow", "GreetingFlowConfig"]

examples/flow/01_custom_flow/pipeline.py

@@ -4,7 +4,7 @@
 from pathlib import Path
 
 # Import the custom flow
-from flows.greeting_flow.flow import GreetingFlow
+from flows.greeting_flow import GreetingFlow
 from quantmind.config.settings import load_config
 
 

examples/flow/02_summary_flow/README.md

@@ -8,6 +8,7 @@ This example demonstrates the built-in SummaryFlow with custom chunking strategy
 examples/flow/02_summary_flow/
 ├── flows/
 │   └── summary_flow/
+│       ├── __init__.py     # Module exports
 │       ├── prompts.yaml    # Prompt templates
 │       └── flow.py         # Mock LLM implementation (for testing)
 ├── config.yaml             # Flow configuration
@@ -37,6 +38,18 @@ examples/flow/02_summary_flow/
 - Smart provider inference (OpenAI models use `OPENAI_API_KEY`)
 - Secure configuration without hardcoded keys
 
+## Easy Import Structure
+
+With the new `__init__.py` file, you can import the demo flow cleanly:
+
+```python
+# Import from flow directory
+from flows.summary_flow import DemoSummaryFlow
+
+# Use in pipelines
+flow = DemoSummaryFlow(config)
+```
+
 ## Running the Demo
 
 ```bash

examples/flow/02_summary_flow/flows/summary_flow/__init__.py

@@ -0,0 +1,5 @@
+"""Summary flow module."""
+
+from .flow import DemoSummaryFlow
+
+__all__ = ["DemoSummaryFlow"]

examples/flow/README.md

@@ -35,6 +35,7 @@ Both examples showcase the core principles of the new flow architecture:
 3. **Direct Access**: No unnecessary wrapper methods, just direct access to resources
 4. **Template Separation**: Prompts in YAML files for easy editing and maintenance
 5. **Type Safety**: Pydantic-based configuration instead of complex schemas
+6. **Easy Imports**: Each flow directory has `__init__.py` for clean imports (e.g., `from flows.greeting_flow import GreetingFlow`)
 
 ## Quick Start