skills.rest
jgezelscorp
jgezelscorpCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/jgezelscorp/Apex --skill azure-adr-jgezelscorp
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
simonheimlichersimonheimlicher
1

architecting-python

Generate Architecture Decision Records for Python architecture decisions.

Community
Advanced
plurigridplurigrid
60

theme-factory

Apply predefined color palettes and font pairings to slides, docs, and HTML pages.

Official
Basic
cassm199-mitacassm199-mita

azure-adr

Create Azure Architecture Decision Records with WAF mapping and structured templates.

Community
Advanced
pazdedavpazdedav

azure-adr

Generate formal Azure Architecture Decision Records with WAF pillar mapping.

Community
Intermediate