decision-records

What problem does it solve?

This Skill addresses the challenge of losing valuable design rationale by providing a structured way to record, manage, and retrieve Architectural Decision Records (ADRs).

Core Features & Use Cases

• ADR Creation: Generate new ADRs following a standard context/decision/consequences format.
• ADR Querying: Search and retrieve existing ADRs based on various criteria.
• Lifecycle Management: Track the status and evolution of decisions over time.
• Use Case: When your team decides to adopt a new database technology, use this skill to create an ADR documenting why that choice was made, what alternatives were considered, and the expected outcomes. Later, if a similar decision needs to be made, you can easily query past ADRs for historical context.

Quick Start

Create a new architectural decision record with the title "Use PostgreSQL for user data", the context "Need a scalable and reliable database for user profiles", and the decision "Adopt PostgreSQL due to its maturity and feature set".