Merge pull request #4789 from Kilo-Org/docs/reorganize-customization-section

docs: reorganize customization docs into top-level section

apps/kilocode-docs/docs/advanced-usage/auto-cleanup.md

@@ -241,7 +241,7 @@ Task data is stored in your VS Code global storage location:
 ## Related Features
 
 - [**Checkpoints**](../features/checkpoints): Version control for tasks that can be restored
-- [**Settings Management**](../features/settings-management): Export/import settings including cleanup configuration
+- [**Settings Management**](../basic-usage/settings-management): Export/import settings including cleanup configuration
 - [**Task History**](../basic-usage/the-chat-interface): Managing and organizing your task history
 
 ## Frequently Asked Questions

apps/kilocode-docs/docs/advanced-usage/memory-bank.md

@@ -35,7 +35,7 @@ When Memory Bank is active, Kilo Code begins each task with `[Memory Bank: Activ
 
 ## How Memory Bank Works
 
-Memory Bank is built on Kilo Code's [Custom Rules](/advanced-usage/custom-rules) feature, providing a specialized framework for project documentation. Memory Bank files are standard markdown files stored in `.kilocode/rules/memory-bank` folder within your project repository. They're not hidden or proprietary - they're regular documentation files that both you and Kilo Code can access.
+Memory Bank is built on Kilo Code's [Custom Rules](/agent-behavior/custom-rules) feature, providing a specialized framework for project documentation. Memory Bank files are standard markdown files stored in `.kilocode/rules/memory-bank` folder within your project repository. They're not hidden or proprietary - they're regular documentation files that both you and Kilo Code can access.
 
 At the start of every task, Kilo Code reads all Memory Bank files to build a comprehensive understanding of your project. This happens automatically without requiring any action from you. Kilo Code then indicates successful Memory Bank activation with `[Memory Bank: Active]` at the beginning of its response, followed by a brief summary of its understanding of your project.
 

apps/kilocode-docs/docs/advanced-usage/migrating-from-cursor-windsurf.md

@@ -397,9 +397,9 @@ mkdir -p .kilocode/rules-docs
 
 ## Next Steps
 
-- [Learn about Custom Rules](/advanced-usage/custom-rules)
-- [Explore Custom Modes](/features/custom-modes)
-- [Set up Custom Instructions](/advanced-usage/custom-instructions)
+- [Learn about Custom Rules](/agent-behavior/custom-rules)
+- [Explore Custom Modes](/agent-behavior/custom-modes)
+- [Set up Custom Instructions](/agent-behavior/custom-instructions)
 - [Join our Discord](https://kilo.ai/discord) for migration support
 
 ## Additional Resources

apps/kilocode-docs/docs/advanced-usage/custom-instructions.md → apps/kilocode-docs/docs/agent-behavior/custom-instructions.md

@@ -7,7 +7,7 @@ Custom Instructions allow you to personalize how Kilo Code behaves, providing sp
 Custom Instructions define specific Extension behaviors, preferences, and constraints beyond Kilo's basic role definition. Examples include coding style, documentation standards, testing requirements, and workflow guidelines.
 
 :::info Custom Instructions vs Rules
-Custom Instructions are IDE-wide and are applied across all workspaces and maintain your preferences regardless of which project you're working on. Unlike Instructions, [Custom Rules](/advanced-usage/custom-rules.md) are project specific and allow you to setup workspace-based ruleset.
+Custom Instructions are IDE-wide and are applied across all workspaces and maintain your preferences regardless of which project you're working on. Unlike Instructions, [Custom Rules](/agent-behavior/custom-rules) are project specific and allow you to setup workspace-based ruleset.
 :::
 
 ## Setting Custom Instructions
@@ -36,7 +36,7 @@ Mode-specific instructions can be set using the Modes Tab
 
 ## Related Features
 
-- [Custom Modes](/docs/features/custom-modes)
-- [Custom Rules](/advanced-usage/custom-rules)
-- [Settings Management](/docs/features/settings-management)
-- [Auto-Approval Settings](/docs/features/auto-approving-actions)
+- [Custom Modes](/agent-behavior/custom-modes)
+- [Custom Rules](/agent-behavior/custom-rules)
+- [Settings Management](/basic-usage/settings-management)
+- [Auto-Approval Settings](/features/auto-approving-actions)

apps/kilocode-docs/docs/advanced-usage/custom-rules.md → apps/kilocode-docs/docs/agent-behavior/custom-rules.md

@@ -217,7 +217,7 @@ If your custom rules aren't being properly followed:
 
 ## Related Features
 
-- [Custom Modes](/docs/features/custom-modes)
-- [Custom Instructions](/advanced-usage/custom-instructions)
-- [Settings Management](/docs/features/settings-management)
-- [Auto-Approval Settings](/docs/features/auto-approving-actions)
+- [Custom Modes](/agent-behavior/custom-modes)
+- [Custom Instructions](/agent-behavior/custom-instructions)
+- [Settings Management](/basic-usage/settings-management)
+- [Auto-Approval Settings](/features/auto-approving-actions)

apps/kilocode-docs/docs/advanced-usage/prompt-engineering.md → apps/kilocode-docs/docs/agent-behavior/prompt-engineering.md

@@ -44,7 +44,7 @@ Custom instructions are added to the system prompt, providing persistent guidanc
 - Define project-specific conventions.
 - Adjust Kilo Code's tone or personality.
 
-See the [Custom Instructions](/advanced-usage/custom-instructions) section for more details.
+See the [Custom Instructions](/agent-behavior/custom-instructions) section for more details.
 
 ## Handling Ambiguity
 

apps/kilocode-docs/docs/features/skills.md → apps/kilocode-docs/docs/agent-behavior/skills.md

@@ -285,6 +285,6 @@ Skills are simple Markdown files with frontmatter. Start with your existing prom
 
 ## Related
 
-- [Custom Modes](custom-modes) - Create custom modes that can use specific skills
-- [Custom Instructions](../advanced-usage/custom-instructions) - Global instructions vs. skill-based instructions
-- [Custom Rules](../advanced-usage/custom-rules) - Project-level rules complementing skills
+- [Custom Modes](/agent-behavior/custom-modes) - Create custom modes that can use specific skills
+- [Custom Instructions](/agent-behavior/custom-instructions) - Global instructions vs. skill-based instructions
+- [Custom Rules](/agent-behavior/custom-rules) - Project-level rules complementing skills

apps/kilocode-docs/docs/basic-usage/git-commit-generation.md

@@ -154,4 +154,4 @@ The feature integrates with VS Code's built-in git functionality. If you encount
 ## Related Features
 
 - [API Configuration Profiles](/features/api-configuration-profiles) - Use different models for commit generation
-- [Settings Management](/features/settings-management) - Manage all your Kilo Code preferences
+- [Settings Management](/basic-usage/settings-management) - Manage all your Kilo Code preferences

apps/kilocode-docs/docs/basic-usage/using-modes.md

@@ -87,4 +87,4 @@ Four ways to switch modes:
 
 ## Custom Modes
 
-Create your own specialized assistants by defining tool access, file permissions, and behavior instructions. Custom modes help enforce team standards or create purpose-specific assistants. See [Custom Modes documentation](/features/custom-modes) for setup instructions.
+Create your own specialized assistants by defining tool access, file permissions, and behavior instructions. Custom modes help enforce team standards or create purpose-specific assistants. See [Custom Modes documentation](/agent-behavior/custom-modes) for setup instructions.

apps/kilocode-docs/docs/contributing/index.md

@@ -82,7 +82,7 @@ git checkout -b your-branch-name
 
 Custom modes are a powerful way to extend Kilo Code's capabilities. To create and share a custom mode:
 
-1. Follow the [Custom Modes documentation](/features/custom-modes) to create your mode
+1. Follow the [Custom Modes documentation](/agent-behavior/custom-modes) to create your mode
 
 2. Test your mode thoroughly
 

apps/kilocode-docs/docs/faq.md

@@ -113,7 +113,7 @@ Open the Kilo Code panel (<img src="/docs/img/kilo-v1.svg" width="12" />) and ty
 - **Architect:** For planning and technical leadership.
 - **Ask:** For answering questions and providing information.
 - **Debug:** For systematic problem diagnosis.
-  You can also create [Custom Modes](/features/custom-modes).
+  You can also create [Custom Modes](/agent-behavior/custom-modes).
 
 ### How do I switch between modes?
 

apps/kilocode-docs/docs/features/api-configuration-profiles.md

@@ -98,7 +98,7 @@ API keys are stored securely in VSCode's Secret Storage and are never exposed in
 
 ## Related Features
 
-- Works with [custom modes](/features/custom-modes) you create
+- Works with [custom modes](/agent-behavior/custom-modes) you create
 - Integrates with [local models](/advanced-usage/local-models) for offline work
 - Supports [temperature settings](/features/model-temperature) per mode
 - Enhances cost management with [rate limits and usage tracking](/advanced-usage/rate-limits-costs)

apps/kilocode-docs/docs/features/auto-launch-configuration.md

@@ -48,7 +48,7 @@ This happens seamlessly in the background, requiring no manual intervention.
     - `"ask"` - Questions and explanations
     - `"debug"` - Problem diagnosis and troubleshooting
     - `"test"` - Testing-focused workflows
-    - Custom mode slugs (if you have [custom modes](/features/custom-modes))
+    - Custom mode slugs (if you have [custom modes](/agent-behavior/custom-modes))
 
 ## Example Configurations
 

apps/kilocode-docs/docs/features/model-temperature.md

@@ -89,5 +89,5 @@ Remember that different models may respond differently to the same temperature v
 ## Related Features
 
 - Works with all [API providers](/providers/openai) supported by Kilo Code
-- Complements [custom instructions](/advanced-usage/custom-instructions) for fine-tuning responses
-- Works alongside [custom modes](/features/custom-modes) you create
+- Complements [custom instructions](/agent-behavior/custom-instructions) for fine-tuning responses
+- Works alongside [custom modes](/agent-behavior/custom-modes) you create

apps/kilocode-docs/docs/index.mdx

@@ -56,7 +56,7 @@ Kilo Code adapts to your needs with specialized [modes](/basic-usage/using-modes
 - [**Architect Mode:**](/basic-usage/using-modes#architect-mode) For planning and technical leadership
 - [**Ask Mode:**](/basic-usage/using-modes#ask-mode) For answering questions and providing information
 - [**Debug Mode:**](/basic-usage/using-modes#debug-mode) For systematic problem diagnosis
-- **[Custom Modes](/features/custom-modes):** Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task
+- **[Custom Modes](/agent-behavior/custom-modes):** Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task
 
 #### Core Tools
 
@@ -79,10 +79,10 @@ See the complete [Tools Reference](/features/tools/tool-use-overview) for all av
 
 Make Kilo Code work your way with:
 
-- [Settings Management](/features/settings-management) for configuring your experience
-- [Custom Modes](/features/custom-modes) for specialized tasks
-- [Custom Rules](/advanced-usage/custom-rules) for project-specific rules
-- [Custom Instructions](/advanced-usage/custom-instructions) for global plugin-wide instructions
+- [Settings Management](/basic-usage/settings-management) for configuring your experience
+- [Custom Modes](/agent-behavior/custom-modes) for specialized tasks
+- [Custom Rules](/agent-behavior/custom-rules) for project-specific rules
+- [Custom Instructions](/agent-behavior/custom-instructions) for global plugin-wide instructions
 - [API Configuration Profiles](/features/api-configuration-profiles) for different model providers
 - [Auto-Approval Settings](/features/auto-approving-actions) for faster workflows
 
@@ -92,7 +92,7 @@ Make Kilo Code work your way with:
 
 - [Using Kilo Code](/basic-usage/the-chat-interface) - Learn the basics
 - [Core Concepts](/features/auto-approving-actions) - Master key features
-- [Advanced Usage](/advanced-usage/prompt-engineering) - Take your skills further
+- [Advanced Usage](/agent-behavior/prompt-engineering) - Take your skills further
 - [Frequently Asked Questions](/faq) - Get answers to common questions
 
 ### Community

apps/kilocode-docs/docs/tips-and-tricks.md

@@ -5,7 +5,7 @@ A collection of quick tips to help you get the most out of Kilo Code.
 - Drag Kilo Code to the [Secondary Sidebar](https://code.visualstudio.com/api/ux-guidelines/sidebars#secondary-sidebar) so you can see the Explorer, Search, Source Control, etc.
 - Once you have Kilo Code in a separate sidebar from the file explorer, you can drag files from the explorer into the chat window (and even multiple at once). Just make sure to hold down the shift key after you start dragging the files.
 - If you're not using [MCP](/features/mcp/overview), turn it off in the <Codicon name="notebook" /> Prompts tab to significantly cut down the size of the system prompt.
-- To keep your [custom modes](/features/custom-modes) on track, limit the types of files that they're allowed to edit.
+- To keep your [custom modes](/agent-behavior/custom-modes) on track, limit the types of files that they're allowed to edit.
 - If you hit the dreaded `input length and max tokens exceed context limit` error, you can recover by deleting a message, rolling back to a previous checkpoint, or switching over to a model with a long context window like Gemini for a message.
 - In general, be thoughtful about your `Max Tokens` setting for thinking models. Every token you allocate to that takes away from space available to store conversation history. Consider only using high `Max Tokens` / `Max Thinking Tokens` settings with modes like Architect and Debug, and keeping Code mode at 16k max tokens or less.
 - If there's a real world job posting for something you want a custom mode to do, try asking Code mode to `Create a custom mode based on the job posting at @[url]`

apps/kilocode-docs/docusaurus.config.ts

@@ -108,12 +108,32 @@ const config: Config = {
 						from: ["/advanced-usage/code-actions"],
 					},
 					{
-						to: "/advanced-usage/custom-instructions",
-						from: ["/features/custom-instructions"],
+						to: "/agent-behavior/custom-instructions",
+						from: ["/advanced-usage/custom-instructions", "/features/custom-instructions", "/customization/custom-instructions"],
 					},
 					{
-						to: "/features/custom-modes",
-						from: ["/advanced-usage/custom-modes"],
+						to: "/agent-behavior/custom-modes",
+						from: ["/features/custom-modes", "/advanced-usage/custom-modes", "/customization/custom-modes"],
+					},
+					{
+						to: "/agent-behavior/custom-rules",
+						from: ["/advanced-usage/custom-rules", "/customization/custom-rules"],
+					},
+					{
+						to: "/agent-behavior/skills",
+						from: ["/features/skills", "/customization/skills"],
+					},
+					{
+						to: "/agent-behavior/workflows",
+						from: ["/features/slash-commands/workflows", "/customization/workflows"],
+					},
+					{
+						to: "/basic-usage/settings-management",
+						from: ["/features/settings-management", "/customization/settings-management"],
+					},
+					{
+						to: "/agent-behavior/prompt-engineering",
+						from: ["/advanced-usage/prompt-engineering"],
 					},
 					{
 						to: "/features/enhance-prompt",

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-instructions.md

@@ -7,7 +7,7 @@
 自定义指令定义了扩展的特定行为、偏好和约束，超出了 Kilo 的基本角色定义。示例包括编码风格、文档标准、测试要求和工作流指南。
 
 :::info 自定义指令 vs 规则
-自定义指令是 IDE 范围的，适用于所有工作区，无论你在处理哪个项目，都会保持你的偏好。与指令不同，[自定义规则](/advanced-usage/custom-rules.md) 是项目特定的，允许你设置基于工作区的规则集。
+自定义指令是 IDE 范围的，适用于所有工作区，无论你在处理哪个项目，都会保持你的偏好。与指令不同，[自定义规则](/agent-behavior/custom-rules) 是项目特定的，允许你设置基于工作区的规则集。
 :::
 
 ## 设置自定义指令
@@ -36,7 +36,7 @@
 
 ## 相关功能
 
-- [自定义模式](/features/custom-modes)
-- [自定义规则](/advanced-usage/custom-rules)
-- [设置管理](/features/settings-management)
+- [自定义模式](/agent-behavior/custom-modes)
+- [自定义规则](/agent-behavior/custom-rules)
+- [设置管理](/basic-usage/settings-management)
 - [自动批准设置](/features/auto-approving-actions)

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-rules.md

@@ -211,7 +211,7 @@ Kilo Code 提供了一个内置界面，用于管理您的自定义规则，而
 
 ## 相关功能
 
-- [自定义模式](/features/custom-modes)
-- [自定义指令](/advanced-usage/custom-instructions)
-- [设置管理](/features/settings-management)
+- [自定义模式](/agent-behavior/custom-modes)
+- [自定义指令](/agent-behavior/custom-instructions)
+- [设置管理](/basic-usage/settings-management)
 - [自动批准设置](/features/auto-approving-actions)

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/memory-bank.md

@@ -31,7 +31,7 @@ Memory Bank 是一个结构化文档系统，使 Kilo Code 能够**更好地理
 
 ## Memory Bank 的工作原理
 
-Memory Bank 基于 Kilo Code 的 [自定义规则](/advanced-usage/custom-rules) 功能构建，为项目文档提供了一个专门的框架。Memory Bank 文件是存储在项目仓库 `.kilocode/rules/memory-bank` 文件夹中的标准 Markdown 文件。它们不是隐藏或专有的——它们是你和 Kilo Code 都可以访问的常规文档文件。
+Memory Bank 基于 Kilo Code 的 [自定义规则](/agent-behavior/custom-rules) 功能构建，为项目文档提供了一个专门的框架。Memory Bank 文件是存储在项目仓库 `.kilocode/rules/memory-bank` 文件夹中的标准 Markdown 文件。它们不是隐藏或专有的——它们是你和 Kilo Code 都可以访问的常规文档文件。
 
 在每个任务开始时，Kilo Code 会读取所有 Memory Bank 文件，以构建对项目的全面理解。这是自动进行的，不需要你采取任何操作。Kilo Code 然后会在其响应的开头显示 `[Memory Bank: Active]`，表示 Memory Bank 已成功激活，并简要总结其对项目的理解。
 

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/prompt-engineering.md

@@ -44,7 +44,7 @@ Prompt engineering 是为 AI 模型（如 Kilo Code）编写有效指令的艺
 - 定义项目特定的约定。
 - 调整 Kilo Code 的语气或个性。
 
-有关更多详细信息，请参阅 [自定义指令](/advanced-usage/custom-instructions) 部分。
+有关更多详细信息，请参阅 [自定义指令](/agent-behavior/custom-instructions) 部分。
 
 ## 处理歧义
 

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/git-commit-generation.md

@@ -154,4 +154,4 @@ git add .
 ## 相关功能
 
 - [API 配置配置文件](/features/api-configuration-profiles) - 使用不同的模型进行提交信息生成
-- [设置管理](/features/settings-management) - 管理您的所有 Kilo Code 首选项
+- [设置管理](/basic-usage/settings-management) - 管理您的所有 Kilo Code 首选项

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/using-modes.md

@@ -87,4 +87,4 @@ Kilo Code 中的模式是专门设计的角色，可以根据当前任务调整
 
 ## 自定义模式
 
-通过定义工具访问权限、文件权限和行为指令，创建你自己的专业助手。自定义模式有助于执行团队标准或创建特定用途的助手。有关设置说明，请参阅 [自定义模式文档](/features/custom-modes)。
+通过定义工具访问权限、文件权限和行为指令，创建你自己的专业助手。自定义模式有助于执行团队标准或创建特定用途的助手。有关设置说明，请参阅 [自定义模式文档](/agent-behavior/custom-modes)。

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/extending/contributing-to-kilo.md

@@ -73,7 +73,7 @@ git checkout -b your-branch-name
 
 自定义模式是扩展 Kilo Code 功能的强大方式。要创建并分享自定义模式：
 
-1. 按照 [自定义模式文档](/features/custom-modes) 创建你的模式
+1. 按照 [自定义模式文档](/agent-behavior/custom-modes) 创建你的模式
 
 2. 彻底测试你的模式
 

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/faq.md

@@ -103,7 +103,7 @@ Kilo Code支持多种API提供商，包括：
 - **Architect模式：** 用于规划和技术领导
 - **Ask模式：** 用于回答问题并提供信息
 - **Debug模式：** 用于系统化问题诊断
-  你还可以创建[自定义模式](/features/custom-modes)。
+  你还可以创建[自定义模式](/agent-behavior/custom-modes)。
 
 ### 如何在模式之间切换？
 

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/api-configuration-profiles.md

@@ -100,7 +100,7 @@ API 密钥安全地存储在 VSCode 的 Secret Storage 中，绝不会以纯文
 
 ## 相关功能
 
-- 适用于您创建的[自定义模式](/features/custom-modes)
+- 适用于您创建的[自定义模式](/agent-behavior/custom-modes)
 - 与[本地模型](/advanced-usage/local-models)集成以进行离线工作
 - 支持每个模式的[温度设置](/features/model-temperature)
 - 通过[速率限制和使用跟踪](/advanced-usage/rate-limits-costs)增强成本管理

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/model-temperature.md

@@ -89,5 +89,5 @@ Kilo Code 在实现温度处理时考虑了以下因素：
 ## 相关功能
 
 - 适用于 Kilo Code 支持的所有 [API 提供商](/providers/openai)
-- 补充[自定义指令](/advanced-usage/custom-instructions)以微调响应
-- 与您创建的[自定义模式](/features/custom-modes)一起使用
+- 补充[自定义指令](/agent-behavior/custom-instructions)以微调响应
+- 与您创建的[自定义模式](/agent-behavior/custom-modes)一起使用

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.mdx

@@ -52,7 +52,7 @@ Kilo Code 通过专门的[模式](/basic-usage/using-modes)适应你的需求：
 - [**Architect 模式：**](/basic-usage/using-modes#architect-mode) 用于规划和技术领导
 - [**Ask 模式：**](/basic-usage/using-modes#ask-mode) 用于回答问题并提供信息
 - [**Debug 模式：**](/basic-usage/using-modes#debug-mode) 用于系统化问题诊断
-- **[自定义模式](/features/custom-modes)：** 创建无限数量的专门角色，用于安全审计、性能优化、文档编写或任何其他任务
+- **[自定义模式](/agent-behavior/custom-modes)：** 创建无限数量的专门角色，用于安全审计、性能优化、文档编写或任何其他任务
 
 #### 核心工具
 
@@ -75,10 +75,10 @@ Kilo Code 配备了强大的[工具](/features/tools/tool-use-overview)，可以
 
 通过以下方式让 Kilo Code 按照你的方式工作：
 
-- [设置管理](/features/settings-management)来配置你的体验
-- [自定义模式](/features/custom-modes)用于专门任务
-- [自定义规则](/advanced-usage/custom-rules)用于项目特定规则
-- [自定义指令](/advanced-usage/custom-instructions)用于全局插件范围内的指令
+- [设置管理](/basic-usage/settings-management)来配置你的体验
+- [自定义模式](/agent-behavior/custom-modes)用于专门任务
+- [自定义规则](/agent-behavior/custom-rules)用于项目特定规则
+- [自定义指令](/agent-behavior/custom-instructions)用于全局插件范围内的指令
 - [API 配置配置文件](/features/api-configuration-profiles)用于不同的模型提供商
 - [自动批准设置](/features/auto-approving-actions)用于更快的工作流程
 
@@ -88,7 +88,7 @@ Kilo Code 配备了强大的[工具](/features/tools/tool-use-overview)，可以
 
 - [使用 Kilo Code](/basic-usage/the-chat-interface) - 学习基础知识
 - [核心概念](/features/auto-approving-actions) - 掌握关键功能
-- [高级用法](/advanced-usage/prompt-engineering) - 进一步提升你的技能
+- [高级用法](/agent-behavior/prompt-engineering) - 进一步提升你的技能
 - [常见问题解答](/faq) - 获取常见问题的答案
 
 ### 社区

apps/kilocode-docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/tips-and-tricks.md

@@ -5,7 +5,7 @@
 - 将 Kilo Code 拖到[侧边栏](https://code.visualstudio.com/api/ux-guidelines/sidebars#secondary-sidebar)，以便同时查看资源管理器、搜索、源代码控制等。
 - 当 Kilo Code 位于与文件资源管理器分开的侧边栏时，你可以将文件从资源管理器拖到聊天窗口中（甚至可以一次拖多个文件）。只需在开始拖动文件后按住 shift 键。
 - 如果你不使用[MCP](/features/mcp/overview)，请在 <Codicon name="notebook" /> 提示选项卡中关闭它，以显著减少系统提示的大小。
-- 为了保持[自定义模式](/features/custom-modes)的正轨，请限制它们可以编辑的文件类型。
+- 为了保持[自定义模式](/agent-behavior/custom-modes)的正轨，请限制它们可以编辑的文件类型。
 - 如果你遇到`input length and max tokens exceed context limit`错误，可以通过删除消息、回滚到之前的检查点或切换到具有长上下文窗口的模型（如 Gemini）来恢复。
 - 一般来说，对于思考模型的`Max Tokens`设置要深思熟虑。你分配的每个 token 都会占用存储对话历史的空间。考虑仅在 Architect 和 Debug 等模式中使用高`Max Tokens` / `Max Thinking Tokens`设置，并将 Code 模式保持在 16k max tokens 或更少。
 - 如果有一个你希望自定义模式完成的任务的真实职位发布，可以尝试要求 Code 模式`根据@[url]的职位发布创建一个自定义模式`。

apps/kilocode-docs/sidebars.ts

@@ -86,6 +86,7 @@ const sidebars: SidebarsConfig = {
 					],
 				},
 				"basic-usage/adding-credits",
+				"basic-usage/settings-management",
 			],
 		},
 		{
@@ -129,21 +130,23 @@ const sidebars: SidebarsConfig = {
 				"plans/migration",
 			],
 		},
+		{
+			type: "category",
+			label: "Agent Behavior",
+			items: [
+				"agent-behavior/prompt-engineering",
+				"agent-behavior/custom-modes",
+				"agent-behavior/custom-rules",
+				"agent-behavior/custom-instructions",
+				"agent-behavior/workflows",
+				"agent-behavior/skills",
+			],
+		},
 		{
 			type: "category",
 			label: "Advanced Usage",
 			items: [
-				"advanced-usage/prompt-engineering",
-				{
-					type: "category",
-					label: "Customizing Kilo Code",
-					items: [
-						"advanced-usage/custom-rules",
-						"advanced-usage/custom-instructions",
-						"advanced-usage/migrating-from-cursor-windsurf",
-						"features/slash-commands/workflows",
-					],
-				},
+				"advanced-usage/migrating-from-cursor-windsurf",
 				{
 					type: "category",
 					label: "Advanced Context Features",
@@ -178,11 +181,6 @@ const sidebars: SidebarsConfig = {
 				"features/experimental/experimental-features",
 			],
 		},
-		{
-			type: "category",
-			label: "Customization",
-			items: ["features/settings-management", "features/custom-modes", "features/skills"],
-		},
 		{
 			type: "category",
 			label: "Extending Kilo Code",