Decision Tracking

What problem does it solve?

Important architectural and technical decisions are often made without proper documentation, leading to lost context, repeated discussions, and difficulty onboarding new team members. This skill streamlines the process of tracking and documenting these decisions.

Core Features & Use Cases

• Automated ADR Creation: Provides a script (create-adr.sh) to automatically create new Architecture Decision Records (ADRs) with proper numbering and a standard MADR template.
• Next ADR Number Finder: Includes a script (find-next-adr-number.sh) to mechanically determine the next available ADR number, ensuring unique and sequential records.
• ADR Index Management: Offers a script (update-adr-index.sh) to automatically update an ADR index (e.g., README.md) with all ADRs grouped by their status (Accepted, Proposed, Deprecated).
• Standardized Templates: Provides templates and patterns for consistent decision logging and architectural documentation, promoting clarity.
• Use Case: A tech lead needs to document a critical architectural decision, such as choosing a new database. This skill can automatically generate a new ADR with the correct numbering and a pre-filled template, then update the project's ADR index to reflect this new proposed decision.

Quick Start

Create a new ADR titled 'Use PostgreSQL for Database' in the 'docs/decisions' directory, then update the ADR index to reflect the new proposed decision.