What metadata does the skill extract from each ADR?

It extracts the ADR number from the filename, the title from the main heading, and the date, status, and summary from the file's frontmatter and content.

How does the skill find my Architecture Decision Records?

The skill uses globbing to automatically scan the 'docs/adrs/*.md' directory. You don't need to maintain a manual index file; it parses the individual files to build the list.

Can I filter the ADR list by status?

Yes, you can use specific arguments like 'active', 'draft', or 'superseded' to view only the records matching those categories.

What happens if I have a large number of ADRs?

For projects with more than 20 records, the skill displays a summary counts first and allows you to load specific sections or search for terms to keep the output manageable.

Architecture Decision Explorer

Name: Architecture Decision Explorer
Author: rickardp

byrickardp

•

Learning & Documentation

Lists and summarizes Architecture Decision Records (ADRs) to track project history and technical evolution.

The Architecture Decision Explorer skill provides a structured overview of a project's technical history by scanning and organizing Architecture Decision Records (ADRs). It automatically discovers ADR files in your documentation directory, parses their metadata, and presents them in a categorized list based on status—Active, Draft, Superseded, or Deprecated. This allows developers to quickly understand the rationale behind system design, track ongoing architectural changes, and audit the evolution of their codebase without manually searching through individual files.

Key Features

011 GitHub stars

02Frontmatter parsing for metadata including dates, summaries, and cross-references

03Efficient handling of large ADR sets with summary views and demand loading

04Categorized grouping of decisions by Active, Draft, Superseded, and Deprecated status

05Keyword filtering to find specific architectural topics or technologies

06Automated ADR discovery via globbing in the docs/adrs directory

Use Cases

01Auditing architectural debt by identifying superseded or deprecated patterns

02Onboarding new team members by providing a searchable history of technical decisions

03Tracking incomplete technical specifications currently in the Draft phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rickardp/blueprint-mode list-adrs

For use in Claude.ai and ChatGPT

Download Skill