generated from Paul.Kim/tpl-superclaude
91 lines
5.7 KiB
Markdown
91 lines
5.7 KiB
Markdown
---
|
|
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"` |