Research Source Evaluator

Find a research source in report_notes/, analyze its content (purpose, tables, charts, key findings), and create a Linear issue for implementation.

Usage

bash

# By source ID from research.csv
/research-evaluate RS-006

# By search query
/research-evaluate "mean reversion currencies"

# By file path
/research-evaluate report_notes/fx_seasonality_research/sources/quantpedia/002_mean_reversion_currencies.md

Workflow

Step 1: Find the Source

bash

# If ID provided, look up in research.csv
grep "^$ID," /home/adesola/EpochDev/ClaudeCodeResearch/research.csv

# If query provided, search sources
grep -ri "$QUERY" /home/adesola/EpochDev/ClaudeCodeResearch/report_notes/*/sources/

Step 2: Read and Analyze the Source

Read the markdown file and extract:

•Frontmatter - URL, title, domain, crawl date
•Hypothesis - Main research question/thesis
•Data Requirements - Assets, timeframes, data sources needed
•Methodology - How the strategy/analysis works
•Key Metrics - Performance figures, statistics mentioned
•Charts/Tables - Visual elements and their purpose

python

# Example analysis structure
{
    "source_id": "RS-006",
    "title": "How to Build Mean Reversion Strategies in Currencies",
    "url": "https://quantpedia.com/...",
    "hypothesis": "Long undervalued and short overvalued currencies generates alpha",
    "data_requirements": {
        "assets": ["AD1", "BF1", "CD1", "EC1", "SF1", "JY1"],
        "asset_type": "FX futures",
        "timeframe": "daily",
        "period": "2007-2024"
    },
    "methodology": {
        "signal": "Deviation from average cumulative return",
        "long": "Currencies below average (undervalued)",
        "short": "Currencies above average (overvalued)",
        "rebalancing": "Monthly",
        "position_sizing": ["linear", "exponential"]
    },
    "key_metrics": {
        "sharpe": 0.XX,
        "annual_return": "X%",
        "max_drawdown": "-X%"
    },
    "charts": [
        {"name": "Cumulative returns", "purpose": "Shows mean reversion tendency"},
        {"name": "Strategy performance", "purpose": "Backtest equity curve"}
    ],
    "tables": [
        {"name": "Position sizing comparison", "purpose": "Linear vs exponential results"}
    ]
}

Step 3: Check for Existing Issues

python

mcp__linear__linear_searchIssues(
    query="$TITLE",
    projectId="aedc87b9-3cee-4bdb-95ef-ac3d49e1218f",  # Quantitative Research
    limit=5
)

Step 4: Create Linear Issue

python

mcp__linear__linear_createIssue(
    teamId="53f03fc6-d769-481a-b0f6-f7d6f8ab8085",
    projectId="aedc87b9-3cee-4bdb-95ef-ac3d49e1218f",  # Quantitative Research
    priority=3,
    title="Research: $TITLE",
    description="""## Summary

$HYPOTHESIS

**Source:** [$TITLE]($URL)
**Source ID:** $SOURCE_ID

## Data Requirements

- **Assets:** $ASSETS
- **Timeframe:** $TIMEFRAME
- **Period:** $PERIOD

## Methodology

$METHODOLOGY_DESCRIPTION

## Key Findings from Source

$KEY_METRICS_AND_FINDINGS

## Charts to Reproduce

$CHARTS_LIST

## Tables to Reproduce

$TABLES_LIST

## Implementation Tasks

- [ ] Create research definition
- [ ] Configure data sources
- [ ] Implement signal generation
- [ ] Run study
- [ ] Analyze results
- [ ] Compare with source findings

## Reference

- Source file: `$FILE_PATH`
- Research CSV: `research.csv` row $SOURCE_ID
"""
)

Step 5: Update research.csv

Update the status and linear_issue columns:

python

# Change status from PENDING to TODO
# Add Linear issue ID

Output

After evaluation:

•Linear issue created with full analysis
•research.csv updated with issue link
•
Summary printed showing:
- •Source details
- •Key hypothesis
- •Data requirements
- •Issue URL

Issue Description Template

markdown

## Summary

[1-2 sentence hypothesis from the research source]

**Source:** [Title](URL)
**Source ID:** RS-XXX

## Data Requirements

- **Assets:** [list assets]
- **Timeframe:** [daily/hourly/etc]
- **Period:** [date range]

## Methodology

[Description of how the strategy/analysis works]

## Key Findings from Source

| Metric | Value |
|--------|-------|
| Sharpe | X.XX |
| Annual Return | X% |
| Max Drawdown | -X% |

## Charts to Reproduce

1. [Chart name] - [purpose]
2. [Chart name] - [purpose]

## Tables to Reproduce

1. [Table name] - [purpose]

## Implementation Tasks

- [ ] Create research definition
- [ ] Configure data sources
- [ ] Implement signal generation
- [ ] Run study
- [ ] Analyze results
- [ ] Compare with source findings

## Reference

- Source file: `report_notes/.../file.md`
- Research CSV: `research.csv` row RS-XXX