This PR addresses all 20 Template Doctor compliance issues to improve the repository's compliance score from 29% to 100%.

Changes Made

1. LICENSE File Issue

Created a LICENSE file (in addition to the existing LICENSE.md) to satisfy the Template Doctor requirement for an exact filename match.

2. GitHub Workflow Naming

Renamed .github/workflows/azure-dev.yaml to .github/workflows/azure-dev.yml to match the expected filename format.

3. README.md Structure

• Changed "Architecture diagram" to "Architecture" to properly format as an h2 heading
• Added a new "Prerequisites" h2 section that lists all required tools and dependencies:
  • Azure Developer CLI (azd)
  • Node.js 18+
  • Python 3.10+
  • PostgreSQL 14+ with pgvector extension
  • Docker Desktop
  • Git

4. Bicep Template Metadata

Added @metadata blocks with requiredResources properties to all 16 Bicep infrastructure files. Each file now includes:

• A description of what the template creates
• An array of Azure resource types (requiredResources) that the template provisions

For example:

@metadata({
  description: 'Creates a Log Analytics workspace.'
  requiredResources: [
    'Microsoft.OperationalInsights/workspaces'
  ]
})

The following files were updated:

• infra/main.bicep - Main deployment template
• infra/backend-dashboard.bicep - Application Insights dashboard
• infra/web.bicep - Web container app
• All files in infra/core/ directories (AI, database, host, monitor, security modules)

Validation

• All Bicep files compile successfully with az bicep build
• Only linting warnings remain (safe access operators, unused parameters) - no syntax errors
• README.md now includes both required h2 headings
• LICENSE file exists in the expected location
• GitHub workflow uses the expected .yml extension

This resolves all Template Doctor compliance issues and should achieve 100% compliance.

Fixes #1.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.