azure-adr

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

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/cassm199-mita/azure-agentic-infraops-accelerator --skill azure-adr-cassm199-mita
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-adr
Source: https://github.com/cassm199-mita/azure-agentic-infraops-accelerator/tree/main/.github/skills/azure-adr
Command: npx skills add https://github.com/cassm199-mita/azure-agentic-infraops-accelerator --skill azure-adr-cassm199-mita

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users efficiently create and manage Azure Architecture Decision Records (ADRs), reducing the time and effort spent on documenting architectural decisions and their implications.

Core Features & Use Cases

  • ADRs Creation: Automates the creation of ADRs with structured templates and content guidelines.
  • WAF Mapping: Integrates with the Well-Architected Framework (WAF) to ensure decisions are mapped to relevant pillars.
  • Use Case: Ideal for architects and engineers to document decisions around Azure infrastructure design and deployment.

Quick Start

Generate an ADR to document the decision on using Azure Cosmos DB for the e-commerce catalog service by typing: 'Create an ADR for Cosmos DB decision'.

Frequently Asked Questions about azure-adr

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

FAQPage Schema
How do I create Architecture Decision Records for Azure infrastructure?

You create Architecture Decision Records by using a structured template that automates documentation for Azure infrastructure decisions. The process provides content guidelines and enforces ADR naming conventions to streamline your architecture decision documentation.

What is the best way to map Azure architecture decisions to the Well-Architected Framework?

Mapping Azure architecture decisions to the Well-Architected Framework is handled automatically during ADR creation. The generated records integrate directly with WAF to ensure your infrastructure choices are aligned with relevant WAF pillars.

How does automated ADR documentation work for Azure design choices?

Automated ADR documentation works by applying a structured template to your Azure design choices. It standardizes the documentation of architectural decisions and their implications, reducing manual effort while enforcing a consistent ADR structure.

Do I need to follow specific naming conventions when documenting Azure architecture decisions?

Yes, documenting Azure architecture decisions requires adherence to specific ADR naming conventions and structure. Following these standards ensures the automated generation process correctly integrates the records into your overall workflow.

Can I use this ADR template for any Azure infrastructure deployment decision?

Yes, you can use this ADR template for any Azure infrastructure deployment decision. It is designed for architects and engineers to efficiently document choices around infrastructure design, such as selecting specific Azure services.

What are the limitations of automating Azure architecture decision documentation?

A limitation of automating Azure architecture decision documentation is that it is specialized for Azure infrastructure and WAF mapping. It requires strict adherence to predefined ADR naming conventions and structure to function correctly within the workflow.