mcp-adr-analysis-server

# 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-10-16 **Total Research Topics**: 50 ## Quick Stats - **Planned**: 13 - **In Progress**: 13 - **Completed**: 12 - **Cancelled**: 12 ## Research by Status ### 🔄 In Progress - [Research Topic 1](./perform_research_research_001.md) (high priority) - [Research Topic 5](./perform_research_research_005.md) (high priority) - [Research Topic 9](./perform_research_research_009.md) (high priority) - [Research Topic 13](./perform_research_research_013.md) (high priority) - [Research Topic 17](./perform_research_research_017.md) (high priority) - [Research Topic 21](./perform_research_research_021.md) (high priority) - [Research Topic 25](./perform_research_research_025.md) (high priority) - [Research Topic 29](./perform_research_research_029.md) (high priority) - [Research Topic 33](./perform_research_research_033.md) (high priority) - [Research Topic 37](./perform_research_research_037.md) (high priority) - [Research Topic 41](./perform_research_research_041.md) (high priority) - [Research Topic 45](./perform_research_research_045.md) (high priority) - [Research Topic 49](./perform_research_research_049.md) (high priority) ### 📋 Planned - [Research Topic 0](./perform_research_research_000.md) (critical priority) - [Research Topic 4](./perform_research_research_004.md) (critical priority) - [Research Topic 8](./perform_research_research_008.md) (critical priority) - [Research Topic 12](./perform_research_research_012.md) (critical priority) - [Research Topic 16](./perform_research_research_016.md) (critical priority) - [Research Topic 20](./perform_research_research_020.md) (critical priority) - [Research Topic 24](./perform_research_research_024.md) (critical priority) - [Research Topic 28](./perform_research_research_028.md) (critical priority) - [Research Topic 32](./perform_research_research_032.md) (critical priority) - [Research Topic 36](./perform_research_research_036.md) (critical priority) - [Research Topic 40](./perform_research_research_040.md) (critical priority) - [Research Topic 44](./perform_research_research_044.md) (critical priority) - [Research Topic 48](./perform_research_research_048.md) (critical priority) ### ✅ Completed - [Research Topic 2](./perform_research_research_002.md) (medium priority) - [Research Topic 6](./perform_research_research_006.md) (medium priority) - [Research Topic 10](./perform_research_research_010.md) (medium priority) - [Research Topic 14](./perform_research_research_014.md) (medium priority) - [Research Topic 18](./perform_research_research_018.md) (medium priority) - [Research Topic 22](./perform_research_research_022.md) (medium priority) - [Research Topic 26](./perform_research_research_026.md) (medium priority) - [Research Topic 30](./perform_research_research_030.md) (medium priority) - [Research Topic 34](./perform_research_research_034.md) (medium priority) - [Research Topic 38](./perform_research_research_038.md) (medium priority) - [Research Topic 42](./perform_research_research_042.md) (medium priority) - [Research Topic 46](./perform_research_research_046.md) (medium priority) ### ❌ Cancelled - [Research Topic 3](./perform_research_research_003.md) (low priority) - [Research Topic 7](./perform_research_research_007.md) (low priority) - [Research Topic 11](./perform_research_research_011.md) (low priority) - [Research Topic 15](./perform_research_research_015.md) (low priority) - [Research Topic 19](./perform_research_research_019.md) (low priority) - [Research Topic 23](./perform_research_research_023.md) (low priority) - [Research Topic 27](./perform_research_research_027.md) (low priority) - [Research Topic 31](./perform_research_research_031.md) (low priority) - [Research Topic 35](./perform_research_research_035.md) (low priority) - [Research Topic 39](./perform_research_research_039.md) (low priority) - [Research Topic 43](./perform_research_research_043.md) (low priority) - [Research Topic 47](./perform_research_research_047.md) (low priority) ## Research by Category ### Category-0 - [Research Topic 0](./perform_research_research_000.md) (planned, critical priority) - [Research Topic 5](./perform_research_research_005.md) (in_progress, high priority) - [Research Topic 10](./perform_research_research_010.md) (completed, medium priority) - [Research Topic 15](./perform_research_research_015.md) (cancelled, low priority) - [Research Topic 20](./perform_research_research_020.md) (planned, critical priority) - [Research Topic 25](./perform_research_research_025.md) (in_progress, high priority) - [Research Topic 30](./perform_research_research_030.md) (completed, medium priority) - [Research Topic 35](./perform_research_research_035.md) (cancelled, low priority) - [Research Topic 40](./perform_research_research_040.md) (planned, critical priority) - [Research Topic 45](./perform_research_research_045.md) (in_progress, high priority) ### Category-1 - [Research Topic 1](./perform_research_research_001.md) (in_progress, high priority) - [Research Topic 6](./perform_research_research_006.md) (completed, medium priority) - [Research Topic 11](./perform_research_research_011.md) (cancelled, low priority) - [Research Topic 16](./perform_research_research_016.md) (planned, critical priority) - [Research Topic 21](./perform_research_research_021.md) (in_progress, high priority) - [Research Topic 26](./perform_research_research_026.md) (completed, medium priority) - [Research Topic 31](./perform_research_research_031.md) (cancelled, low priority) - [Research Topic 36](./perform_research_research_036.md) (planned, critical priority) - [Research Topic 41](./perform_research_research_041.md) (in_progress, high priority) - [Research Topic 46](./perform_research_research_046.md) (completed, medium priority) ### Category-2 - [Research Topic 2](./perform_research_research_002.md) (completed, medium priority) - [Research Topic 7](./perform_research_research_007.md) (cancelled, low priority) - [Research Topic 12](./perform_research_research_012.md) (planned, critical priority) - [Research Topic 17](./perform_research_research_017.md) (in_progress, high priority) - [Research Topic 22](./perform_research_research_022.md) (completed, medium priority) - [Research Topic 27](./perform_research_research_027.md) (cancelled, low priority) - [Research Topic 32](./perform_research_research_032.md) (planned, critical priority) - [Research Topic 37](./perform_research_research_037.md) (in_progress, high priority) - [Research Topic 42](./perform_research_research_042.md) (completed, medium priority) - [Research Topic 47](./perform_research_research_047.md) (cancelled, low priority) ### Category-3 - [Research Topic 3](./perform_research_research_003.md) (cancelled, low priority) - [Research Topic 8](./perform_research_research_008.md) (planned, critical priority) - [Research Topic 13](./perform_research_research_013.md) (in_progress, high priority) - [Research Topic 18](./perform_research_research_018.md) (completed, medium priority) - [Research Topic 23](./perform_research_research_023.md) (cancelled, low priority) - [Research Topic 28](./perform_research_research_028.md) (planned, critical priority) - [Research Topic 33](./perform_research_research_033.md) (in_progress, high priority) - [Research Topic 38](./perform_research_research_038.md) (completed, medium priority) - [Research Topic 43](./perform_research_research_043.md) (cancelled, low priority) - [Research Topic 48](./perform_research_research_048.md) (planned, critical priority) ### Category-4 - [Research Topic 4](./perform_research_research_004.md) (planned, critical priority) - [Research Topic 9](./perform_research_research_009.md) (in_progress, high priority) - [Research Topic 14](./perform_research_research_014.md) (completed, medium priority) - [Research Topic 19](./perform_research_research_019.md) (cancelled, low priority) - [Research Topic 24](./perform_research_research_024.md) (planned, critical priority) - [Research Topic 29](./perform_research_research_029.md) (in_progress, high priority) - [Research Topic 34](./perform_research_research_034.md) (completed, medium priority) - [Research Topic 39](./perform_research_research_039.md) (cancelled, low priority) - [Research Topic 44](./perform_research_research_044.md) (planned, critical priority) - [Research Topic 49](./perform_research_research_049.md) (in_progress, high 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.