skills.rest
batuhanysv
batuhanysvCOMMUNITY
Explore all skills by this author →
GitHub

azure-adr

Generate formal Azure Architecture Decision Records with WAF pillar mapping.

Updated Mar 16, 2026
Search Tags:#architecture#documentation#decision record#adr#azure#waf
One-click install
npx skills add https://github.com/batuhanysv/sdx-agentic-infraops --skill azure-adr-batuhanysv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-adr
Source: https://github.com/batuhanysv/sdx-agentic-infraops/tree/main/.github/skills/azure-adr
Command: npx skills add https://github.com/batuhanysv/sdx-agentic-infraops --skill azure-adr-batuhanysv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps formalize and document significant architectural decisions made during the design and implementation phases of Azure infrastructure projects, ensuring clarity, traceability, and adherence to best practices.

Core Features & Use Cases

  • Formal ADR Creation: Generates Architecture Decision Records following a structured template.
  • WAF Pillar Analysis: Integrates analysis against the Azure Well-Architected Framework pillars (Security, Reliability, Performance, Cost, Operations).
  • Use Case: When deciding to use Azure Cosmos DB over Azure SQL for a new microservice, this Skill can create a formal ADR documenting the context, decision, alternatives considered, consequences, and WAF impact.

Quick Start

Create an ADR documenting our decision to use Azure Cosmos DB instead of Azure SQL for the e-commerce catalog service, considering WAF implications and cost trade-offs.

Frequently Asked Questions about azure-adr

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

FAQPage Schema
How do I document Azure architecture decisions against the Well-Architected Framework?▼

To document Azure architecture decisions against the Well-Architected Framework (WAF), generate a formal Architecture Decision Record (ADR) mapping context, alternatives, and consequences to WAF pillars like Security, Reliability, and Cost.

What is an Architecture Decision Record used for in Azure infrastructure projects?▼

An Architecture Decision Record formalizes significant design and as-built Azure infrastructure decisions, ensuring traceability and adherence to best practices by documenting the context, decision, alternatives, and consequences.

Can I create ADRs for both design-phase and as-built Azure infrastructure?▼

Yes, you can create ADRs for both design-phase and as-built Azure infrastructure, documenting significant architectural decisions using specific naming conventions and designated output locations for formal traceability.

How do I map infrastructure choices like Cosmos DB vs SQL Database to WAF pillars?▼

To map infrastructure choices like Cosmos DB vs SQL Database to WAF pillars, generate an ADR that analyzes the decision's impact across Security, Reliability, Performance, Cost, and Operations, including trade-offs and consequences.

Are there specific naming conventions required for Azure ADRs?▼

Yes, generating Azure ADRs requires using specific naming conventions and output locations to formalize architectural decision records and maintain structure across infrastructure documentation.

Related Skills

Explore More Software Engineering Skills→
simonheimlichersimonheimlicher
1

architecting-python

Generate Architecture Decision Records for Python architecture decisions.

Community
Advanced
product-on-purposeproduct-on-purpose
527

develop-adr

Generate Architecture Decision Records using the Nygard-style ADR template.

Official
Basic
anishi1222anishi1222

waf-cost-optimization

Review Azure WAF configurations against Microsoft Learn cost optimization documents.

Community
Advanced
pazdedavpazdedav

azure-adr

Generate formal Azure Architecture Decision Records with WAF pillar mapping.

Community
Intermediate