Where are the ADR files stored?

By default, this skill manages ADRs located in the doc/adr/ directory of your repository using the .adoc extension.

Can I filter ADRs by their status?

Yes, the list-adrs workflow allows you to filter records by status, such as Proposed, Accepted, Deprecated, or Superseded.

An Architectural Decision Record (ADR) is a document that captures an important architectural decision, including its context, the decision itself, and the resulting consequences.

Does it validate my ADR formatting?

Yes, it integrates with the ref-documentation skill to validate AsciiDoc formatting, link integrity, and content quality.

How does the automatic numbering work?

The skill scans the existing ADR directory to find the highest current number and automatically assigns the next sequential number to new records.

Architectural Decision Records (ADR) Manager

Name: Architectural Decision Records (ADR) Manager
Author: cuioss

bycuioss

学習とドキュメンテーション

Manages the lifecycle of architectural decision records with automated numbering, templates, and AsciiDoc formatting.

概要

The ADR Management skill streamlines the process of documenting architectural decisions directly within your codebase. It provides a standardized framework for creating, tracking, and updating ADRs in the doc/adr/ directory, ensuring every major technical choice is recorded with context, consequences, and alternatives. By automating numbering and status transitions—from Proposed to Accepted, Superseded, or Deprecated—it helps engineering teams maintain a consistent, searchable historical record of their system design evolution.

主な機能

Full lifecycle management for tracking decisions from Proposed to Superseded status
Structured retrieval and listing of ADR content and metadata for quick reference
Streamlined CRUD operations specifically optimized for architectural documentation
Automated ADR creation with standardized AsciiDoc templates and sequential numbering
Format validation to ensure consistent AsciiDoc syntax and cross-reference integrity
0 GitHub stars

ユースケース

Maintaining a searchable history of system design changes for onboarding new developers
Updating the status of a legacy decision when it is superseded by a newer architectural pattern
Documenting a new technology stack choice including the specific context and trade-offs

概要

主な機能

Full lifecycle management for tracking decisions from Proposed to Superseded status
Structured retrieval and listing of ADR content and metadata for quick reference
Streamlined CRUD operations specifically optimized for architectural documentation
Automated ADR creation with standardized AsciiDoc templates and sequential numbering
Format validation to ensure consistent AsciiDoc syntax and cross-reference integrity
0 GitHub stars

ユースケース

Maintaining a searchable history of system design changes for onboarding new developers
Updating the status of a legacy decision when it is superseded by a newer architectural pattern
Documenting a new technology stack choice including the specific context and trade-offs