ADR Drafting
Standardizes the creation of Architecture Decision Records to maintain a clear history of technical choices.
The ADR Drafting skill streamlines the process of documenting significant architectural decisions by guiding developers through a structured, spec-driven template. It automatically detects existing repository conventions—such as naming patterns, numbering, and directory structures—to ensure new records remain consistent with the project's established history. By capturing the problem context, chosen approach, and long-term consequences, this skill helps teams prevent technical debt and provides future maintainers with the essential rationale behind complex architectural implementations.
Características Principales
01Standardized template with Status, Context, Decision, and Consequences
02Smart sequential numbering for consistent project history
03Support for custom documentation directories and kebab-case naming
04279 GitHub stars
05Automated discovery of existing repository ADR patterns and locations
06Interactive drafting process with user verification before file creation
Casos de Uso
01Establishing a project's technical history during the initial setup phase
02Documenting the transition to a new primary database or framework
03Capturing the rationale for service boundary changes in microservices