Is a formal proposal required to create an ADR?

No, while the skill can link to accepted proposals, it also supports a standalone mode for recording decisions that did not go through a formal proposal process.

What is an ADR in the context of this skill?

An ADR (Architectural Decision Record) is a document that captures an important architectural decision, including its context and consequences, as part of a permanent project record.

How does the skill determine the next ADR number?

The skill executes a local script that scans your decisions directory to find the highest current number and automatically assigns the next sequential integer.

Where does the skill get the document format from?

It uses a standardized decision template located at 'templates/decision.md' within your repository to ensure all records follow your team's specific format.

Can I edit an ADR after it has been accepted?

No, ADRs are designed to be immutable records of a point in time. The only permitted modification is updating the 'superseded_by' field when a newer decision replaces it.

Architectural Decision Record Creator

Name: Architectural Decision Record Creator
Author: alexnodeland

byalexnodeland

•

Aprendizaje y Documentación

Automates the creation and management of Architectural Decision Records to document key technical choices and their rationale.

The Architectural Decision Record (ADR) Creator skill streamlines the technical documentation process by generating standardized ADR files based on project templates. It manages the entire decision lifecycle by handling automatic sequence numbering, linking to accepted proposals, and managing supersessions where new decisions replace old ones. By enforcing ADR immutability and providing structured frontmatter, this skill ensures that development teams maintain a clear, auditable, and consistent history of their software architecture directly within the repository.

Características Principales

01Automated ADR numbering and template-based file generation

02Structured frontmatter generation including author, status, and timestamps

033 GitHub stars

04Direct linking to accepted proposals for seamless intent-to-decision transitions

05Built-in supersession handling to update older records automatically

06Enforcement of documentation immutability to preserve historical context

Casos de Uso

01Documenting significant changes in software architecture or technology stacks

02Maintaining a versioned and searchable history of architectural evolution

03Transitioning accepted design proposals into formal, immutable decision records

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled new-adr

For use in Claude.ai and ChatGPT