Architectural Decision Records (ADRs)
This directory contains the Architectural Decision Records for the MCP ADR Analysis Server project.
ADR Index
| ADR | Title | Status | Date | Category |
|---|---|---|---|---|
| ADR-001 | MCP Protocol Implementation Strategy | Accepted | 2024-01-15 | Architecture |
| ADR-002 | AI Integration and Advanced Prompting Strategy | Accepted | 2024-01-15 | AI/ML |
| ADR-003 | Memory-Centric Architecture | Accepted | 2024-01-15 | Architecture |
| ADR-004 | Security and Content Masking Strategy | Accepted | 2024-01-15 | Security |
| ADR-005 | Testing and Quality Assurance Strategy | Accepted | 2024-01-15 | Quality |
| ADR-006 | Tree-Sitter Integration Strategy | Accepted | 2024-01-15 | Architecture |
| ADR-007 | CI/CD Pipeline Strategy | Accepted | 2024-01-15 | DevOps |
| ADR-008 | Development Workflow Strategy | Accepted | 2024-01-15 | Process |
| ADR-009 | Package Distribution Strategy | Accepted | 2024-01-15 | Distribution |
Legacy ADRs (Sample Project)
The following ADRs exist in the sample-project/././adrs/ directory and serve as examples:
| ADR | Title | Status | Category |
|---|---|---|---|
| 001 | Database Architecture Selection | Accepted | Database |
| 002 | API Authentication Strategy | Proposed | Security |
| 003 | Legacy Data Migration Strategy | Deprecated | Migration |
ADR Categories
Architecture
- ADR-001: MCP Protocol Implementation Strategy
- ADR-003: Memory-Centric Architecture
- ADR-006: Tree-Sitter Integration Strategy
AI/ML
- ADR-002: AI Integration and Advanced Prompting Strategy
Security
- ADR-004: Security and Content Masking Strategy
Quality
- ADR-005: Testing and Quality Assurance Strategy
DevOps
- ADR-007: CI/CD Pipeline Strategy
Process
- ADR-008: Development Workflow Strategy
Distribution
- ADR-009: Package Distribution Strategy
ADR Template
We use the NYGARD template for our ADRs:
# ADR-XXX: [Title]
## Status
[Proposed | Accepted | Deprecated | Superseded]
## Context
[Description of the problem and context]
## Decision
[Description of the architectural decision]
## Consequences
**Positive:**
- [Positive consequence 1]
- [Positive consequence 2]
**Negative:**
- [Negative consequence 1]
- [Negative consequence 2]
Contributing
When creating new ADRs:
- Use the next available ADR number
- Follow the NYGARD template format
- Include clear context, decision, and consequences
- Update this README.md index
- Link related ADRs where appropriate
Tools
This project includes MCP tools for ADR management:
mcp0_discover_existing_adrs: Discover and catalog existing ADRsmcp0_suggest_adrs: Suggest new ADRs based on code analysismcp0_generate_adr_from_decision: Generate ADRs from decision datamcp0_review_existing_adrs: Review ADRs against implementationmcp0_generate_adr_todo: Generate implementation tasks from ADRs