Skills
.Work. You
Rest

adr-review

Official

Review ADRs against implementation and log feedback.

Software Engineering#architecture#documentation#validation#adr#review
Authorcmd-llm
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill performs post-implementation reviews of Architecture Decision Records (ADRs) by comparing the documented decision against the actual implementation.

Core Features & Use Cases

  • Identify the ADR to review and locate it in docs/decisions/
  • Extract key sections: Decision Outcome, Confirmation Criteria, Test Expectations, Dependencies, Timeline, Risk, AI Extensions
  • Inspect the actual codebase to verify implementation against the ADR
  • Update the ADR Feedback Log with findings, gaps, and lessons
  • Generate a structured ADR Review Report summarizing status and evidence

Quick Start

  • If a specific ADR is requested (e.g., "Review ADR-0002"), locate docs/decisions/0002-*.md.
  • Read the ADR, locate implementation artifacts, run relevant tests, and assess criteria.
  • Provide a structured report highlighting whether criteria are met and what changed.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: adr-review
Download link: https://github.com/cmd-llm/cllm/archive/main.zip#adr-review

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository