mad-adr

What problem does it solve?

This Skill eliminates the risk of losing critical context and rationale for significant technical decisions, ensuring teams can easily reference past choices, avoid repeating work, and maintain a clear audit trail of architectural choices.

Core Features & Use Cases

• MADR 4.0 Compliant ADR Management: Create, list, and update Architecture Decision Records that follow the industry-standard MADR 4.0 format, including mandatory context, decision, and consequences sections plus optional RACI metadata for stakeholder tracking.
• Decision Lifecycle Tracking: Manage full ADR status transitions (Proposed → Accepted → Rejected → Deprecated → Superseded) to keep decision records accurate as projects evolve and requirements change.
• Use Case: When your engineering team is selecting a new inter-service messaging tool, use this Skill to document the decision rationale, alternatives evaluated, and team stakeholders consulted, so future team members can understand the choice without digging through old chat logs or meeting notes.

Quick Start

Use the mad-adr skill to create a new Architecture Decision Record for the decision to adopt EventBridge for inter-service messaging in your project.