Does this skill support the Michael Nygard format?

Yes, it strictly follows the Nygard format, including standard sections for Title, Status, Context, Decision, and Consequences, along with YAML frontmatter.

What is an ADR in this context?

An Architecture Decision Record (ADR) is a short text file that captures an important architectural decision, the context in which it was made, and its eventual consequences.

How does the superseding workflow work?

The skill marks an old ADR as 'superseded' with a link to the new decision, creates a new ADR referencing the old one, and automatically updates the central index to maintain a clear history.

Can I search through my previous architecture decisions?

Yes, the skill includes advanced search scripts that support full-text search and regex patterns to help you find specific decisions, technologies, or keywords across all recorded ADRs.

Decision Tracking & ADR Manager

Name: Decision Tracking & ADR Manager
Author: vanman2024

byvanman2024

0•

Aprendizaje y Documentación

Manages Architecture Decision Records (ADR) with automated numbering, status tracking, and superseding workflows to maintain technical rationale.

The Decision Tracking skill provides a robust framework for documenting and managing Architecture Decision Records (ADR) following the industry-standard Michael Nygard format. It automates the tedious aspects of decision logging—such as sequential numbering, index updates, and maintaining the chain of rationale when one decision supersedes another. By integrating these workflows directly into the development lifecycle, this skill ensures that technical rationale is preserved, searchable, and organized, helping teams avoid 'architecture drift' and providing essential context for future developers and stakeholders.

Características Principales

01Comprehensive Michael Nygard ADR templates including context, decision, and consequences

02Full-text and regex-based search capabilities across the entire decision history

03Automated ADR creation with 4-digit sequential zero-padded numbering

04Automated status management for proposed, accepted, deprecated, and superseded decisions

050 GitHub stars

06Built-in decision matrix templates for evaluating and scoring multiple technical options

Casos de Uso

01Onboarding new team members by providing a searchable, chronological index of all major technical choices

02Managing technical debt by formalizing the transition when a legacy architecture is superseded by a new standard

03Documenting the rationale for choosing specific databases, frameworks, or cloud providers during initial project setup

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