diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 6a9269cc..c4a00e6d 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -20,14 +20,15 @@ Available CLI endpoints are dynamically defined by the config file
 - **TaskOutput usage**: Only use `TaskOutput({ task_id: "xxx", block: false })` + sleep loop to poll completion status. NEVER read intermediate output during agent/CLI execution - wait for final result only
 
 ### CLI Tool Calls (ccw cli)
-- **Default: Use Bash `run_in_background: true`** - Unless otherwise specified, always execute CLI calls in background using Bash tool's background mode:
+- **Default**: CLI calls (`ccw cli`) default to background execution (`run_in_background: true`):
   ```
   Bash({
     command: "ccw cli -p '...' --tool gemini",
     run_in_background: true  // Bash tool parameter, not ccw cli parameter
   })
   ```
-- **After CLI call**: Stop output immediately - let CLI execute in background. **DO NOT use TaskOutput polling** - wait for hook callback to receive results
+- **CRITICAL — Agent-specific instructions ALWAYS override this default.** If an agent's definition file (`.claude/agents/*.md`) specifies `run_in_background: false`, that instruction takes highest priority. Subagents (Task tool agents) CANNOT receive hook callbacks, so they MUST use `run_in_background: false` for CLI calls that produce required results.
+- **After CLI call (main conversation only)**: Stop output immediately - let CLI execute in background. **DO NOT use TaskOutput polling** - wait for hook callback to receive results
 
 ### CLI Analysis Calls
 - **Wait for results**: MUST wait for CLI analysis to complete before taking any write action. Do NOT proceed with fixes while analysis is running
diff --git a/docs/.vitepress/theme/styles/custom.css b/docs/.vitepress/theme/styles/custom.css
index c0188288..0943d034 100644
--- a/docs/.vitepress/theme/styles/custom.css
+++ b/docs/.vitepress/theme/styles/custom.css
@@ -232,7 +232,7 @@
   font-size: var(--vp-font-size-base);
   line-height: var(--vp-line-height-relaxed);
   margin: var(--vp-spacing-5) 0;
-  max-width: var(--vp-prose-width);
+  max-width: 100%;
 }
 
 /* Lists with proper spacing */
@@ -242,7 +242,7 @@
   line-height: var(--vp-line-height-relaxed);
   margin: var(--vp-spacing-5) 0;
   padding-left: var(--vp-spacing-6);
-  max-width: var(--vp-prose-width);
+  max-width: 100%;
 }
 
 .vp-doc li {
@@ -837,3 +837,86 @@ textarea:focus-visible {
     padding: 0 !important;
   }
 }
+
+/*
+ * ===================================================================
+ *  智能响应式内容宽度方案 (Intelligent Responsive Content Width)
+ * ===================================================================
+ *  目的: 根据视口宽度动态调整内容区域占比，优化空间利用。
+ *  原理: 使用rem单位的padding，在不同视口宽度下提供合适的留白。
+ *        窄屏使用较小padding，超宽屏使用较大padding。
+ */
+
+/* 步骤1: 在所有桌面视图下，让.container可以填满父级空间 */
+@media (min-width: 1024px) {
+  .VPDoc.has-aside .container {
+    max-width: none !important;
+    width: 100% !important;
+    margin: 0 !important;
+    padding: 0 var(--vp-spacing-8) !important;
+  }
+  
+  .VPContent.has-sidebar {
+    margin-left: var(--vp-sidebar-width) !important;
+    margin-right: var(--vp-toc-width) !important;
+    width: calc(100vw - var(--vp-sidebar-width) - var(--vp-toc-width)) !important;
+    box-sizing: border-box;
+  }
+}
+
+/* 窄屏 (1024px - 1439px): 使用2rem padding */
+@media (min-width: 1024px) and (max-width: 1439px) {
+  .VPContent.has-sidebar {
+    padding-left: 2rem !important;
+    padding-right: 2rem !important;
+  }
+}
+
+/* 标准宽屏 (1440px - 1919px): 使用3rem padding */
+@media (min-width: 1440px) and (max-width: 1919px) {
+  .VPContent.has-sidebar {
+    padding-left: 3rem !important;
+    padding-right: 3rem !important;
+  }
+}
+
+/* 超宽屏 (>= 1920px): 使用5rem padding */
+@media (min-width: 1920px) {
+  .VPContent.has-sidebar {
+    padding-left: 5rem !important;
+    padding-right: 5rem !important;
+  }
+}
+
+/* ============================================
+ * Widen Doc Content to Fill Container
+ * ============================================ */
+/*
+ * Overrides VitePress's default readability width limit for .vp-doc
+ * and .content-container on desktop layouts, allowing content to use
+ * the full available space defined by the responsive padding in the
+ * "Intelligent Responsive Content Width" section.
+ */
+@media (min-width: 1024px) {
+  /* Expand .content to fill available space */
+  .VPDoc.has-aside .container .content {
+    flex-grow: 1 !important;
+    max-width: none !important;
+  }
+
+  /* Use multiple selectors to increase specificity and override scoped styles */
+  .VPDoc.has-aside .container .content-container,
+  .VPDoc.has-aside .content-container[class],
+  .content-container {
+    max-width: none !important;
+    width: 100% !important;
+    min-width: 100% !important;
+    flex-grow: 1 !important;
+    flex-basis: 100% !important;
+  }
+
+  .vp-doc {
+    max-width: 100% !important;
+    width: 100% !important;
+  }
+}
diff --git a/docs/.vitepress/theme/styles/mobile.css b/docs/.vitepress/theme/styles/mobile.css
index 5af3a6fa..450f6de6 100644
--- a/docs/.vitepress/theme/styles/mobile.css
+++ b/docs/.vitepress/theme/styles/mobile.css
@@ -692,8 +692,8 @@
   /* Ensure content has proper margin-left to clear the sidebar */
   .VPContent.has-sidebar {
     margin-left: var(--vp-sidebar-width) !important;
-    margin-right: calc(var(--vp-toc-width) + 3rem) !important; /* 48px = 3rem */
-    padding: var(--vp-spacing-8) var(--vp-spacing-12) !important;
+    margin-right: var(--vp-toc-width) !important;
+    /* padding moved to custom.css for responsive width control */
   }
 
   /* Adjust doc container - allow content to scale with zoom */