docs: reorganize README sections and improve readability

Author: ciro-maciel

README.md

@@ -5,34 +5,18 @@
 ![GitHub Release Date](https://img.shields.io/github/release-date/riligar/agents-sdk)
 ![NPM Downloads](https://img.shields.io/npm/dw/%40riligar%2Fagents-sdk)
 
-## 🔗 Resources
-
--   **[OpenRouter](https://openrouter.ai/docs/quickstart)** - Unified API for multiple LLM providers
--   **[OpenAI](https://platform.openai.com)** | [SDK](https://github.com/openai/openai-node)
--   **[Anthropic](https://console.anthropic.com/)** | [SDK](https://github.com/anthropics/anthropic-sdk-typescript)
--   **[Google AI](https://ai.google.dev/gemini-api/)** | [SDK](https://www.npmjs.com/package/@google/genai)
--   **[Meta Llama](https://www.llama.com/)**
--   **[Model Context Protocol](https://modelcontextprotocol.io)** 
-    -   [Documentation](https://modelcontextprotocol.info/docs/)
-    -   [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
-    -   [Inspector](https://github.com/modelcontextprotocol/inspector)
-
----
-
-## 🚀 **The Ultimate AI Agents Framework**
-
 **Stop wrestling with complex AI integrations.** RiLiGar Agents SDK gives you **enterprise-grade AI agents in just 5 lines of code.**
 
 ✨ **What used to take weeks, now takes minutes.** Built on top of industry giants like **OpenAI, Anthropic, Google, and Meta** through OpenRouter's unified API, this framework packs **thousands of hours of engineering** into an elegantly simple package.
 
 🎯 **One SDK. All AI Providers. Infinite Possibilities.**
 
-- **🤖 Smart Agents** with custom personalities and instructions
-- **🔧 Custom Tools** that agents can execute seamlessly  
-- **🛡️ Built-in Guardrails** for safe, controlled AI interactions
-- **📡 Real-time Streaming** for responsive user experiences
-- **🔗 MCP Protocol** for enterprise-grade integrations
-- **📝 Intelligent Logging** with contextual insights
+-   **🤖 Smart Agents** with custom personalities and instructions
+-   **🔧 Custom Tools** that agents can execute seamlessly
+-   **🛡️ Built-in Guardrails** for safe, controlled AI interactions
+-   **📡 Real-time Streaming** for responsive user experiences
+-   **🔗 MCP Protocol** for enterprise-grade integrations
+-   **📝 Intelligent Logging** with contextual insights
 
 **From startup MVPs to enterprise solutions** - RiLiGar Agents SDK scales with you.
 
@@ -155,6 +139,18 @@ const tools = await tool.build(
 );
 ```
 
+## 🔗 Resources
+
+-   **[OpenRouter](https://openrouter.ai/docs/quickstart)** - Unified API for multiple LLM providers
+-   **[OpenAI](https://platform.openai.com)** | [SDK](https://github.com/openai/openai-node)
+-   **[Anthropic](https://console.anthropic.com/)** | [SDK](https://github.com/anthropics/anthropic-sdk-typescript)
+-   **[Google AI](https://ai.google.dev/gemini-api/)** | [SDK](https://www.npmjs.com/package/@google/genai)
+-   **[Meta Llama](https://www.llama.com/)**
+-   **[Model Context Protocol](https://modelcontextprotocol.io)**
+    -   [Documentation](https://modelcontextprotocol.info/docs/)
+    -   [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+    -   [Inspector](https://github.com/modelcontextprotocol/inspector)
+
 ## 📄 License
 
 Apache-2.0