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 #1468 from eyaltoledano/ralph/merge.from.main.0.36.0.p3\n\n\n

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

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

@@ -7,12 +7,21 @@ sidebarTitle: "CLI Commands"
 <AccordionGroup>
   <Accordion title="Parse PRD">
     ```bash
-    # Parse a PRD file and generate tasks
+    # Parse a PRD file and generate tasks locally
     task-master parse-prd <prd-file.txt>
 
     # Limit the number of tasks generated
     task-master parse-prd <prd-file.txt> --num-tasks=10
     ```
+
+    When you run `parse-prd`, you'll be given the option to either:
+    - **Parse locally**: PRD becomes a task list in a local JSON file - great for quick prototyping and working solo
+    - **Bring it to Hamster**: PRD becomes a living brief connected to your team, codebase, and agents for collaborative development
+
+    **Why choose Hamster integration?**
+    - Tasks live in a central place with real-time sync across your team
+    - Collaborate on your PRD/brief together and generate tasks on Hamster
+    - No API keys needed - Hamster handles all AI inference, just need a Hamster account
   </Accordion>
 
   <Accordion title="List Tasks">
@@ -86,7 +95,12 @@ sidebarTitle: "CLI Commands"
     ```bash
     # Generate individual task files from tasks.json
     task-master generate
+
+    # Generate files from a specific tag
+    task-master generate --tag=<tag-name>
     ```
+
+    Generated files are now in Markdown format (`.md`) and follow markdownlint standards for better readability and editor support.
   </Accordion>
 
   <Accordion title="Set Task Status">

apps/docs/capabilities/index.mdx

@@ -85,7 +85,7 @@ The CLI is organized into a series of commands, each with its own set of options
 ### 4. Project and Configuration
 
 -   **`init`**: Initializes a new project.
--   **`generate`**: Generates individual task files.
+-   **`generate`**: Generates individual task files in Markdown format. Supports `--tag` parameter to generate from specific tags.
 -   **`migrate`**: Migrates a project to the new directory structure.
 -   **`research`**: Performs AI-powered research.
     -   `--query <query>`: The research query.
@@ -167,7 +167,7 @@ These functions are crucial for managing the relationships between tasks.
 
 These functions are for managing the project and its configuration.
 
--   **`generateTaskFiles()`**: Generates individual task files from `tasks.json`.
+-   **`generateTaskFiles()`**: Generates individual task files in Markdown format from `tasks.json`.
 -   **`migrateProject()`**: Migrates the project to the new `.taskmaster` directory structure.
 -   **`performResearch(query, options)`**: Performs AI-powered research with project context.
 
@@ -225,7 +225,7 @@ The MCP tools can be categorized in the same way as the core functionalities:
 ### 5. Project and Configuration
 
 -   **`initialize_project`**: Initializes a new project.
--   **`generate`**: Generates individual task files.
+-   **`generate`**: Generates individual task files in Markdown format. Supports `--tag` parameter to generate from specific tags.
 -   **`models`**: Manages AI model configurations.
 -   **`research`**: Performs AI-powered research.
 

apps/docs/command-reference.mdx

@@ -6,12 +6,21 @@ description: "A comprehensive reference of all available Task Master commands"
 <AccordionGroup>
   <Accordion title="Parse PRD">
     ```bash
-    # Parse a PRD file and generate tasks
+    # Parse a PRD file and generate tasks locally
     task-master parse-prd <prd-file.txt>
 
     # Limit the number of tasks generated
     task-master parse-prd <prd-file.txt> --num-tasks=10
     ```
+
+    When you run `parse-prd`, you'll be given the option to either:
+    - **Parse locally**: PRD becomes a task list in a local JSON file - great for quick prototyping and working solo
+    - **Bring it to Hamster**: PRD becomes a living brief connected to your team, codebase, and agents for collaborative development
+
+    **Why choose Hamster integration?**
+    - Tasks live in a central place with real-time sync across your team
+    - Collaborate on your PRD/brief together and generate tasks on Hamster
+    - No API keys needed - Hamster handles all AI inference, just need a Hamster account
   </Accordion>
 
   <Accordion title="List Tasks">
@@ -85,7 +94,12 @@ description: "A comprehensive reference of all available Task Master commands"
     ```bash
     # Generate individual task files from tasks.json
     task-master generate
+
+    # Generate files from a specific tag
+    task-master generate --tag=<tag-name>
     ```
+
+    Generated files are now in Markdown format (`.md`) and follow markdownlint standards for better readability and editor support.
   </Accordion>
 
   <Accordion title="Set Task Status">