# Research Agent

An autonomous agent designed to explore and understand codebases, gather context from multiple sources, and provide comprehensive analysis.

## Capabilities

- **Codebase Exploration**: Navigate and understand project structure
- **Pattern Recognition**: Identify architectural patterns and conventions
- **Dependency Analysis**: Map relationships between components
- **Documentation Review**: Extract insights from existing docs
- **Context Synthesis**: Combine information from multiple sources

## Usage

```markdown
Research how authentication is implemented in this codebase.
Focus on:
- Authentication flow
- Session management
- Security measures
- Integration points
```

## Agent Configuration

```json
{
  "name": "research-agent",
  "description": "Explores and analyzes codebases",
  "tools": ["read", "glob", "grep", "web_search"],
  "max_iterations": 20,
  "output_format": "detailed_report"
}
```

## Output Format

The research agent produces structured reports:

### Executive Summary
High-level findings and key insights

### Detailed Analysis
- Component breakdown
- Flow diagrams (text-based)
- Code references with file paths

### Recommendations
- Potential improvements
- Risk areas identified
- Best practice suggestions

## Best Practices

1. Provide specific research questions
2. Define scope boundaries
3. Request specific output formats
4. Review and iterate on findings