## Research Task

**Topic**: [What to research]
**Goal**: [What decision/action this enables]
**Constraints**: [Time, scope limitations]
**Output Format**: [Report type needed]
**Success Criteria**: [How we'll know research is sufficient]

# Search internal knowledge bases first
rag_search_knowledge_base(query="specific topic", match_count=5)
rag_search_code_examples(query="implementation pattern", match_count=3)

# Find existing patterns
grep -r "pattern_name" --include="*.ts" --include="*.py"

# Check for prior implementations
find . -name "*keyword*" -type f

# Review configuration patterns
cat config/*.yaml | head -50

## Research Report: [Topic]

### Executive Summary
[2-3 sentence summary of key findings and recommendation]

### Key Findings

#### Finding 1: [Title]
- **What**: [Description]
- **Why It Matters**: [Impact on our decision]
- **Evidence**: [Sources/links]
- **Confidence**: [High/Medium/Low]

#### Finding 2: [Title]
- **What**: [Description]
- **Why It Matters**: [Impact]
- **Evidence**: [Sources]
- **Confidence**: [Level]

### Options Analysis

| Option | Pros | Cons | Effort | Risk |
|--------|------|------|--------|------|
| Option A | Fast, Simple | Limited features | Low | Low |
| Option B | Feature-rich | Complex setup | Medium | Medium |
| Option C | Best performance | Steep learning curve | High | Medium |

### Recommendations

**Recommended Approach**: [Option X]

**Rationale**:
1. [Reason 1]
2. [Reason 2]
3. [Reason 3]

**Alternative if [condition]**: [Option Y]

### Implementation Guide

#### Prerequisites
- [Requirement 1]
- [Requirement 2]

#### Steps
1. [Step 1 with commands/code]
2. [Step 2 with commands/code]
3. [Step 3 with commands/code]

#### Code Example
```[language]
// Example implementation

## Research Templates

### Library/Package Comparison

```markdown
## Library Comparison: [Category]

### Overview

Comparing libraries for [use case].

### Comparison Matrix

| Feature | Option A | Option B | Option C |
|---------|----------|----------|----------|
| GitHub Stars | 15K | 8K | 25K |
| Last Commit | 2 days ago | 1 month ago | 1 week ago |
| Bundle Size | 45KB | 120KB | 30KB |
| TypeScript | Native | Types included | DefinitelyTyped |
| Maintenance | Very Active | Active | Active |
| Learning Curve | Low | Medium | High |
| Documentation | Excellent | Good | Excellent |
| Community | Large | Medium | Large |

### Detailed Analysis

#### Option A: [Name]

**Strengths**:
- [Strength 1]
- [Strength 2]

**Weaknesses**:
- [Weakness 1]
- [Weakness 2]

**Best For**: [Use cases]

**Example Usage**:
```javascript
// Code example

### Architecture Research

```markdown
## Architecture Analysis: [Pattern/System]

### Current State

[How it works now - with diagram if helpful]

### Problem Statement

[Why we're researching alternatives]

### Options Considered

#### Option 1: [Name]

**Description**: [How it works]

**Diagram**:

**Pros**:
- [Pro 1]

**Cons**:
- [Con 1]

**Migration Effort**: [Low/Medium/High]

#### Option 2: [Name]
[Similar structure]

### Recommended Architecture

[Detailed description with diagram]

### Migration Path

1. **Phase 1**: [Description]
   - Duration: [Time]
   - Risk: [Level]

2. **Phase 2**: [Description]
   - Duration: [Time]
   - Risk: [Level]

## Integration Guide: [Service/API]

### Overview

[What the service does and why we need it]

### Authentication

**Method**: [OAuth2/API Key/JWT/etc.]

**Setup Steps**:
1. [Step 1]
2. [Step 2]

**Code Example**:
```python
# Authentication setup

# Full working example

## Research Best Practices

### Information Quality

1. **Verify sources** - Cross-reference claims
2. **Check dates** - Technology moves fast
3. **Test examples** - Run code before recommending
4. **Note versions** - Specify library versions
5. **Acknowledge uncertainty** - Be honest about gaps

### Report Quality

1. **Start with summary** - Busy readers need TL;DR
2. **Use tables** - Easy comparison
3. **Include code** - Concrete examples
4. **Cite sources** - Link to documentation
5. **Make recommendations** - Don't just present options

### Time Management

1. **Time-box research** - Set limits
2. **Prioritize sources** - Official docs first
3. **Document as you go** - Capture sources immediately
4. **Know when to stop** - Diminishing returns

## Output Format for Handoff

When research is complete:

```markdown
## RESEARCH COMPLETE

**Topic**: [Topic]
**Duration**: [Time spent]
**Confidence**: [High/Medium/Low]

### Key Takeaway
[One sentence summary]

### Recommendation
[Clear recommendation with rationale]

### Action Required
[What to do next]

### Full Report
[See detailed report above]

### Questions for Stakeholders
[Any decisions needed before proceeding]