Clarifying orra's core values and how its different.

README.md

@@ -1,33 +1,42 @@
 # 🪡 orra
 
-Move beyond simple Crews and Agents. Use orra's production-grade planning to reliably run multi-agent workflows that require complex real-world interactions.
+Orra is infrastructure for resilient AI agent workflows. It helps your agents recover from failures like API outages, failed evals, and more - keeping your workflows moving forward.
 
 ![](images/orra-diagram.png)
 
-orra coordinates tasks across your existing stack, agents and any tools run as services using intelligent reasoning — across any language, agent framework or deployment platform.
+By intelligently coordinating tasks across your agents, tools, and existing stack, orra ensures robust execution in any environment. It’s designed to work seamlessly with any language, agent framework, or deployment platform.
 
-* 🧠 Smart pre-evaluated execution plans
-* 🎯 Domain grounded
-* 🗿 Durable execution
-* 🚀 Go fast and save cost with tools as services
+* 🧠 Planning agent with automatic agent/service discovery
+* 🗿 Durable execution with state persistence
+* 🎯 Pre-validated execution plans
 * ↩️ Revert state to handle failures
-* ⛑️ Automatic service health monitoring
+* 🕵 Audit logs for traceability
+* 🚀 Go fast and save cost with tools as services
+* ⛑️ Automatic health monitoring
 * 🔮 Real-time status tracking
-* 🪝 Webhooks for completion and failure monitoring
+* 🏢 On-premises deployment
+* 🪝 Webhooks notifications for completions and failures
 
 [Learn why we built orra →](https://tinyurl.com/orra-launch-blog-post)
 
 ### Coming Soon
 
+* Integration adapters for popular agent frameworks
+* Scale your workflows with reliable coverage
+* Planning course correction for failed evals
 * Agent replay and multi-LLM consensus planning
+* End-to-end encryption
+* Granular workflow access controls
 * Continuous adjustment of Agent workflows during runtime
 * Additional language SDKs - Ruby, DotNet and Go very soon!
 * MCP integration
+* SOC 2 and GDPR readiness to meet the needs of regulated industries
 
 ## Table of Contents
 
 - [Installation](#installation)
 - [How The Plan Engine Works](#how-the-plan-engine-works)
+- [How orra Compares](#how-orra-compares)
 - [Guides](#guides)
 - [Explore Examples](#explore-examples)
 - [Docs](#docs)
@@ -235,6 +244,20 @@ The Plan Engine ensures:
 * Real-time status updates
 * Webhook events for result delivery and monitoring
 
+## How orra compares
+
+Orra takes a unique approach to AI workflow orchestration. Here's how it compares to other solutions:
+
+|                       | **orra**                                                                                                     | **Agent Frameworks**<br/>(e.g. Mastra, LangGraph)                             | **Workflow Engines**<br/>(e.g. Temporal, Inngest)        |
+|-----------------------|--------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|----------------------------------------------------------|
+| **Purpose**           | Multi-agent coordination layer                                                                               | Build individual AI agents                                                    | Run pre-planned workflows                                |
+| **Planning Style**    | AI-driven plan generation                                                                                    | Hardcoded agent workflows                                                     | Manual workflow definition                               |
+| **Error Recovery**    | Auto-recovery without restart                                                                                | Try/catch manual handling                                                     | Config-based retry policies                              |
+| **Best For**          | Complex unpredictable workflows                                                                              | Single agent development                                                      | Repeatable business processes                            |
+| **Example Use**       | "Deliver this product by Friday" → dynamically coordinates research, inventory, delivery, and payment agents | "Analyze this document" → fixed steps of reading, extracting, and summarizing | "Process new signup" → predefined steps with retry logic |
+
+Orra is for building AI systems that need to adapt and recover when things go wrong, without brittle scripts or manual fixes.
+
 ## Guides
 
 - [From Fragile to Production-Ready Multi-Agent App](https://github.com/orra-dev/agent-fragile-to-prod-guide)