diff --git a/README.md b/README.md
index 30932207..24dced03 100644
--- a/README.md
+++ b/README.md
@@ -109,6 +109,12 @@ cd hive && npm run dev
 - [Configuration Guide](docs/configuration.md) - All configuration options
 - [Architecture Overview](docs/architecture.md) - System design and structure
 
+## Roadmap
+
+Aden Agent Framework aims to help developers build outcome orienated, self-adaptive agents. Please find our roadmap here
+  
+[ROADMAP.md](ROADMAP.md)
+
 ## Community & Support
 
 We use [Discord](https://discord.com/invite/MXE49hrKDk) for support, feature requests, and community discussions.
diff --git a/ROADMAP.md b/ROADMAP.md
new file mode 100644
index 00000000..62e0e753
--- /dev/null
+++ b/ROADMAP.md
@@ -0,0 +1,129 @@
+# Hive Product Roadmap
+
+Hive is a node-based architecture for building and orchestrating autonomous agents. This roadmap outlines the key milestones and features required to build a robust, scalable agentic ecosystem.
+
+```mermaid
+timeline
+    title Hive Evolution Roadmap
+    section MVP Phase
+        Architecture : Node-Based : SDK : Flexible Edges : Hooks : Tool Use
+        Capabilities : Goal Creation : Worker Agents Generation: File/Memory Tools : Multi-Agent : Human-in-the-Loop
+        Foundations : Basic Eval : Docker Deployment : Documentation
+    section Post-MVP
+        Intelligence : Guardrails : Streaming : Semantic Search
+        Ecosystem : Javascript SDK : Cloud Deployment : CI/CD : Autonomous Agent
+        Agent Templates : Sales Agent : Marketing Agent : Analytics Agent
+```
+
+---
+
+## Phase 1: MVP and SDK backbone
+
+### Backbone Architecture
+- [ ] **Node-Based Architecture (Agent as a node)**
+    - [ ] Object schema definition
+    - [ ] Node wrapper SDK
+    - [ ] Shared memory access
+    - [ ] Default monitoring hooks
+    - [ ] Tool access layer
+    - [ ] LLM integration layer (Natively supports all mainstream LLMs through LiteLLM)
+- [ ] **Communication protocol between nodes**
+- [ ] **[Coding Agent] Goal Creation Session**
+    - [ ] Instruction back and forth
+    - [ ] Goal Object schema definition
+    - [ ] Being able to generate the test cases
+- [ ] **[Coding Agent] Worker Agent Creation**
+    - [ ] Coding Agent tools
+    - [ ] Use Template Agent as a start
+
+### Essential Tools
+- [ ] **File Use**
+- [ ] **Memory Tools**
+    - [ ] STM Layer Tool (state-based short-term memory)
+    - [ ] LTM Layer Tool (RLM - long-term memory)
+- [ ] **Infrastructure Tools**
+    - [ ] Runtime Log Tool (logs for coding agent)
+    - [ ] Audit Trail Tool (decision timeline generation)
+
+### Memory & File System
+- [ ] DB for long-term persistent memory (Filesystem as durable scratchpad pattern)
+- [ ] Session Local memory isolation
+
+### Basic Eval System
+- [ ] Test Driven
+- [ ] Failure recording mechanism
+- [ ] SDK for defining failure conditions
+- [ ] Basic observability hooks
+- [ ] User-driven log analysis (OSS approach)
+
+### Data Validation
+- [ ] Natively Support data validation of LLMs output with Pydantic
+
+### Developer Experience (MVP)
+- [ ] **Documentation**
+    - [ ] Quick start guide
+    - [ ] Goal creation guide
+    - [ ] Agent creation guide
+- [ ] **Distribution**
+    - [ ] PyPI package
+    - [ ] Docker image on Docker Hub
+
+### Sample Agents
+- [ ] Knowledge Agent
+- [ ] Blog Writer Agent
+- [ ] SDR Agent
+
+---
+
+## Phase 2: Post-MVP & Scaling
+
+### Basic Guardrails
+- [ ] Support Basic Monitoring from Agent node SDK
+- [ ] SDK guardrail implementation (in node)
+- [ ] Guardrail type support (Determined Condition as Guardrails)
+
+### Agent Capability
+- [ ] Streaming mode support
+
+### Cross-Platform
+- [ ] Javascript / TypeScript Version SDK
+
+### File System Enhancement
+- [ ] Semantic Search integration
+- [ ] Interactive File System in product (frontend integration)
+
+### More Worker Tools
+- [ ] Custom Tool Integrator
+- [ ] Integration as a tool (Credential Store & Support)
+- [ ] **Core Agent Tools**
+    - [ ] Node Discovery Tool
+    - [ ] HITL Tool (pause execution for human approval)
+    - [ ] Wake-up Tool (resume agent tasks)
+
+### Deployment (Self-Hosted)
+- [ ] Docker container standardization
+- [ ] Headless backend execution
+- [ ] Exposed API for frontend attachment
+- [ ] Local monitoring & observability (from hive repo)
+- [ ] Basic lifecycle APIs (Start, Stop, Pause, Resume)
+
+### Deployment (Cloud)
+- [ ] Cloud Service Options
+- [ ] Support deployment to 3rd-party platforms
+- [ ] Self-deploy + orchestrator connection
+- [ ] **CI/CD Pipeline**
+    - [ ] Automated test execution
+    - [ ] Agent version control
+    - [ ] All tests must pass for deployment
+
+### Developer Experience Enhancement
+- [ ] Detailed Tool usage documentation
+- [ ] Recipe for common agent use cases
+- [ ] Discord Support Channel
+
+### More Agent Templates
+- [ ] GTM Sales Agent (workflow)
+- [ ] GTM Marketing Agent (workflow)
+- [ ] Analytics Agent
+- [ ] Training Agent
+- [ ] Smart Entry / Form Agent (self-evolution emphasis)
\ No newline at end of file