azure-adr

Create Azure Architecture Decision Records with Well-Architected Framework mapping and alternatives analysis.

Updated Apr 11, 2026

Search Tags:#ADR #cloud architecture #architecture decision record #WAF #infrastructure design

Ready to run

npx skills add https://github.com/jgezelscorp/Apex --skill azure-adr-jgezelscorp

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: azure-adr
Source: https://github.com/jgezelscorp/Apex/tree/main/.github/skills/azure-adr
Command: npx skills add https://github.com/jgezelscorp/Apex --skill azure-adr-jgezelscorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires azure-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of Architecture Decision Records (ADR) with Well-Architected Framework (WAF) mapping and provides alternatives for architectural decision documentation.

Core Features & Use Cases

ADR Creation: Automates the generation of ADRs for documenting infrastructure decisions.
WAF Mapping: Provides WAF mapping to analyze the impact of decisions on the 5 pillars of the WAF.
Alternatives Documentation: Documents the alternatives considered and their justifications.
Use Case: Use this Skill to create a formal ADR for a cloud architecture decision, capturing context, decision rationale, alternatives, consequences, and compliance considerations.

Quick Start

Use the azure-adr skill to create an ADR documenting the decision to migrate from Azure SQL to Azure Cosmos DB.

Frequently Asked Questions about azure-adr

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

FAQPage Schema

How do I create an Architecture Decision Record for Azure infrastructure design?▼

An Architecture Decision Record for Azure infrastructure design documents decisions by capturing context, rationale, alternatives, consequences, and compliance considerations. It requires using an ADR template and adhering to guardrails for formal infrastructure and system design discussions.

How does Well-Architected Framework mapping work for architecture decisions?▼

Well-Architected Framework mapping analyzes the impact of architectural decisions across the 5 pillars of the WAF. It integrates this analysis directly into the ADR to evaluate infrastructure design choices during project reviews and compliance verification.

Do I need azure-cli to document cloud architecture decisions?▼

Yes, azure-cli is a required dependency to generate and maintain Azure Architecture Decision Records. The CLI provides the necessary environment context for automating ADR creation with WAF mapping and alternatives analysis.

What is the best way to document alternatives analysis for infrastructure decisions?▼

The best way to document alternatives analysis is to generate an ADR that explicitly records the alternatives considered and their justifications. This ensures infrastructure decisions include comprehensive alternatives documentation alongside WAF mapping for compliance verification.

When do I need an Architecture Decision Record for cloud architecture?▼

You need an Architecture Decision Record when formalizing cloud architecture decisions for project reviews, infrastructure design discussions, or compliance verification. It captures context, decision rationale, alternatives, consequences, and compliance considerations with WAF alignment.