tst-claude-code-samples/.claude/commands/planning/1-mrd/2-analyze-research-data.md

allowed-tools, description

allowed-tools	description
Read Write Glob	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"