adr-reviewer

Review Architecture Decision Records for reasoning gaps and hidden assumptions.

Updated Mar 17, 2025
One-click install
npx skills add https://github.com/muunkky/hottopoteto --skill adr-reviewer-muunkky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-reviewer
Source: https://github.com/muunkky/hottopoteto/tree/main/.claude/skills/adr-reviewer
Command: npx skills add https://github.com/muunkky/hottopoteto --skill adr-reviewer-muunkky

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a rigorous adversarial review of Architecture Decision Records (ADRs), identifying reasoning gaps, hidden assumptions, and potential pitfalls to ensure decisions are well-justified and sustainable.

Core Features & Use Cases

  • Adversarial Review: Stress-test ADRs for robust reasoning and hidden assumptions.
  • Decision Validation: Evaluate the validity of ADRs against industry standards and best practices.
  • Use Case: When you need to review an ADR for an upcoming project, use this Skill to check for potential issues before it reaches the stakeholder review phase.

Quick Start

Run the adr-reviewer skill on the ADR file 'adr-123.md'.

Frequently Asked Questions about adr-reviewer

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

FAQPage Schema
How do I review an Architecture Decision Record for reasoning integrity?

Review ADRs by stress-testing reasoning integrity, identifying hidden assumptions, and validating alternative exploration against industry standards and system architecture patterns to ensure sustainable decisions.

What does an adversarial ADR review check for?

An adversarial ADR review checks for reasoning gaps, hidden assumptions, consequence honesty, and alternative exploration, ensuring architecture decisions are well-justified and sustainable within the system context.

When do I need to validate an ADR against industry standards?

Validate an ADR against industry standards before the stakeholder review phase to ensure robust decision quality, verify architecture patterns, and identify potential reasoning pitfalls.

Can I use an automated ADR review for system architecture patterns?

Yes, you can use an automated ADR review to evaluate architecture patterns by assessing decision validity, exploring alternatives, and checking consequence honesty within your specific system context.

What is the best way to stress-test architecture decisions?

The best way to stress-test architecture decisions is through a rigorous adversarial review that identifies reasoning gaps, validates assumptions, and ensures consequence honesty before stakeholder approval.

What are the limitations of automated ADR reasoning analysis?

Automated ADR reasoning analysis requires understanding of the system context and architecture patterns to function properly, and is designed to support engineers rather than replace stakeholder review.