docs: auto-update documentation based on changes in next branch

This PR was automatically generated to update documentation based on recent changes.

  Original commit: Merge pull request #1212 from eyaltoledano/ralph/main/rebase\n\n\n

  Co-authored-by: Claude <claude-assistant@anthropic.com>

apps/docs/best-practices/advanced-tasks.mdx

@@ -128,6 +128,23 @@ You can reorganize tasks in various ways:
 - Moving a task to a new ID position: `--from=5 --to=25` (even if task 25 doesn't exist yet)
 - Moving multiple tasks at once: `--from=10,11,12 --to=16,17,18` (must have same number of IDs, Taskmaster will look through each position)
 
+#### Cross-Tag Move Safety (v0.26.0+)
+
+For moves between different tags, use the enhanced dependency handling:
+
+```bash
+# Move with all dependencies (safest)
+task-master move --from=5 --to=3 --with-dependencies --tag-from=feature --tag-to=main
+
+# Move ignoring dependencies (shows safety tips)
+task-master move --from=5 --to=3 --ignore-dependencies --tag-from=feature --tag-to=main
+```
+
+**Enhanced Safety Features:**
+- **Next Steps Guidance**: After cross-tag moves with `--ignore-dependencies`, the CLI provides "Next Steps" tips with validation and fix guidance
+- **ID Collision Help**: Dedicated help blocks appear when destination tags already have the target ID, with structured suggestions
+- **Better Error Messages**: Task collision errors now include actionable suggestions for resolution
+
 When moving tasks to new IDs:
 
 - The system automatically creates placeholder tasks for non-existent destination IDs

apps/docs/best-practices/configuration-advanced.mdx

@@ -83,9 +83,40 @@ Taskmaster uses two primary methods for configuration:
   - `VERTEX_PROJECT_ID`: Your Google Cloud project ID for Vertex AI. Required when using the 'vertex' provider.
   - `VERTEX_LOCATION`: Google Cloud region for Vertex AI (e.g., 'us-central1'). Default is 'us-central1'.
   - `GOOGLE_APPLICATION_CREDENTIALS`: Path to service account credentials JSON file for Google Cloud auth (alternative to API key for Vertex AI).
+  - `TASKMASTER_ENABLE_CODEBASE_ANALYSIS`: Control codebase analysis features (Claude Code and Gemini CLI integration). Set to 'false' to disable. Default: enabled.
 
 **Important:** Settings like model ID selections (`main`, `research`, `fallback`), `maxTokens`, `temperature`, `logLevel`, `defaultSubtasks`, `defaultPriority`, and `projectName` are **managed in `.taskmaster/config.json`** (or `.taskmasterconfig` for unmigrated projects), not environment variables.
 
+## Codebase Analysis Configuration
+
+Task Master includes advanced codebase analysis features that enhance task generation by analyzing your project structure, existing implementations, and patterns. This is particularly useful when integrated with Claude Code or using Gemini CLI provider.
+
+### Configuration Options
+
+**Environment Variable Control (Priority Order: `.env` > MCP session env > `.taskmaster/config.json`)**
+
+```bash
+# In .env file
+TASKMASTER_ENABLE_CODEBASE_ANALYSIS=false  # Disable codebase analysis features
+```
+
+When enabled, the following commands benefit from codebase analysis:
+
+- `parse-prd`: Generates tasks informed by project structure
+- `analyze-complexity`: Considers existing codebase complexity
+- `add-task`: Creates tasks aligned with project patterns  
+- `update-task`: Updates tasks with relevant codebase context
+- `update-subtask`: Enhances subtasks based on implementation details
+- `expand`: Generates subtasks informed by existing code patterns
+
+### Integration with Claude Code
+
+When Task Master detects it's running within Claude Code, it automatically provides codebase context to generate more accurate and relevant task details. This feature can be disabled using the environment variable above.
+
+### Gemini CLI Provider Enhancement
+
+The Gemini CLI provider includes automatic codebase analysis when generating or updating tasks, resulting in more contextually accurate outputs aligned with your project's architecture.
+
 ## Tagged Task Lists Configuration (v0.17+)
 
 Taskmaster includes a tagged task lists system for multi-context task management.
@@ -147,6 +178,9 @@ PERPLEXITY_API_KEY=pplx-your-key-here
 
 # Google Vertex AI Configuration (Required if using 'vertex' provider)
 # VERTEX_PROJECT_ID=your-gcp-project-id
+
+# Feature Control
+# TASKMASTER_ENABLE_CODEBASE_ANALYSIS=false  # Disable codebase analysis features
 ```
 
 ## Troubleshooting

apps/docs/capabilities/cli-root-commands.mdx

@@ -206,4 +206,25 @@ sidebarTitle: "CLI Commands"
     task-master init
     ```
   </Accordion>
+
+  <Accordion title="Move Tasks">
+    ```bash
+    # Move a task or subtask to a new position
+    task-master move --from=<id> --to=<id>
+    
+    # Move multiple tasks at once (same number of IDs required)
+    task-master move --from=1,2,3 --to=7,8,9
+    
+    # Cross-tag moves with dependency handling
+    task-master move --from=5 --to=3 --with-dependencies --tag-from=feature --tag-to=main
+    task-master move --from=5 --to=3 --ignore-dependencies --tag-from=feature --tag-to=main
+    
+    # Note: --force flag is deprecated, use --with-dependencies or --ignore-dependencies instead
+    ```
+
+    **Cross-tag Move Safety Features:**
+    - CLI shows "Next Steps" guidance after moves that ignore dependencies
+    - Dedicated help is displayed for ID collisions with structured suggestions
+    - Better error handling with actionable suggestions for resolution
+  </Accordion>
 </AccordionGroup>