---
allowed-tools: [Read, Write, Glob]
description: Analyzes user-submitted research data, provides insights, and suggests the next research step.
---

# Analyze Research Data

## Context
- **User Request:** $ARGUMENTS
- **Session Name/Index:** Passed via `--name` argument.
- **Session State File:** `_session-state.json` within the specified session directory.

## Goal
To analyze the latest research file(s) submitted by the user within a specific MRD session, generate a summary of insights, and propose the next logical research task to continue the workflow.

## Process
1.  **Identify Target Session:**
    -   Use the `--name` argument to locate the correct session directory (e.g., `.taskmaster/docs/mrd/001-mvp-launch/`).

2.  **Read Session State:**
    -   Read the `_session-state.json` file to understand the current context.
    -   Identify the `lastAnalyzedFile` to determine which new files need to be processed.

3.  **Find and Analyze New Research:**
    -   Scan the session directory for any `0*_*.md` files created or modified after `lastAnalyzedFile`.
    -   Read the content of the new research file(s).

4.  **Generate AI Summary:**
    -   Analyze the research content to extract key findings, patterns, opportunities, and threats.
    -   Create or update a corresponding summary file named `_summary_[topic].md` (e.g., `_summary_market_and_persona.md`). This provides a digestible, AI-driven analysis for the user.

5.  **Update Session State with Intelligent Next Action:**
    -   Update the `_session-state.json` file:
        -   Set `status` to `analysis_in_progress`.
        -   Update `lastAnalyzedFile` to the name of the file just analyzed.
    -   **Formulate the `nextAction`:**
        -   The AI must first review all existing `0*_*` research files in the session directory to understand which topics from the "Standard Research Topics" list below have already been covered.
        -   Based on the analysis of the current file and the list of completed topics, the AI will determine the next logical, uncovered research area.
        -   It will then formulate a clear, actionable `nextAction` string.

    **Standard Research Topics (in logical order):**
    1.  **Initial Hypothesis (`01_initial_hypothesis.md`)**: Core problem, target audience, proposed solution.
    2.  **Market & Persona Analysis (`02_market_and_persona.md`)**: Market size, segments, user demographics, needs, and pain points.
    3.  **Competitive Landscape (`03_competitor_analysis.md`)**: Direct/indirect competitors, SWOT analysis, market positioning.
    4.  **Value Proposition & Solution (`04_value_proposition.md`)**: Detailed breakdown of the solution, unique selling points, feature ideas.
    5.  **Pricing & Business Model (`05_pricing_analysis.md`)**: Revenue streams, pricing strategies, cost analysis.
    6.  **Go-to-Market Strategy (`06_go_to_market.md`)**: Marketing channels, sales process, initial customer acquisition plan.
    7.  **Success Metrics & KPIs (`07_success_metrics.md`)**: How to measure product success.

6.  **Report to User with Context and Next Research Prompt:**
    -   Present a concise summary of the analysis from the current research file.
    -   Clearly state the next logical research task and the filename for the output.
    -   **Crucially**, generate a new, updated, self-contained research prompt for this next task. This prompt must synthesize all relevant context from the *entire session* so far (i.e., from `01_...` up to the latest `_summary_...` file).

    **Updated Research Prompt Generation Template:**
    The AI will use all existing session files (`0*_*` and `_summary_*`) to construct a prompt like this:
    ```
    ### Research Prompt: [Objective of the NEXT Task]

    **1. Project Context (Updated):**
       - **Product/Idea:** [e.g., "A platform connecting eco-friendly suppliers with small businesses."]
       - **Key Findings So Far:**
         - [Insight from summary_market_and_persona.md: e.g., "Identified a key persona 'Eco-conscious Cafe Owner' who values supply chain transparency."]
         - [Insight from summary_competitor_analysis.md: e.g., "Major competitors focus on large enterprises, leaving a gap in the SMB market."]
         - [Latest insight...]

    **2. Research Objective:**
       - [A clear goal for the NEXT research task, e.g., "To define a compelling value proposition and initial feature set based on our market and competitor analysis."]

    **3. Key Research Questions:**
       - [A list of 3-5 specific questions for the next task. For value proposition, it could be:]
         - Based on the key findings, what is our unique value proposition?
         - What core features must we build to deliver this value to our target persona?
         - How can we differentiate ourselves from the identified competitors?

    **4. Expected Deliverables:**
        - A clear statement of the value proposition.
        - A prioritized list of core features.
        - An explanation of the differentiation strategy.
    ```

    -   **Conclude with a clear call to action:**
        -   Instruct the user to run the same `/planning/mrd/2-analyze-research-data` command after creating the next research file.
        -   **Crucially**, emphasize that they must use the **current session name or index** for the `--name` parameter, as the command always analyzes the latest progress within the *current session*.
        -   **Example Conclusion:** "Once you have completed this research and saved it to `04_value_proposition.md`, please run `/planning/mrd/2-analyze-research-data --name"` again to analyze the new data."

## Example Usage
-   **Analyze the latest research in a session:**
    `/planning/mrd/2-analyze-research-data --name="mvp-launch"`
-   **Analyze by index:**
    `/planning/mrd/2-analyze-research-data --name="1"`