diff --git a/README.md b/README.md
index a58dd33a..7c29a4cb 100644
--- a/README.md
+++ b/README.md
@@ -162,6 +162,14 @@ The A2A agent provides:
 - Source citations with titles and URIs
 - Full document retrieval on request
 
+## Examples
+
+See the [examples directory](examples/) for working examples:
+
+- **[Interactive Research Assistant](examples/ag-ui-research/)** - Full-stack research assistant with Pydantic AI and AG-UI featuring human-in-the-loop approval and real-time state synchronization
+- **[Docker Setup](examples/docker/)** - Complete Docker deployment with file monitoring, MCP server, and A2A agent
+- **[A2A Security](examples/a2a-security/)** - Authentication examples (API key, OAuth2, GitHub)
+
 ## Documentation
 
 Full documentation at: https://ggozad.github.io/haiku.rag/
diff --git a/docs/agents.md b/docs/agents.md
index 9e9c5372..649e128a 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -6,6 +6,8 @@ Three agentic flows are provided by haiku.rag:
 - Deep QA Agent — multi-agent question decomposition for complex questions
 - Research Multi‑Agent — a multi‑step, analyzable research workflow
 
+For an interactive example using Pydantic AI and AG-UI, see the [Interactive Research Assistant](https://github.com/ggozad/haiku.rag/tree/main/examples/ag-ui-research) example.
+
 
 ### Simple QA Agent
 
diff --git a/examples/README.md b/examples/README.md
index e3e3d7f0..c5b99941 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -2,6 +2,19 @@
 
 This directory contains example scripts demonstrating various features of haiku.rag.
 
+## Interactive Research Assistant
+
+**Directory:** `ag-ui-research/`
+
+Full-stack research assistant with interactive UI powered by Pydantic AI and AG-UI:
+- Multi-step research workflow with question decomposition
+- Human-in-the-loop approval for research plans
+- Real-time state synchronization between backend and frontend
+- Context expansion and insight extraction
+- Structured research reports with citations
+
+See `ag-ui-research/README.md` for setup instructions.
+
 ## Docker Example
 
 **Directory:** `docker/`