azure-adr

Automate Azure Architecture Decision Records with WAF mapping, alternatives, and consequences.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Avihai-H/infraops --skill azure-adr-avihai-h
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-adr
Source: https://github.com/Avihai-H/infraops/tree/main/.github/skills/azure-adr
Command: npx skills add https://github.com/Avihai-H/infraops --skill azure-adr-avihai-h

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, markdown, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation of Azure Architecture Decision Records (ADR), ensuring that decisions are well-documented, including WAF mapping, alternatives, and consequences.

Core Features & Use Cases

  • ADR Creation: Automates the generation of ADRs that document significant infrastructure decisions.
  • WAF Mapping: Ensures decisions align with the Well-Architected Framework pillars.
  • Alternatives & Consequences: Facilitates comprehensive trade-off analysis and decision rationale documentation.
  • Use Case: When designing an Azure infrastructure, use this Skill to document decisions like technology choice or resource allocation, considering security, reliability, performance, cost, and operations.

Quick Start

Use the azure-adr skill to create an ADR for the decision to use Azure Cosmos DB for the e-commerce catalog service.

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 Azure Architecture Decision Record with WAF mapping?

To create an Azure Architecture Decision Record with WAF mapping, you can use a skill that automates ADR generation while aligning decisions with Well-Architected Framework pillars. It structures your document with alternatives, trade-off analysis, and consequences directly included.

What is WAF mapping in the context of architecture decision records?

WAF mapping in architecture decision records ensures your infrastructure choices align with the Well-Architected Framework pillars. It systematically evaluates decisions against security, reliability, performance, cost, and operations to justify your technology choices.

How do I document trade-off analysis and alternatives for Azure infrastructure decisions?

You document trade-off analysis and alternatives for Azure infrastructure decisions by generating an ADR that captures the decision rationale. The automated process structures the consequences and evaluated alternatives alongside the WAF mapping.

Do I need YAML and Markdown processing capabilities to generate Azure ADRs?

Yes, you need YAML and Markdown processing capabilities to generate Azure ADRs. The skill relies on these dependencies to structure the architecture decision records, WAF mapping data, and trade-off analysis output correctly.

Can I map Azure resource allocation decisions to the Well-Architected Framework pillars?

Yes, you can map Azure resource allocation decisions to the Well-Architected Framework pillars. The ADR creation process explicitly evaluates your infrastructure choices against security, reliability, performance, cost, and operational excellence criteria.

What is the best way to automate architecture decision documentation for Azure?

The best way to automate architecture decision documentation for Azure is using a tool that generates structured ADRs. It automatically maps decisions to WAF pillars, documents alternatives, and details the consequences to streamline architectural trade-off analysis.