From 742e5d8d3f31f702847f4794f9376bc5c629f6f3 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 03:48:52 +0000
Subject: [PATCH] chore: publish from main

---
 instructions/terraform-azure.instructions.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/instructions/terraform-azure.instructions.md b/instructions/terraform-azure.instructions.md
index f514b8e2..358d63bd 100644
--- a/instructions/terraform-azure.instructions.md
+++ b/instructions/terraform-azure.instructions.md
@@ -169,6 +169,10 @@ locals {
 
 - **Versioning**: Target latest stable Terraform and Azure provider versions. Specify versions in code and keep updated (TFFR3).
 
+- **Provider selection (AzureRM vs AzAPI)**: Use the `azurerm` provider for most scenarios; it is stable and covers the majority of Azure services. Use the `azapi` provider only when you need the very latest Azure features or a resource not yet supported in `azurerm`. Document the choice in code comments, and prefer `azurerm` when in doubt.
+
+- **Minimal provider dependencies**: Do not introduce additional providers (e.g., `random`, `tls`) or external modules beyond the project's scope without user confirmation. Where one is required, add a comment explaining why and keep the stack lean.
+
 ## 10. Folder Structure
 
 Use a consistent folder structure for Terraform configurations.
@@ -194,7 +198,6 @@ my-azure-app/
 │       ├── test.tfvars             # Test environment
 │       └── prod.tfvars             # Production environment
 ├── .github/workflows/              # CI/CD pipelines (if using github)
-├── .azdo/                          # CI/CD pipelines (suggested if using Azure DevOps)
 └── README.md                       # Documentation
 ```
 
@@ -229,6 +232,12 @@ Follow AVM specifications TFNFR1, TFNFR2, TFNFR3, and TFNFR4 for consistent file
 - Enable diagnostic settings for audit trails
 - Follow principle of least privilege
 
+## Documentation
+
+- Keep documentation up to date. Update `README.md` with any new variables, outputs, or usage instructions whenever the code changes.
+- Consider automating reference documentation with a tool such as `terraform-docs`.
+- Update architecture diagrams to reflect infrastructure changes after each significant update.
+
 ## Cost Management
 
 - Confirm budget approval for expensive resources