Skills
.Work. You
Rest

review-adr

Community

Rigorous ADR review for robust decisions.

Software Engineering#architecture#code review#documentation#technical writing#decision record#adr
Authorjamesc
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill ensures Architecture Decision Records (ADRs) are comprehensive, technically sound, and clearly reasoned, preventing the adoption of weak or harmful design choices.

Core Features & Use Cases

  • Multi-pass review: Applies distinct analytical lenses (structural, reasoning, adversarial) to uncover a wide range of issues.
  • Code verification: Validates code examples against the actual codebase for accuracy.
  • Use Case: Before merging a critical ADR for a new language feature, use this Skill to perform a deep review, catching potential flaws in the design, implementation plan, and reasoning that might otherwise lead to costly mistakes.

Quick Start

Use the review-adr skill to perform a full three-pass review on the ADR file docs/ADR/0015-new-feature.md.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 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: review-adr
Download link: https://github.com/jamesc/skills/archive/main.zip#review-adr

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

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.