Fixed docs-update script

Author: ivanmilevtues

.github/workflows/docs-update.yml

@@ -99,9 +99,6 @@ jobs:
           mkdir -p docs/development
           
           # Initialize the architecture.mdx file
-          echo "# Architecture Documentation" > docs/development/architecture.mdx
-          echo "" >> docs/development/architecture.mdx
-          echo "This document contains the complete architecture documentation generated from CodeBoarding analysis." >> docs/development/architecture.mdx
           echo "" >> docs/development/architecture.mdx
           
           # First, add on_boarding.mdx if it exists

docs/development/architecture.mdx

@@ -1,10 +1,7 @@
-# Architecture Documentation
-
-This document contains the complete architecture documentation generated from CodeBoarding analysis.
-
 ---
 title: "Architecture Overview"
 description: "Comprehensive architectural overview of the mcp-agent framework"
+icon: "network"
 ---
 
 
@@ -115,10 +112,7 @@ Manages the registration, discovery, and lifecycle of MCP servers and the tools
 ### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
 
 
----
-title: "Agent Core Orchestration"
-description: "Agent Core Orchestration component details"
----
+# Agent Core Orchestration
 
 
 ```mermaid
@@ -137,14 +131,6 @@ graph LR
     ServerManager -- "uses" --> LangChainAdapter
 ```
 
-<Info>
-This documentation was generated by [CodeBoarding](https://github.com/CodeBoarding/GeneratedOnBoardings) to provide comprehensive architectural insights into the mcp-agent framework.
-</Info>
-
-## Details
-
-Abstract Components Overview
-
 ### MCPAgent
 The primary class for the LLM agent, orchestrating its behavior, managing interactions with LLMs, and utilizing available tools. It is the core of the 'Agent Core & Orchestration' component, responsible for the overall decision-making and execution flow.
 
@@ -200,10 +186,7 @@ Provides observability into the agent's execution. It tracks key events, perform
 ### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
 
 
----
-title: "Client Session Management"
-description: "Client Session Management component details"
----
+# Client Session Management
 
 
 ```mermaid
@@ -216,11 +199,7 @@ graph LR
     MCPClient -- "interacts with" --> ServerManager
 ```
 
-<Info>
-This documentation was generated by [CodeBoarding](https://github.com/CodeBoarding/GeneratedOnBoardings) to provide comprehensive architectural insights into the mcp-agent framework.
-</Info>
-
-## Details
+### Details
 
 This section details the Client & Session Management subsystem, which serves as the primary interface for users to interact with the MCP framework. It is responsible for initiating and managing user sessions, providing the necessary context for agent interactions. These components are fundamental because they establish the entry point for user interaction (MCPClient) and manage the entire lifecycle and context of that interaction (MCPSession). Without them, the MCP framework would lack a structured way for users to engage with the LLM agents and for the agents to maintain conversational state and continuity. They embody the core principles of a client-server architecture and session management, which are critical for any interactive system, especially one involving complex, multi-turn agent interactions.
 
@@ -247,10 +226,7 @@ The MCPSession manages the state and context of an ongoing MCP interaction or se
 ### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
 
 
----
-title: "Communication Connectors"
-description: "Communication Connectors component details"
----
+# Communication Connectors
 
 
 ```mermaid
@@ -277,10 +253,6 @@ graph LR
     StreamableHttpConnectionManager -- "utilizes" --> HttpConnector
 ```
 
-<Info>
-This documentation was generated by [CodeBoarding](https://github.com/CodeBoarding/GeneratedOnBoardings) to provide comprehensive architectural insights into the mcp-agent framework.
-</Info>
-
 ## Details
 
 The `Communication Connectors` component is fundamental to the `LLM Agent Framework/Orchestration Library` because it provides the essential communication layer for the `MCPAgent` to interact with various MCP servers and execute tools. This component embodies the **Adapter Pattern**, abstracting the complexities of different communication protocols (WebSocket, HTTP, Sandbox, Stdio) behind a unified `BaseConnector` interface. This modular design allows for easy integration of new communication methods without altering the core agent logic, which is crucial for the framework's extensibility and adaptability in diverse deployment environments.
@@ -380,11 +352,7 @@ Manages streamable HTTP connections, allowing for efficient handling of large da
 ### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
 
 
----
-title: "Connection Management"
-description: "Connection Management component details"
----
-
+# Connection Management
 
 ```mermaid
 graph LR
@@ -413,10 +381,6 @@ graph LR
     SandboxConnector -- "utilizes" --> SseConnectionManager
 ```
 
-<Info>
-This documentation was generated by [CodeBoarding](https://github.com/CodeBoarding/GeneratedOnBoardings) to provide comprehensive architectural insights into the mcp-agent framework.
-</Info>
-
 ## Details
 
 Abstract Components Overview
@@ -516,11 +480,7 @@ A concrete implementation of BaseConnector likely designed to handle connections
 ### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
 
 
----
-title: "LLM Integration Adapters"
-description: "LLM Integration Adapters component details"
----
-
+# LLM Integration Adapters
 
 ```mermaid
 graph LR
@@ -534,10 +494,6 @@ graph LR
     MCPAgent -- "uses" --> ServerManager
 ```
 
-<Info>
-This documentation was generated by [CodeBoarding](https://github.com/CodeBoarding/GeneratedOnBoardings) to provide comprehensive architectural insights into the mcp-agent framework.
-</Info>
-
 ## Details
 
 This component provides a standardized and extensible mechanism for integrating diverse external LLM frameworks, such as LangChain, and their associated components (tools, resources, prompts) into the MCP's internal operational model. It leverages the Adapter Pattern to ensure compatibility and facilitate seamless interaction with various LLM providers, abstracting away framework-specific complexities. This is fundamental for the "LLM Agent Framework/Orchestration Library" as it allows the agent to be agnostic to the underlying LLM framework.
@@ -571,11 +527,7 @@ The central orchestrator of the MCP system. It interacts with and utilizes LLM-b
 ### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
 
 
----
-title: "Resource Tool Management"
-description: "Resource Tool Management component details"
----
-
+# Resource Tool Management
 
 ```mermaid
 graph LR
@@ -600,10 +552,6 @@ graph LR
     UseToolFromServerTool -- "interacts with" --> ServerManager
 ```
 
-<Info>
-This documentation was generated by [CodeBoarding](https://github.com/CodeBoarding/GeneratedOnBoardings) to provide comprehensive architectural insights into the mcp-agent framework.
-</Info>
-
 ## Details
 
 Updated analysis of MCP components, correcting source code references for ServerManager and validating ToolSearchEngine interaction.