What is an ADR in this context?

An Architectural Decision Record (ADR) is a document that captures a significant architectural decision, including the context of the problem, the chosen solution, and the consequences of that choice.

Can I automatically update my decision index?

Yes, the 'update-adr-index' script automatically scans your existing ADRs and regenerates a README or index file grouped by decision status (e.g., proposed, accepted, superseded).

What template does this skill use for decisions?

It uses the MADR (Markdown Architecture Decision Records) template, which is a lean, standardized format optimized for readability and version control.

Is this skill useful for solo developers?

Absolutely. While great for teams, solo developers use it to maintain a 'paper trail' of why they made certain technical choices, which is invaluable when returning to a project months later.

How does this skill handle ADR numbering?

The skill includes a 'find-next-adr-number' script that automatically scans your directory to find the next available sequence number, preventing manual errors and collisions.

Decision Tracking & ADR Management

Name: Decision Tracking & ADR Management
Author: vanman2024

byvanman2024

0•

Aprendizaje y Documentación

Manages Architectural Decision Records (ADRs) and logs technical choices using standardized templates and automated numbering.

The Decision Tracking skill streamlines the software architecture process by providing a structured framework for documenting critical technical choices. It automates the creation and organization of Architectural Decision Records (ADRs) using the MADR template, ensuring that the rationale behind every major code change is preserved. With built-in scripts for auto-numbering and index management, it eliminates the manual overhead of maintaining documentation, making it an essential tool for teams who need to track trade-offs and project evolution over time.

Características Principales

010 GitHub stars

02Automatic index generation grouped by decision status

03Standardized MADR (Markdown Architecture Decision Records) templates

04Automated ADR numbering to prevent sequence collisions

05Script-based creation for rapid documentation workflows

06Centralized tracking of technical trade-offs and rationale

Casos de Uso

01Documenting the rationale behind choosing a specific database or framework

02Onboarding new developers by providing a clear history of technical decisions

03Maintaining a searchable index of all major architectural shifts in a repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vanman2024/dev-lifecycle-marketplace decision-tracking

For use in Claude.ai and ChatGPT

Download Skill