skills.rest
fabioabr
fabioabrCOMMUNITY
Explore all skills by this author →
GitHub

adr-reviewer

Review ADRs for ADR-001 compliance and generate QA reports.

Updated Mar 22, 2026
Search Tags:#architecture#documentation#governance#quality-assurance#peer-review#adr-review
One-click install
npx skills add https://github.com/fabioabr/rag-blueprint --skill adr-reviewer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-reviewer
Source: https://github.com/fabioabr/rag-blueprint/tree/main/src/.claude/skills/adr-reviewer
Command: npx skills add https://github.com/fabioabr/rag-blueprint --skill adr-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Revisões de ADRs são difíceis e propensas a inconsistências. Este Skill age como guardião, revisando ADRs com rigor técnico, validando coerência com o ADR-001 e assegurando qualidade para disseminação entre as equipes.

Core Features & Use Cases

  • Conformidade com ADR-001 e coerência entre ADRs para evitar contradições.
  • Análise de justificativas: questiona cada "por quê?" para fundamentar decisões técnicas e de negócios.
  • Geração de relatório de QA completo com violações, inconsistências, riscos e ações corretivas, pronto para revisão por pares.
  • Verificação de estrutura e completude: assegura que todas as seções obrigatórias estejam presentes, com comprimento e profundidade adequados.
  • Compatibilidade entre ADRs referenciados e dependências implícitas para manter consistência longitudinal.
  • Priorização de ações: lista itens pendentes com severidade e responsáveis.

Quick Start

Revise ADRs com base no ADR-001, identifique contradições e gere um relatório de QA detalhado.

Frequently Asked Questions about adr-reviewer

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

FAQPage Schema
How do I review ADRs for architectural coherence and consistency?▼

Automating ADR peer review enforces structured critique by validating justifications and checking structural completeness. It scans referenced ADRs for compatibility, flags inconsistencies, and outputs a detailed QA report containing violations, risks, severity levels, and assigned corrective actions for team dissemination.

Can I check if an architecture decision record is missing mandatory sections?▼

Validating ADR structure ensures all mandatory sections are present with adequate length and depth. The review process identifies missing sections and unverified premises, providing a prioritized list of pending items with severity levels and assigned owners to guarantee documentation quality.

How do I generate a QA report for architecture documentation peer review?▼

To generate an ADR QA report, the review process cross-references architectural decisions against ADR-001 and referenced dependencies. It produces a formal document listing flagged violations, inconsistencies, risks, and prioritized remediation suggestions with severity levels and responsible parties for peer review.

Does ADR review work for validating cross-references between multiple architecture documents?▼

Cross-referencing ADRs ensures compatibility between referenced documents and implicit dependencies to maintain longitudinal consistency. The review process checks every architectural decision against ADR-001, flags unverified premises, and outputs a QA report detailing contradictions and necessary corrective actions.

When do I need a formal ADR review process in corporate architecture?▼

A formal ADR review process is required when ensuring architectural coherence and decision quality for team dissemination. It rigorously questions technical and business justifications, enforces structured critique, and generates a QA report with flagged violations and remediation suggestions to prevent contradictions.

Related Skills

Explore More Software Engineering Skills→
LordKuperLordKuper

architecture-decision

Create Architecture Decision Records with context, alternatives, and consequences.

Community
Advanced
brianwestphalbrianwestphal
1

check-requirements-against-code

Compare software requirements documentation against implementation details to identify inconsistencies.

Community
Advanced
nuoyanruoshuinuoyanruoshui
47

architecture-decision

Document technical decisions as structured Architecture Decision Records with context and alternatives.

Community
Advanced
alexgarzaoalexgarzao

optimus-deep-doc-review

Identify gaps, errors, and inconsistencies across project documentation.

Community
Advanced