skills.rest
avgarcia
avgarciaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr-review

Review architecture decision records for missing decisions, risks, and structural gaps.

Updated May 15, 2026
Search Tags:#adr#technical debt#software architecture#governance#architecture review#decision records
One-click install
npx skills add https://github.com/avgarcia/runcriticon --skill adr-review-avgarcia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-review
Source: https://github.com/avgarcia/runcriticon/tree/main/.claude/skills/adr-review
Command: npx skills add https://github.com/avgarcia/runcriticon --skill adr-review-avgarcia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams identify hidden gaps, unclear decisions, and architectural risks in Architecture Decision Records before they become implementation problems.

Core Features & Use Cases

  • Structured ADR Auditing: Reviews ADRs against a seven-block Nivel 1 pattern covering strengths, gaps, inherited premises, NFRs, implicit decisions, and governance issues.
  • Decision Refinement: Identifies latent sub-decisions, creates actionable recommendations with anchors, and guides teams through focused clarification questions.
  • Use Case: Use it when reopening an accepted ADR, reviewing a new architecture decision, or validating that a decision follows the established Runcriticon review standard.

Quick Start

Ask the adr-review skill to audit ADR-0007 using the Nivel 1 review pattern and prepare the required follow-up decisions.

Frequently Asked Questions about adr-review

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

FAQPage Schema
How do I review architecture decision records for missing decisions and structural gaps?▼

Architecture decision record review involves auditing ADRs against a standardized framework to identify missing decisions, structural gaps, and inherited premises. This process detects latent sub-decisions and validates cross-references before implementation problems arise.

What is the best way to reopen an accepted ADR and validate its architectural decisions?▼

Accepted ADR reopening requires applying a structured architecture review framework to detect risks, implicit decisions, and governance issues. The review identifies latent sub-decisions and generates prioritized recommendations with anchors for focused clarification.

How does architecture governance review handle non-functional requirements in decision records?▼

Architecture governance review analyzes non-functional requirements within ADRs by evaluating inherited premises and implicit decisions against a seven-block review pattern. This exposes hidden gaps and structural risks that could impact software architecture outcomes.

Can I audit software architecture decisions for technical debt without a standardized review framework?▼

Auditing software architecture decisions for technical debt benefits from a standardized review framework. Without structured ADR analysis covering strengths, gaps, and governance issues, risks and missing decisions likely remain undetected until implementation.

When do I need to run a structured architecture review on my decision records?▼

Structured architecture review is needed when validating new ADRs, reopening accepted decisions, or conducting decision audits. It applies to software architecture governance scenarios where identifying structural gaps and prioritized recommendations prevents implementation failures.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

git-workflow

Generate Markdown Architectural Decision Records with auto-incremented numbers and date stamps.

Community
Advanced
masrurimzmasrurimz

prometheus-planner

Interview users to generate self-contained implementation plans under .sisyphus/plans/.

Community
Advanced
alirezarezvanialirezarezvani
24.2k

cto-advisor

Analyze tech debt and calculate team scaling via Python scripts.

Community
Intermediate
v1bh0rv1bh0r

nw-sa-critique-dimensions

Assess architectural concerns in ADRs and architecture documents using structured critique dimensions.

Community
Advanced