blueprint:list-adrs

List Architecture Decision Records from docs/adrs/*.md with status and summaries.

2|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/rickardp/blueprint-mode --skill blueprint-list-adrs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blueprint:list-adrs
Source: https://github.com/rickardp/blueprint-mode/tree/main/plugins/blueprint-mode/skills/list-adrs
Command: npx skills add https://github.com/rickardp/blueprint-mode --skill blueprint-list-adrs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR management is often scattered across files, making it hard to see current decisions and review history quickly.

Core Features & Use Cases

  • List ADRs: Retrieve all ADRs with their status and a brief summary.
  • Search & filter: Find ADRs by status or keywords to track decisions.
  • Overview & history: Group ADRs by status to understand what is active, draft, superseded, or deprecated.

Quick Start

Ask the assistant to list ADRs with optional filters like active, draft, superseded, or deprecated.

Frequently Asked Questions about blueprint:list-adrs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all Architecture Decision Records and see their current status?

To list Architecture Decision Records, the Skill parses markdown files in docs/adrs/ to extract metadata like date, status, and number, grouping results by active, draft, superseded, or deprecated states for quick review.

What is the best way to filter ADRs by status or keywords during an audit?

Filtering ADRs by status or keywords is handled by parsing decision record metadata from filenames and content, allowing you to retrieve targeted summaries for auditing and tracking specific architectural decisions.

How do I find which architecture decisions have been superseded or deprecated?

To find superseded or deprecated architecture decisions, the Skill parses ADR metadata including superseded_by and deprecated_reason fields, grouping these records under their respective status for historical review.

Can I view ADR summaries without reading the entire markdown documentation?

Yes, you can view ADR summaries without reading full markdown documentation because the Skill extracts concise summaries and metadata from each file, providing an at-a-glance overview of all decision records.

Does this ADR management tool work with standard markdown files in any repository?

This ADR management tool works with standard markdown files located in the docs/adrs/ directory, parsing filename conventions and metadata to enumerate decision records without requiring additional dependencies.