review-adr

Evaluate ADR drafts for completeness, alternatives, and consequences.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/daddia/space --skill review-adr-daddia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-adr
Source: https://github.com/daddia/space/tree/main/.agents/skills/review-adr
Command: npx skills add https://github.com/daddia/space --skill review-adr-daddia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines the review and finalisation of draft Architecture Decision Records (ADRs). It ensures completeness, assesses alternatives considered, and documents consequences, helping teams move ADRs from Proposed or Draft to Accepted without introducing new content.

Core Features & Use Cases

  • Quality checks: Verifies required sections exist, statements are complete, and drivers are traceable.
  • Multi-option analysis: Ensures at least three viable design options are considered with pros/cons.
  • Decision rationale mapping: Aligns the chosen outcome with explicit drivers and risk considerations.
  • Review governance: Produces a structured review note and updates ADR status to Accepted when criteria are met.

Quick Start

Review an existing ADR draft by its path, e.g., ADR-0012.md, and generate an accepted review.

Frequently Asked Questions about review-adr

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

FAQPage Schema
How do I review an Architecture Decision Record draft for completeness?

To review an Architecture Decision Record draft, you must identify required sections, verify traceable drivers, and ensure statements are complete. This process evaluates ADR completeness against defined drivers and risks to produce a structured review note.

What is ADR governance and how does it apply to proposed architecture decisions?

ADR governance is the structured evaluation of proposed architecture decisions against defined drivers and risks. It ensures decision rationale mapping aligns with explicit drivers and produces a final acceptance status with a concrete review note.

How do I ensure my architecture decision considered enough alternatives?

Ensuring architecture decisions considered enough alternatives requires multi-option analysis. The review process verifies that at least three viable design options are documented with their corresponding pros and cons before acceptance.

Can I update an ADR status to Accepted without introducing new content?

Yes, you can update an ADR status to Accepted without new content by demonstrating compliance with review rules. The process references explicit drivers, confirms alternatives, and generates a structured review note to finalize the draft.

What are the limitations of automated ADR quality assurance?

Automated ADR quality assurance is limited to evaluating drafts with Proposed or Draft status. It cannot introduce new content, meaning it only assesses existing completeness, stated consequences, and alternatives without generating missing architectural rationale.

Does ADR review work with markdown documentation files?

ADR review works with markdown documentation files by analyzing the specified ADR path. It assesses the draft's completeness, evaluates considered alternatives, and documents consequences to move the architecture record toward acceptance.