fixed broken links

utkarshx · utkarshx · commit 02a17577a8d1 · 2025-06-03T15:18:16.000+05:30
diff --git a/docs/developer/agents/1_agentarchitecture/1_architecture.md b/docs/developer/agents/1_agentarchitecture/1_architecture.md
@@ -0,0 +1,21 @@
+---
+sidebar_position: 1
+sidebar_label: Architecture Overview
+---
+
+# Agent Architecture Overview
+
+This section covers the detailed architecture of Codebolt agents.
+
+## Coming Soon
+
+Detailed architecture documentation is being developed. For now, please refer to the [Agent Introduction](../agentIntroduction.md) for basic concepts.
+
+## Key Components
+
+- Agent Runtime Environment
+- Communication Protocols
+- Tool Integration
+- State Management
+
+For immediate help, see the [QuickStart Guide](../quickstart.md).
diff --git a/docs/developer/agents/1_agentarchitecture/index.md b/docs/developer/agents/1_agentarchitecture/index.md
@@ -0,0 +1,24 @@
+---
+sidebar_position: 1
+sidebar_label: Agent Architecture
+---
+
+# Agent Architecture
+
+This section covers the detailed architecture and concepts behind Codebolt agents.
+
+## Architecture Overview
+
+Learn about the core components and design patterns that make Codebolt agents powerful and flexible.
+
+## Available Topics
+
+- [Architecture Overview](./1_architecture.md) - Core architectural concepts
+
+## Coming Soon
+
+More detailed architecture documentation is being developed. For immediate help:
+
+- [Agent Introduction](../agentIntroduction.md) - Basic concepts and overview
+- [QuickStart Guide](../quickstart.md) - Get started quickly
+- [Custom Agents](../3_customagents/3_firstExtension.md) - Build your own agents 
diff --git a/docs/developer/agents/2_usingagents/index.md b/docs/developer/agents/2_usingagents/index.md
@@ -0,0 +1,21 @@
+---
+sidebar_position: 1
+sidebar_label: Using Agents
+---
+
+# Using Agents
+
+This section covers how to effectively use Codebolt agents in your development workflow.
+
+## Available Topics
+
+- [Running Agents](./5_runAgent.md) - How to run and manage agents
+
+## Coming Soon
+
+More documentation on using agents effectively is being developed. For immediate help:
+
+- [Agent Introduction](../agentIntroduction.md) - Basic concepts and overview
+- [QuickStart Guide](../quickstart.md) - Get started quickly
+- [Custom Agents](../3_customagents/3_firstExtension.md) - Build your own agents 
+ 
diff --git a/docs/developer/agents/3_customagents/index.md b/docs/developer/agents/3_customagents/index.md
@@ -0,0 +1,26 @@
+---
+sidebar_position: 1
+sidebar_label: Custom Agents
+---
+
+# Custom Agents
+
+This section covers how to build and customize your own Codebolt agents.
+
+## Available Topics
+
+- [First Extension](./3_firstExtension.md) - Create your first custom agent
+- [Run Extension](./4_runExtension.md) - Running and testing your agent
+- [Publish Extension](./6_publishExtension.md) - Publishing your agent
+
+## Getting Started
+
+Building custom agents allows you to create specialized AI assistants for your specific development needs.
+
+## Next Steps
+
+For more information:
+
+- [Agent Introduction](../agentIntroduction.md) - Basic concepts and overview
+- [QuickStart Guide](../quickstart.md) - Get started quickly
+- [Agent Architecture](../1_agentarchitecture/1_architecture.md) - Understand the technical details 
diff --git a/docs/developer/agents/agentIntroduction.md b/docs/developer/agents/agentIntroduction.md
@@ -209,8 +209,8 @@ Ready to create your first agent? Here's what you need:
 
 1. **Prerequisites**: Node.js, Codebolt CLI, and basic JavaScript knowledge
 2. **Quick Start**: Follow our [QuickStart Guide](./quickstart.md) for a 10-minute setup
