ADR Report Skill

Generate markdown reports of ADR activity categorized by status and project.

49|12|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill adr-report-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ADR Report Skill
Source: https://github.com/DavidROliverBA/ArchitectKB/tree/main/.claude/skills/adr-report
Command: npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill adr-report-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the generation of comprehensive reports on Architecture Decision Record (ADR) activity, helping teams track decisions, identify trends, and manage their ADR lifecycle efficiently.

Core Features & Use Cases

  • Activity Reporting: Generates reports for specific time periods (week, month, all time) or a complete ADR inventory.
  • Categorization: Organizes ADRs by status (proposed, accepted, deprecated) and by project.
  • Use Case: A Solutions Architect needs to provide a monthly update on architectural decisions made. They can use this Skill to quickly generate a report detailing newly created, updated, and pending ADRs, along with a summary of key decisions.

Quick Start

Use the adr-report skill to generate a report of all ADR activity from the last month.

Frequently Asked Questions about ADR Report Skill

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

FAQPage Schema
How do I generate a report of architecture decision records activity for a specific time period?

To generate an architecture decision records activity report, specify a time period like week, month, or all time. The report extracts titles, statuses, dates, and decision summaries from ADR Markdown files to track architectural decisions.

What is the best way to categorize ADRs by status and project for management tracking?

Categorizing ADRs by status and project is handled automatically during report generation. The tool parses Markdown files to organize decision records into proposed, accepted, or deprecated statuses and groups them by their related projects.

Can I extract decision summaries and consequences from ADR Markdown files?

Yes, you can extract decision summaries and consequences from ADR Markdown files. The reporting process parses each file to pull titles, dates, deciders, related projects, and consequences into a formatted markdown report.

How do ADR activity reports help with project management and architecture documentation?

ADR activity reports help project management by automating the tracking of architecture documentation. They identify decision trends, detail newly created or pending records, and manage the ADR lifecycle efficiently for solutions architects.

Does this ADR reporting tool require any external dependencies to parse Markdown files?

No external dependencies are required to parse Markdown files for ADR reporting. The skill operates independently using internal scripts to extract data and produce formatted markdown reports for tracking architectural decisions.

What is included in a complete ADR inventory report?

A complete ADR inventory report includes titles, statuses, dates, related projects, decision summaries, consequences, and deciders extracted from Markdown files. It provides a comprehensive view of all architecture decision records.