// Fetch the latest CAF abbreviations page from Microsoft Learn and compare against resourceDefinition.json official.slug values. Reports drift where the provider's slug differs from the official CAF slug. Triggers on: weekly scheduled audit, manual sync check.
Discover new Azure resources by fetching the latest azurerm provider resource list from the Terraform Registry and comparing against resourceDefinition.json. Identifies unsupported resources. Triggers on: weekly scheduled discovery, manual audit.
Update CHANGELOG.md with a new entry under the correct section. Parses existing structure, adds entries under [Unreleased], and assesses semver impact. Triggers on: after resource changes, bug fixes, documentation updates, or any notable project change.
Provide step-by-step guidance for contributors based on their contribution type. References CONTRIBUTING.md and project conventions. Triggers on: new contributor questions, 'how do I contribute', contribution guidance requests.
Run test coverage analysis (make test_coverage), parse coverage percentage, compare against the 95% threshold, and flag regressions. Triggers on: PR checks, post-build validation, release prep.
Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples. Triggers on: after adding/updating resources, documentation audit.
Run end-to-end tests (make test_e2e or make test_e2e_quick), parse results, and produce a structured summary. Use after build succeeds to validate real Terraform workflows. Triggers on: post-build validation, PR checks, release verification.
| name | azure-caf-sync |
| description | Fetch the latest CAF abbreviations page from Microsoft Learn and compare against resourceDefinition.json official.slug values. Reports drift where the provider's slug differs from the official CAF slug. Triggers on: weekly scheduled audit, manual sync check. |
Use Microsoft Docs MCP tools (microsoft_docs_fetch) to fetch the latest version:
URL: https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/ready/azure-best-practices/resource-abbreviations
Extract all rows from the abbreviation table: resource name, abbreviation (slug), resource provider namespace.
python3 -c "
import json
with open('resourceDefinition.json') as f:
resources = json.load(f)
for r in resources:
official = r.get('official', {})
ns = official.get('resource_provider_namespace', '')
official_slug = official.get('slug', '')
print(f'{r[\"name\"]}|{r[\"slug\"]}|{official_slug}|{ns}')
" > /tmp/caf-current.txt
For each resource in the provider that has an official.resource_provider_namespace:
slug against the official CAF abbreviation## CAF Slug Drift Report
### Mismatches (<count>)
| Resource | Provider Slug | Official CAF Slug | Namespace |
|----------|--------------|-------------------|-----------|
| <name> | <current> | <official> | <ns> |
### New in CAF (not in provider) (<count>)
| Resource | CAF Slug | Namespace |
|----------|----------|-----------|
| <name> | <slug> | <ns> |
### Summary
- Resources checked: <count>
- Matches: <count>
- Mismatches: <count>
- New resources in CAF: <count>