adr

Architecture Decision Records (ADR)

This directory contains Architecture Decision Records for DotNetDevMCP.

What is an ADR?

An Architecture Decision Record (ADR) captures an important architectural decision made along with its context and consequences.

Format

Each ADR follows this structure:

• Title: Short descriptive title
• Status: Proposed | Accepted | Deprecated | Superseded
• Date: When the decision was made
• Context: What is the issue we're seeing that is motivating this decision?
• Decision: What is the change we're proposing and/or doing?
• Consequences: What becomes easier or more difficult to do because of this change?

Index

ID	Title	Status	Date
ADR-001	Fork SharpTools instead of pluggable integration	Accepted	2025-12-30
ADR-002	Prioritize concurrent operations	Accepted	2025-12-30
ADR-003	Implement deep Git integration	Accepted	2025-12-30
ADR-004	Adopt Test-Driven Development	Accepted	2025-12-30
ADR-005	AI-friendly documentation as first-class citizen	Accepted	2025-12-30

Creating a New ADR

1. Copy template.md to a new file with format NNN-short-title.md
2. Fill in the sections
3. Submit for review
4. Update this index

References

• ADR GitHub Organization
• Documenting Architecture Decisions by Michael Nygard