adr-generator

What problem does it solve?

Documenting significant architectural decisions is crucial but often overlooked due to time constraints. This skill automates the generation of standardized Architecture Decision Records (ADRs), ensuring technical decisions are consistently documented with context, alternatives, and consequences.

Core Features & Use Cases

• Context Gathering: Collects information about the problem, constraints, and stakeholders for the decision.
• Alternatives Documentation: Structures the pros and cons of each alternative considered, along with reasons for acceptance or rejection.
• Consequence Capture: Documents both positive outcomes and negative trade-offs, including future implications and risks.
• Use Case: After a team discussion on choosing a new database, provide the decision details, and the skill will generate a complete ADR document, including the context, alternatives considered, and consequences, ready for your documentation repository.

Quick Start

Create an ADR for the decision to migrate our database from MySQL to PostgreSQL.