How do I install the Azure Adr skill?

Run npx skillmds@latest add jonathan-vella/azure-adr in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Azure Adr safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Azure Adr?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Azure Adr free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Azure Adr?

jonathan-vella (@jonathan-vella) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Azure Adr by jonathan-vella — Agent Skill

Name: Azure Adr
Author: jonathan-vella

Azure Adr

**ANALYSIS SKILL** — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences. WHEN: "create ADR", "document decision", "architecture decision record", "record why we chose", "WAF pillar justification", "trade-off analysis". DO NOT USE FOR: IaC code (06b/06t agents), diagrams (python-diagrams), cost estimates (cost-estimate-subagent).

File contents

Azure Architecture Decision Records (ADR) Skill

Create formal Architecture Decision Records that document significant infrastructure decisions with Azure-specific context, WAF pillar analysis, and implementation guidance.

Output Naming

ADRs are saved to agent-output/{project}/ with one of two phase prefixes:

Phase	Prefix	Status default	Trigger
Step 3 (Design)	`03-des-adr-`	`Proposed`	Architect agent, design/planning language
Step 7 (As-Built)	`07-ab-adr-`	`Accepted`	After deploy, implemented/current-state language

Full filename: {prefix}NNNN-{kebab-title}.md (e.g., 03-des-adr-0001-use-cosmos-db-for-state.md). NNNN is 4-digit sequential per project.

The 07-ab-adr- ADR may differ from 03-des-adr- if implementation required changes — document deviations in the "Implementation Notes" section.

Rules

One decision per ADR — keep ADRs focused on a single decision
Include alternatives — always document at least 2-3 considered and rejected
Map to WAF pillars — show impact on each of the 5 Well-Architected pillars
Link to requirements — reference the requirement that drove the decision
Keep it concise — ADRs should be readable in 5 minutes
Document both consequences — at least 1 positive and 1 negative

Steps

Gather context — decision context, alternatives, stakeholders
Determine number — check existing ADRs in agent-output/{project}/ for next sequence
Determine phase — design (03-des-) or as-built (07-ab-)
Generate document — follow references/adr-template.md
Include WAF analysis — map decision impact to all 5 pillars
Document alternatives — list 2-3 with rejection reasons
Self-check — run through references/quality-checklist.md

Reference Index

Load on demand:

Reference	When to Load
`references/adr-template.md`	Authoring the ADR (full template with all sections)
`references/example-prompts.md`	Looking for trigger phrasing / common ADR topics
`references/quality-checklist.md`	Final self-check before saving
`references/guardrails.md`	DO/DON'T rules, anti-pattern table

---name: azure-adrdescription: **ANALYSIS SKILL** — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences. WHEN: "create ADR", "document decision", "architecture decision record", "record why we chose", "WAF pillar justification", "trade-off analysis". DO NOT USE FOR: IaC code (06b/06t agents), diagrams (python-diagrams), cost estimates (cost-estimate-subagent).license: MIT---# Azure Architecture Decision Records (ADR) SkillCreate formal Architecture Decision Records that document significantinfrastructure decisions with Azure-specific context, WAF pillar analysis,and implementation guidance.## Output NamingADRs are saved to `agent-output/{project}/` with one of two phase prefixes:| Phase | Prefix | Status default | Trigger || ------------------ | --------------- | -------------- | -------------------------------------------- || Step 3 (Design) | `03-des-adr-` | `Proposed` | Architect agent, design/planning language || Step 7 (As-Built) | `07-ab-adr-` | `Accepted` | After deploy, implemented/current-state language |Full filename: `{prefix}NNNN-{kebab-title}.md` (e.g.,`03-des-adr-0001-use-cosmos-db-for-state.md`). NNNN is 4-digit sequentialper project.The `07-ab-adr-` ADR may differ from `03-des-adr-` if implementationrequired changes — document deviations in the "Implementation Notes"section.## Rules1. **One decision per ADR** — keep ADRs focused on a single decision2. **Include alternatives** — always document at least 2-3 considered and rejected3. **Map to WAF pillars** — show impact on each of the 5 Well-Architected pillars4. **Link to requirements** — reference the requirement that drove the decision5. **Keep it concise** — ADRs should be readable in 5 minutes6. **Document both consequences** — at least 1 positive and 1 negative## Steps1. **Gather context** — decision context, alternatives, stakeholders2. **Determine number** — check existing ADRs in `agent-output/{project}/` for next sequence3. **Determine phase** — design (`03-des-`) or as-built (`07-ab-`)4. **Generate document** — follow [`references/adr-template.md`](references/adr-template.md)5. **Include WAF analysis** — map decision impact to all 5 pillars6. **Document alternatives** — list 2-3 with rejection reasons7. **Self-check** — run through [`references/quality-checklist.md`](references/quality-checklist.md)## Reference IndexLoad on demand:| Reference | When to Load || ---------------------------------- | ----------------------------------------------------- || `references/adr-template.md` | Authoring the ADR (full template with all sections) || `references/example-prompts.md` | Looking for trigger phrasing / common ADR topics || `references/quality-checklist.md` | Final self-check before saving || `references/guardrails.md` | DO/DON'T rules, anti-pattern table |

Frequently asked questions