From abe1ade3f4face067401961803819dab55e952c6 Mon Sep 17 00:00:00 2001
From: Hayden <154503486+groupthinking@users.noreply.github.com>
Date: Wed, 9 Jul 2025 18:47:09 -0500
Subject: [PATCH] docs: improve README usage

---
 README.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1f8a99a..f0483d5 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,22 @@
 # MCP Agent Stack
 
 ## Overview
-Modular, versioned MCP agent orchestration system with CI/CD, SBOM, and staging deployment readiness.
+Modular, versioned MCP agent orchestration system with CI/CD, SBOM, and staging deployment readiness. The orchestrator coordinates the DataParser, Summarizer, Optimizer and Logger agents to process input text.
 
 ## Setup
+```bash
 pip install -r requirements.txt
+```
+
+### Running the orchestrator
+```bash
 python src/agents.py
+```
+
+### Running tests
+```bash
+python -m unittest discover src
+```
 
 ## Deployment
 - GitHub Actions auto-bumps version