18-azure-best ? Azure Best Practices Library

EVA Ecosystem Integration

Tool	Purpose	How to Use
37-data-model	Single source of truth for all project entities	GET http://localhost:8010/model/projects/18-azure-best
29-foundry	Agentic capabilities (search, RAG, eval, observability)	C:\eva-foundry\eva-foundation\29-foundry
48-eva-veritas	Trust score and coverage audit	MCP tool: audit_repo / get_trust_score
07-foundation-layer	Copilot instructions primer + governance templates	MCP tool: apply_primer / audit_project

Agent rule: Query the data model API before reading source files.

Invoke-RestMethod "http://localhost:8010/model/agent-guide"   # complete protocol
Invoke-RestMethod "http://localhost:8010/model/agent-summary" # all layer counts

---

Status: Complete
Type: Read-only reference library
Entries: 32
Last updated: 2026-02-26

An agent-consumable knowledge base of pre-digested Azure best practices. Each file is a structured summary with decision tables, code snippets, and an Agent Checklist for direct use in workload evaluations.

This library is consumed by other EVA projects ? not modified by them.

---

How to Use This Library

1. Read 00-index.json to discover entries by topic tag
2. Open the relevant <topic>/<service>.md file
3. Use the Agent Checklist at the bottom of each file to evaluate a workload
4. Follow the canonical_url in the file header for authoritative source detail

See .github/copilot-instructions.md for full agent usage guidance.

---

Structure

00-index.json                    # Machine-readable manifest (32 entries)

01-assessment-tools/             # Tools that scan and score Azure resources
  azqr.md                        # Azure Quick Review - CLI scanner
  review-checklists.md           # Azure Review Checklists - Excel + FTA
  orphan-resources.md            # Azure Orphaned Resources scanner
  psrule.md                      # PSRule for Azure - IaC shift-left validation
  naming-tool.md                 # Azure Naming Tool - CAF naming conventions

02-well-architected/             # WAF pillars
  waf-overview.md                # 5 pillars, assessment tool, service guides
  reliability.md                 # Reliability pillar
  waf-security.md                # Security pillar
  cost-optimization.md           # Cost Optimization pillar
  waf-ai-workload.md             # AI workload guidance
  service-guides-index.md        # WAF service-specific guides index

03-architecture-center/          # Patterns, anti-patterns, integration
  api-design.md                  # REST API design best practices
  apim.md                        # Azure API Management key concepts
  anti-patterns.md               # 10 cloud anti-patterns with detection guide
  reference-architectures.md     # AAC reference architectures + design patterns

04-ai-workloads/                 # AI/ML security and evaluation
  ai-security.md                 # Azure AI security best practices
  ai-search.md                   # Azure AI Search security
  red-teaming.md                 # AI red teaming methodology

12-security/                     # Identity, policy, benchmarks, secrets
  rbac.md                        # Azure RBAC best practices
  key-vault.md                   # Key Vault security
  azure-policy.md                # Azure Policy - governance and compliance
  mcsb.md                        # Microsoft Cloud Security Benchmark v2

05-resiliency/                   # High availability and reliability
  aprl.md                        # Azure Proactive Resiliency Library
  mission-critical.md            # Mission-critical workload design
  multi-region-ha.md             # Multi-region HA patterns

06-operations/                   # Monitoring and observability
  azure-monitor.md               # Azure Monitor best practices

10-compute/                      # Platform compute services
  app-service.md                 # App Service deployment best practices
  azure-functions.md             # Azure Functions reliability best practices

11-containers/                   # Container orchestration
  aks.md                         # AKS best practices

07-iac/                          # Infrastructure as Code
  bicep.md                       # Bicep best practices

08-finops/                       # Cost management
  finops-toolkit.md              # FinOps Toolkit + Azure FinOps practices

09-governance/                   # Frameworks and landing zones
  caf.md                         # Microsoft Cloud Adoption Framework

---

Project Files

File	Purpose
PLAN.md	Original objectives, approach, and phase breakdown
STATUS.md	Completion status and coverage summary
ACCEPTANCE.md	Acceptance criteria and sign-off
.github/copilot-instructions.md	Agent usage rules and guidance
00-index.json	Machine-readable manifest for all 32 entries