# Research Documentation Index

This directory contains all research documentation for the project. Each research topic has its own `perform_research_*.md` file with detailed tracking and findings.

**Last Updated**: 2025-12-15  
**Total Research Topics**: 4

## Quick Stats

- **Planned**: 1
- **In Progress**: 1
- **Completed**: 1
- **Cancelled**: 1

## Research by Status

### 🔄 In Progress

- [Performance Analysis](./perform_research_research_001.md) (high priority)

### 📋 Planned

- [Security Assessment](./perform_research_research_002.md) (critical priority)

### ✅ Completed

- [Architecture Review](./perform_research_research_003.md) (medium priority)

### ❌ Cancelled

- [Cancelled Research](./perform_research_research_004.md) (low priority)

## Research by Category

### Performance

- [Performance Analysis](./perform_research_research_001.md) (in_progress, high priority)

- [Cancelled Research](./perform_research_research_004.md) (cancelled, low priority)

### Security

- [Security Assessment](./perform_research_research_002.md) (planned, critical priority)

### Architecture

- [Architecture Review](./perform_research_research_003.md) (completed, medium priority)

## Research Guidelines

### Creating New Research

1. Use the `generate_research_questions` MCP tool to create research questions
2. Create a new `perform_research_*.md` file using the research documentation utilities
3. Update this index file to include the new research
4. Begin research execution following the documented methodology

### Research Process

1. **Planning**: Define questions, methodology, and timeline
2. **Execution**: Collect data and conduct analysis
3. **Documentation**: Record findings with evidence and confidence levels
4. **Review**: Peer review and validation of findings
5. **Communication**: Share findings with stakeholders
6. **Implementation**: Apply recommendations and track outcomes

### Quality Standards

- All findings must include confidence levels and supporting evidence
- Research methodology must be clearly documented
- Regular progress updates are required
- Peer review is mandatory for critical findings
- All research must link to relevant ADRs and architectural decisions

### Documentation Standards

- Use the provided research document template
- Include clear research questions and methodology
- Document all findings with dates and confidence levels
- Provide actionable recommendations with implementation guidance
- Link to relevant ADRs and external references

## Research Tools

### MCP Tools Available

- `generate_research_questions`: Generate context-aware research questions
- `analyze_environment`: Analyze environment context for research
- `generate_rules`: Generate architectural rules from research findings

### Research Methodologies

- Literature review and analysis
- Experimental validation and testing
- Prototype development and evaluation
- Stakeholder interviews and surveys
- Architectural analysis and modeling

## Knowledge Management

### Research Findings Integration

- Update relevant ADRs with research findings
- Create new ADRs based on research recommendations
- Update architectural documentation with new insights
- Share findings through team knowledge sharing sessions

### Research Archive

- Completed research is archived but remains accessible
- Research findings are integrated into project knowledge base
- Lessons learned are documented for future research
- Research methodologies are refined based on experience

---

**Research Coordination**: [Assign research coordinator]  
**Next Review**: [Schedule regular research review meetings]  
**Knowledge Sharing**: [Plan knowledge sharing sessions]

For questions about research processes or to propose new research topics, please contact the research coordinator or create an issue in the project repository.
