skills.rest
florian-trehaut
florian-trehautCOMMUNITY
Explore all skills by this author →
GitHub

bmad-adr-review

Cross-check Architecture Decision Records against codebase and project context.

Updated Aug 23, 2026
Search Tags:#anti-patterns#codebase#adr#evidence#review#fact-check#verdict
One-click install
npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-adr-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-adr-review
Source: https://github.com/florian-trehaut/bmad-global/tree/main/src/bmm-skills/3-solutioning/bmad-adr-review
Command: npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-adr-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-check Architecture Decision Records (ADRs) against the codebase and project context to ensure decisions are well-supported and traceable.

Core Features & Use Cases

  • Automates extraction of technical claims from ADR sections and maps them to code, docs, and tests.
  • Applies a structured evaluation framework and anti-pattern detection to surface gaps and actionable findings.
  • Generates a publish-ready review with findings, verdicts, and artifacts for stakeholders.

Quick Start

Provide an ADR text to begin an automated verification and I will generate a structured review.

Frequently Asked Questions about bmad-adr-review

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

FAQPage Schema
How do I verify if an Architecture Decision Record is actually implemented in the codebase?▼

ADR verification involves mapping technical claims from the document to actual code, tests, and project context to ensure decisions are well-supported. This cross-checking process identifies factual gaps and architectural drift.

What is evidence-driven ADR review and how does it work?▼

An evidence-driven ADR review applies a structured evaluation framework to map decision claims against codebase evidence. It detects architectural anti-patterns and generates actionable findings for stakeholders.

How do I check my ADR for architectural anti-patterns?▼

Checking an ADR for anti-patterns requires applying a structured evaluation framework that cross-references the documented decisions with the actual codebase. This identifies unsupported claims and architectural deviations.

Can I generate a publishable review artifact from an ADR fact-check?▼

An ADR fact-check can generate a publishable review artifact containing actionable findings, supporting evidence, traceability, and a clear verdict. This document is ready for stakeholder distribution.

Does ADR review work for verifying decisions at scale across a large codebase?▼

Automated ADR review scales by extracting technical claims and mapping them to code, docs, and tests across the project context. This automated cross-checking ensures traceability even in large codebases.

Related Skills

Explore More Software Engineering Skills→
ConnectiveTCSConnectiveTCS

fact-checker

Verify claims and identify misinformation through evidence-based analysis.

Community
Intermediate
wfukatsuwfukatsu
12

product-review

Review product artifacts for consistency, traceability, extensibility, and strategic alignment.

Community
Advanced
zm2231zm2231

fact-checker

Verify claims by cross-checking multiple sources and flagging misinformation.

Community
Advanced
baotoqbaotoq
98

architecture-decision-records

Capture and manage architectural decisions with standardized ADR templates.

Community
Intermediate