azure-adr

Automate Azure architecture decision records with context, alternatives, and WAF pillar analysis.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of creating structured Architecture Decision Records (ADRs) that document key Azure infrastructure choices, ensuring consistency and clarity.

Core Features & Use Cases

  • Formal ADR Creation: Generates detailed markdown files with decision context, alternatives, and WAF analysis.
  • Decision Documentation: Captures rationale for technology selections, trade-offs, and impacts.
  • Use Case: A Cloud architect uses this Skill to record why Azure SQL was chosen over Cosmos DB, including security and cost implications, during infrastructure planning.

Quick Start

Ask the AI to generate an ADR for the deployment architecture to ensure decisions are well-documented and review-ready.

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 an Azure cloud deployment?

To create an Architecture Decision Record for Azure, you need to document the infrastructure context, evaluate alternative options, and perform a WAF pillar analysis to capture technology trade-offs and compliance impacts.

What is WAF pillar analysis in Azure architecture decisions?

WAF pillar analysis in Azure architecture decisions evaluates cloud infrastructure choices against the Well-Architected Framework to ensure security, cost optimization, reliability, and operational excellence are properly documented in the decision record.

How do I document Azure SQL versus Cosmos DB selection rationale in an ADR?

Documenting Azure SQL versus Cosmos DB selection in an ADR involves recording the decision context, comparing alternative options, and detailing specific security and cost implications to support clear infrastructure review and compliance.

Can I use this ADR generation process for any Azure cloud infrastructure planning?

Yes, you can use this ADR generation process for any Azure cloud infrastructure planning to ensure decisions are consistently documented, review-ready, and supported by detailed context and Well-Architected Framework analysis.

What is the best way to structure Azure architecture decision records for compliance?

The best way to structure Azure architecture decision records for compliance is generating detailed markdown files that capture decision context, alternative technology options, and WAF pillar analysis for clear cloud deployment review.