Add minimal HSCF examples and documentation

examples/multi_agent/hscf_examples/README.md

@@ -0,0 +1,5 @@
+# HSCF Examples
+
+This folder contains minimal Hierarchical Structured Communication Framework (HSCF) examples.
+
+- `simple_hscf_example.py`: a very small example with top-level data structures. No prints, no functions.

examples/multi_agent/hscf_examples/__init__.py

@@ -0,0 +1,3 @@
+from .simple_hscf_example import hscf_example
+
+__all__ = ["hscf_example"]

examples/multi_agent/hscf_examples/simple_hscf_example.py

@@ -0,0 +1,19 @@
+# Minimal Hierarchical Structured Communication Framework (HSCF) example
+# Very simple to run: no prints, no functions — just top-level data structures.
+
+agents = [
+    {"id": "leader", "role": "coordinator", "abilities": ["plan", "summarize"]},
+    {"id": "worker1", "role": "executor", "abilities": ["fetch", "analyze"]},
+    {"id": "worker2", "role": "executor", "abilities": ["fetch", "synthesize"]},
+]
+
+messages = [
+    {"from": "leader", "to": "worker1", "content": "task:fetch_data", "priority": 1},
+    {"from": "worker1", "to": "leader", "content": "result:partial_data", "priority": 2},
+]
+
+hscf_example = {
+    "agents": agents,
+    "messages": messages,
+    "meta": {"framework": "hscf", "version": "0.1", "author": "ilum"},
+}