ADR Manager

About

The ADR Manager skill streamlines architectural documentation by managing Architecture Decision Record files within your project. It automatically determines sequential numbering, enforces the Michael Nygard template structure, and ensures that critical context, decisions, and consequences are captured during the development process. By integrating documentation directly into the coding workflow, it helps teams maintain a clear history of 'why' specific paths were chosen, reducing technical debt and making it easier for future maintainers to understand the evolution of the codebase.

Key Features

• Guidelines for identifying significant architectural decisions versus routine implementation
• Automated sequential numbering for new ADR entries
• Intelligent capture of context, status, decisions, and consequences
• 10 GitHub stars
• Support for artifact build links for enhanced traceability
• Standardized Michael Nygard ADR template implementation

Use Cases

• Capturing deviations from original plans to provide historical context for future maintainers
• Recording the rationale for selecting a specific database or framework over alternatives
• Documenting structural trade-offs made during a major system refactor