feat: enhance config loader overview with supported formats

- Add comprehensive introduction explaining configuration loading benefits
- Document native support for Python Dict, JSON, and YAML formats
- Include practical examples for each format type
- Add quick start examples for agent and swarm configurations
- Show migration path from programmatic to configuration-driven approach
- Maintain original feature specification for reference

Author: vawsgit

docs/experimental/config-loader/overview.md

@@ -1,3 +1,166 @@
+# Configuration Loaders Overview
+
+## Introduction
+
+Configuration loaders enable declarative, configuration-driven definition of agents, tools, swarms, and graphs. This approach provides:
+
+- **Version Control**: Track agent configurations alongside code
+- **Environment Management**: Different configs for dev/staging/production
+- **Team Collaboration**: Non-developers can modify agent behavior
+- **Reproducibility**: Consistent agent behavior across deployments
+
+## Supported Configuration Formats
+
+Configuration loaders natively support multiple input formats for maximum flexibility:
+
+### 1. Python Dictionary
+Load configurations directly from Python dictionaries for programmatic use:
+
+```python
+from strands import Agent
+
+config = {
+    "model": "us.amazon.nova-pro-v1:0",
+    "system_prompt": "You are a helpful assistant.",
+    "tools": [{"name": "calculator"}]
+}
+
+agent = Agent(config=config)
+```
+
+### 2. JSON Files
+Load configurations from JSON files for structured data storage:
+
+```python
+# config.json
+{
+    "model": "us.amazon.nova-pro-v1:0",
+    "system_prompt": "You are a helpful assistant.",
+    "tools": [{"name": "calculator"}]
+}
+```
+
+```python
+from strands import Agent
+
+agent = Agent(config="config.json")
+```
+
+### 3. YAML Files
+Load configurations from YAML files for human-readable configuration:
+
+```yaml
+# config.yml
+model: "us.amazon.nova-pro-v1:0"
+system_prompt: "You are a helpful assistant."
+tools:
+  - name: "calculator"
+```
+
+```python
+from strands import Agent
+
+agent = Agent(config="config.yml")
+```
+
+## Configuration Schema
+
+All configuration loaders follow consistent patterns:
+- YAML-first design with JSON and dictionary support
+- Validation and error handling
+- Environment variable substitution
+- External file references
+- Caching and performance optimization
+
+## Supported Configuration Types
+
+### Agent Configuration
+Define individual agents with models, prompts, tools, and behavior settings.
+
+### Tool Configuration  
+Configure tools from Python functions, external modules, or MCP servers.
+
+### Swarm Configuration
+Define multi-agent swarms with specialized roles and coordination patterns.
+
+### Graph Configuration
+Create complex multi-agent workflows with conditional routing and dependencies.
+
+## Quick Start Examples
+
+### Basic Agent Configuration
+
+```yaml
+# agent.yml
+model: "us.amazon.nova-pro-v1:0"
+system_prompt: "You are a helpful customer service agent."
+tools:
+  - "strands_tools.calculator"
+  - "strands_tools.web_search"
+```
+
+```python
+from strands import Agent
+
+# Load agent from YAML file
+agent = Agent(config='agent.yml')
+response = agent("Help me calculate my order total")
+```
+
+### Multi-Agent Swarm Configuration
+
+```yaml
+# swarm.yml
+max_handoffs: 20
+agents:
+  - name: "research_agent"
+    model: "us.amazon.nova-lite-v1:0"
+    system_prompt: "You are a research specialist."
+  - name: "creative_agent"
+    model: "us.amazon.nova-lite-v1:0"
+    system_prompt: "You are a creative solution generator."
+```
+
+```python
+from strands.multiagent import Swarm
+
+# Load swarm from YAML file
+swarm = Swarm(config='swarm.yml')
+result = swarm("Create a blog post about AI")
+```
+
+## Migration from Programmatic Approach
+
+### Before (Programmatic)
+```python
+from strands import Agent
+from strands_tools import calculator, web_search
+
+agent = Agent(
+    model="us.amazon.nova-pro-v1:0",
+    system_prompt="You are a helpful assistant.",
+    tools=[calculator, web_search]
+)
+```
+
+### After (Configuration-Driven)
+```yaml
+# agent.yml
+model: "us.amazon.nova-pro-v1:0"
+system_prompt: "You are a helpful assistant."
+tools:
+  - "strands_tools.calculator"
+  - "strands_tools.web_search"
+```
+
+```python
+from strands import Agent
+
+agent = Agent(config='agent.yml')
+```
+
+---
+
 # FEATURE: Config Loaders
 
 [FEATURE Load Agentic Configurations from a Dictionary \#606](https://github.com/strands-agents/sdk-python/issues/606)