What problem does it solve?
This skill solves the problem of knowledge loss in software development by providing a structured way to document the "why" behind critical architectural decisions, ensuring that future maintainers understand the context and trade-offs of the current system.
Core Features & Use Cases
- Decision Tracking: Provides a standardized template for recording architectural decisions, including context, decision, and consequences.
- Conflict Resolution: Facilitates the comparison of multiple candidate solutions for complex architectural problems using a weighted scoring approach.
- Lifecycle Management: Supports the evolution of architecture by allowing decisions to be superseded by newer ones, maintaining a clear audit trail of system changes.
Quick Start
Use the adr skill to create a new architectural decision record for the proposed database migration by running the provided python script with the new decision title.