-3. **Deep Dive**: Explore [Agent Architecture](./1_agentarchitecture.md) for detailed concepts
-4. **Examples**: Check out [Custom Agents](./3_customagents.md) for real-world examples
+3. **Deep Dive**: Explore [Agent Architecture](./1_agentarchitecture/1_architecture.md) for detailed concepts
+4. **Examples**: Check out [Custom Agents](./3_customagents/3_firstExtension.md) for real-world examples
 
 ## Agent Ecosystem
 
@@ -224,9 +224,9 @@ The Codebolt agent ecosystem includes:
 ## Next Steps
 
 - **[QuickStart Guide](./quickstart.md)** - Create your first agent in 10 minutes
-- **[Agent Architecture](./1_agentarchitecture.md)** - Understand the technical details
-- **[Using Agents](./2_usingagents.md)** - Learn how to effectively use agents
-- **[Custom Agents](./3_customagents.md)** - Build specialized agents for your needs
+- **[Agent Architecture](./1_agentarchitecture/1_architecture.md)** - Understand the technical details
+- **[Using Agents](./2_usingagents/5_runAgent.md)** - Learn how to effectively use agents
+- **[Custom Agents](./3_customagents/3_firstExtension.md)** - Build specialized agents for your needs
 
 ---
 
diff --git a/docs/developer/agents/multi-agent.md b/docs/developer/agents/multi-agent.md
@@ -0,0 +1,21 @@
+---
+sidebar_position: 5
+sidebar_label: Multi-Agent Systems
+---
+
+# Multi-Agent Systems
+
+This section covers how multiple Codebolt agents can work together.
+
+## Coming Soon
+
+Multi-agent system documentation is being developed. 
+
+## Overview
+
+- Agent Coordination
+- Inter-Agent Communication
+- Workflow Orchestration
+- Shared Resources
+
+For current agent development, see the [Agent Introduction](./agentIntroduction.md).
diff --git a/docs/developer/agents/quickstart.md b/docs/developer/agents/quickstart.md
@@ -5,7 +5,7 @@ sidebar_label: QuickStart
 
 # QuickStart
 
-This guide will walk you through creating your first Codebolt agent in under 10 minutes. For detailed explanations, see the [complete documentation](./1_agentarchitecture.md).
+This guide will walk you through creating your first Codebolt agent in under 10 minutes. For detailed explanations, see the [complete documentation](./1_agentarchitecture/1_architecture.md).
 
 ## Prerequisites
 
