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

Aprendizaje y Documentación

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

Acerca de

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

Comprehensive Michael Nygard ADR templates including context, decision, and consequences
Full-text and regex-based search capabilities across the entire decision history
Automated ADR creation with 4-digit sequential zero-padded numbering
Automated status management for proposed, accepted, deprecated, and superseded decisions
0 GitHub stars
Built-in decision matrix templates for evaluating and scoring multiple technical options

Casos de Uso

Onboarding new team members by providing a searchable, chronological index of all major technical choices
Managing technical debt by formalizing the transition when a legacy architecture is superseded by a new standard
Documenting the rationale for choosing specific databases, frameworks, or cloud providers during initial project setup

Acerca de

Características Principales

Comprehensive Michael Nygard ADR templates including context, decision, and consequences
Full-text and regex-based search capabilities across the entire decision history
Automated ADR creation with 4-digit sequential zero-padded numbering
Automated status management for proposed, accepted, deprecated, and superseded decisions
0 GitHub stars
Built-in decision matrix templates for evaluating and scoring multiple technical options

Casos de Uso

Onboarding new team members by providing a searchable, chronological index of all major technical choices
Managing technical debt by formalizing the transition when a legacy architecture is superseded by a new standard
Documenting the rationale for choosing specific databases, frameworks, or cloud providers during initial project setup