@@ -283,9 +283,9 @@ try {
 
 Now that you've created your first agent, explore:
 
-- **[Agent Architecture](./1_agentarchitecture.md)** - Deep dive into agent concepts
-- **[Using Agents](./2_usingagents.md)** - Advanced usage patterns  
-- **[Custom Agents](./3_customagents.md)** - Building specialized agents
+- **[Agent Architecture](./1_agentarchitecture/1_architecture.md)** - Deep dive into agent concepts
+- **[Using Agents](./2_usingagents/5_runAgent.md)** - Advanced usage patterns  
+- **[Custom Agents](./3_customagents/3_firstExtension.md)** - Building specialized agents
 - **[Tools Integration](../tools/quickstart.md)** - Add tools to your agents
 
 ## Troubleshooting
diff --git a/docs/developer/cli/agents.md b/docs/developer/cli/agents.md
@@ -485,4 +485,4 @@ metadata:
 - [Learn about tool development](./tools.md)
 - [Explore the complete command reference](./commands.md)
 - [See practical examples](./examples.md)
-- [Understand the agent SDK](../agents/) 
+- [Understand the agent SDK](../agents/agentIntroduction.md) 
diff --git a/docs/developer/cli/authentication.md b/docs/developer/cli/authentication.md
@@ -220,6 +220,6 @@ The authentication system integrates with the Codebolt API:
 After successful authentication:
 
 1. [Create your first agent](./agents.md)
-2. [Explore agent management](./agents.md#agent-lifecycle)
+2. [Explore agent management](./agents.md#agent-lifecycle-management)
 3. [Learn about tool development](./tools.md)
 4. [Review all available commands](./commands.md) 
diff --git a/docs/developer/cli/tools.md b/docs/developer/cli/tools.md
@@ -16,7 +16,7 @@ Codebolt Tools are MCP-compatible utilities that:
 - **Support Parameters**: Accept configuration and runtime parameters
 - **Are Testable**: Can be debugged and tested independently
 
-For detailed information about tool architecture and development concepts, see the [Tools Documentation](../../tools/).
+For detailed information about tool architecture and development concepts, see the [Tools Documentation](../tools/).
 
 ## CLI Commands for Tools
 
@@ -322,7 +322,7 @@ codebolt-cli runtool query ./.codeboltAgents/tools/database-tool/index.js
 
 ## Next Steps
 
-- [Learn about detailed tool development](../../tools/)
+- [Learn about detailed tool development](../tools/)
 - [Explore MCP protocol documentation](https://modelcontextprotocol.io/)
 - [See agent integration examples](./agents.md)
 - [Review complete command reference](./commands.md)
diff --git a/docs/developer/templates/best-practices.md b/docs/developer/templates/best-practices.md
@@ -801,8 +801,8 @@ updateVersion(type)
 ## Next Steps
 
 - **[Template Examples](./examples.md)** - Study real-world template implementations
-- **[Community Guidelines](./community.md)** - Understand community standards
-- **[Advanced Patterns](./advanced-patterns.md)** - Learn sophisticated template techniques
+- **[Publishing Templates](./publishing.md)** - Understand community standards
+- **[Template Configuration](./configuration.md)** - Learn sophisticated template techniques
 
 ---
 
diff --git a/docs/developer/templates/creating-templates.md b/docs/developer/templates/creating-templates.md
@@ -359,7 +359,7 @@ docker run -p 3000:3000 my-awesome-app
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License - see LICENSE file for details.
 ```
 
 ### 4. Environment Configuration
diff --git a/docs/developer/templates/examples.md b/docs/developer/templates/examples.md
@@ -1088,7 +1088,7 @@ export const ProductCard = ({ product }: ProductCardProps) => {
 
 - **[Template Best Practices](./best-practices.md)** - Learn advanced template patterns
 - **[Publishing Templates](./publishing.md)** - Share your customized templates
-- **[Community Guidelines](./community.md)** - Contribute to the template ecosystem
+- **[Publishing Templates](./publishing.md)** - Contribute to the template ecosystem
 
 ---
 
diff --git a/docs/developer/templates/publishing.md b/docs/developer/templates/publishing.md
@@ -412,7 +412,7 @@ After publishing your template:
 
 1. **[Template Best Practices](./best-practices.md)** - Learn advanced template patterns
 2. **[Template Examples](./examples.md)** - Study successful template implementations
-3. **[Community Guidelines](./community.md)** - Understand community standards
+3. **[Best Practices](./best-practices.md)** - Understand community standards
 
 ---
 
diff --git a/docs/developer/tools/create_tool.md b/docs/developer/tools/create_tool.md
@@ -613,4 +613,4 @@ parameters:
 - [Test Your Tool Locally](./testlocalmcp.md) - Learn advanced testing techniques
 - [Publish Your Tool](./publish_tool.md) - Share your tool with the community
 - [Tool Registry](./tool_registry.md) - Discover and use existing tools
-- [Advanced Patterns](./advanced_patterns.md) - Learn advanced tool development patterns
+- [Advanced Patterns](./examples.md) - Learn advanced tool development patterns
diff --git a/docs/developer/tools/index.md b/docs/developer/tools/index.md
@@ -0,0 +1,25 @@
+---
+sidebar_position: 1
+sidebar_label: Tools Overview
+---
+
+# Tools Overview
+
+This section covers Codebolt tools development and usage.
+
+## Available Topics
+
+- [Overview](./overview.md) - Introduction to Codebolt tools
+- [QuickStart](./quickstart.md) - Get started quickly with tools
+- [Create Tool](./create_tool.md) - How to create custom tools
+- [Test Local MCP](./testlocalmcp.md) - Testing tools locally
+- [Publish Tool](./publish_tool.md) - Publishing your tools
+- [Tool Registry](./tool_registry.md) - Managing tools in the registry
+- [Examples](./examples.md) - Practical examples
+- [Troubleshoot](./troubleshoot.md) - Common issues and solutions
+
+## Getting Started
+
+Tools extend the capabilities of Codebolt agents and provide specialized functionality.
+
+Start with the [QuickStart Guide](./quickstart.md) to create your first tool. 
diff --git a/docs/developer/tools/overview.md b/docs/developer/tools/overview.md
@@ -531,9 +531,9 @@ DEBUG=codebolt:tools codebolt-cli runtool function_name ./tool/index.js
 
 ## Next Steps
 
-- [Create Your First Tool](./2_create_tool.md) - Step-by-step tool creation
-- [Test Tools Locally](./3_testlocalmcp.md) - Testing and debugging
-- [Publish Tools](./4_publish_tool.md) - Share your tools
+- [Create Your First Tool](./create_tool.md) - Step-by-step tool creation
+- [Test Tools Locally](./testlocalmcp.md) - Testing and debugging
+- [Publish Tools](./publish_tool.md) - Share your tools
 - [CLI Tool Commands](../cli/tools.md) - CLI reference
 
 
diff --git a/docs/developer/tools/publish_tool.md b/docs/developer/tools/publish_tool.md
@@ -10,7 +10,7 @@ Once you've created and tested your tool, you can publish it to the Codebolt Too
 Before publishing your tool, ensure you have:
 
 - **Completed Tool**: A fully functional tool with proper configuration
-- **Testing**: Comprehensive testing completed (see [Testing Guide](./3_testlocalmcp.md))
+- **Testing**: Comprehensive testing completed (see [Testing Guide](./testlocalmcp.md))
 - **Documentation**: Clear README and usage examples
 - **CLI Access**: Codebolt CLI installed and authenticated
 - **Account**: Valid Codebolt account with publishing permissions
@@ -595,14 +595,14 @@ Ensure your tool complies with licenses:
 
 After publishing your tool:
 
-- [Monitor Usage](./5_tool_registry.md) - Track your tool's performance
-- [Community Engagement](./6_community.md) - Engage with users
-- [Advanced Patterns](./7_advanced_patterns.md) - Learn advanced techniques
-- [Maintenance Guide](./8_maintenance.md) - Keep your tool updated
+- [Monitor Usage](./tool_registry.md) - Track your tool's performance
+- [Community Engagement](./examples.md) - Engage with users
+- [Advanced Patterns](./examples.md) - Learn advanced techniques
+- [Maintenance Guide](./troubleshoot.md) - Keep your tool updated
 
 ## Support and Resources
 
-- **Documentation**: [Tool Registry Guide](./5_tool_registry.md)
+- **Documentation**: [Tool Registry Guide](./tool_registry.md)
 - **Community**: [Codebolt Discord](https://discord.gg/codebolt)
 - **Issues**: [GitHub Issues](https://github.com/codebolt/tools/issues)
 - **Email**: tools-support@codebolt.ai
diff --git a/docs/developer/tools/quickstart.md b/docs/developer/tools/quickstart.md
@@ -5,7 +5,7 @@ sidebar_label: Quickstart
 
 # Quickstart
 
-This guide will walk you through creating your first Codebolt tool in under 10 minutes. For detailed explanations, see the [complete documentation](./tools.md).
+This guide will walk you through creating your first Codebolt tool in under 10 minutes. For detailed explanations, see the [complete documentation](./overview.md).
 
 ## Prerequisites
 
@@ -35,7 +35,7 @@ cd .codeboltAgents/tools/hello-world-tool
 
 ## Step 2: Configure Your Tool
 
-The tool details are written in [`codebolttool.yaml`](`codebolttool.yaml`). Edit `codebolttool.yaml`:
+The tool details are written in `codebolttool.yaml`. Edit `codebolttool.yaml`:
 
 ```yaml
 name: "Hello World Tool"
@@ -52,7 +52,7 @@ parameters:
 
 ## Step 3: Implement Tool Logic
 
-The Tool Logic is written using [ToolBox class](./tools.md#toolbox-class). Replace `index.js` content:
+The Tool Logic is written using [ToolBox class](./overview.md#tool-implementation-patterns). Replace `index.js` content:
 
 ```javascript
 const { ToolBox } = require('@codebolt/toolbox');
@@ -122,7 +122,7 @@ npx codebolt-cli inspecttool ./index.js
 ## Step 5: Test Your Tool in Codebolt Application
 
 - Open the Codebolt Application and open the current project.
-- Make Sure the [Tool is enabled for the Current Agent](../cli/agents.md#enable-tool).
+- Make Sure the Tool is enabled for the Current Agent (see [Agent Configuration](../cli/agents.md#agent-configuration)).
 - In the Chat, ask the AI Agent with the following message:
 ```
 User: Ask Greet Hello World tool to greet Alex.
@@ -187,7 +187,7 @@ npx codebolt-cli updatetool <tool-name>       # Update tool
 
 Now that you've created your first tool, explore:
 
-- **[Complete Tools Guide](./tools.md)** - Detailed concepts and patterns
+- **[Complete Tools Guide](./overview.md)** - Detailed concepts and patterns
 - **[Testing Guide](./testlocalmcp.md)** - Comprehensive testing strategies
 - **[Publishing Guide](./publish_tool.md)** - Advanced publishing features
 - **[Tool Registry](./tool_registry.md)** - Discover and manage tools
diff --git a/docs/developer/tools/testlocalmcp.md b/docs/developer/tools/testlocalmcp.md
@@ -775,9 +775,9 @@ parameters:
 
 ## Next Steps
 
-- [Publish Your Tool](./4_publish_tool.md) - Share your tested tool
-- [Tool Registry](./5_tool_registry.md) - Discover existing tools
-- [Advanced Patterns](./6_advanced_patterns.md) - Learn advanced techniques
+- [Publish Your Tool](./publish_tool.md) - Share your tested tool
+- [Tool Registry](./tool_registry.md) - Discover existing tools
+- [Advanced Patterns](./examples.md) - Learn advanced techniques
 - [CLI Reference](../cli/tools.md) - Complete CLI documentation
 
 
diff --git a/docs/developer/tools/tool_registry.md b/docs/developer/tools/tool_registry.md
@@ -572,7 +572,7 @@ codebolt-cli registry authors --top
 
 ## Next Steps
 
-- [Create Your Own Tool](./2_create_tool.md) - Build and share tools
-- [Advanced Tool Patterns](./6_advanced_patterns.md) - Learn advanced techniques
+- [Create Your Own Tool](./create_tool.md) - Build and share tools
+- [Advanced Tool Patterns](./examples.md) - Learn advanced techniques
 - [CLI Reference](../cli/tools.md) - Complete CLI documentation
-- [Community Guidelines](./7_community.md) - Engage with the community 
+- [Community Guidelines](./examples.md) - Engage with the community 
diff --git a/docs/developer/typescriptSdk/agent-framework.md b/docs/developer/typescriptSdk/agent-framework.md
@@ -697,7 +697,7 @@ const agent = taskComplexity === 'simple'
 
 - **[API Reference](./api-reference.md)** - Complete function documentation
 - **[Examples](./examples.md)** - Real-world agent implementations
-- **[Best Practices](./best-practices.md)** - Advanced patterns and optimization
+- **[Examples](./examples.md)** - Advanced patterns and optimization
 
 ---
 
diff --git a/docs/developer/typescriptSdk/core-modules.md b/docs/developer/typescriptSdk/core-modules.md
diff --git a/docs/developer/typescriptSdk/overview.md b/docs/developer/typescriptSdk/overview.md
