azure-plugin: Instructions file for Claude Code

Azure MCP Plugin Development Guidelines

⚠️ CRITICAL: Docker Daemon Errors - Auto-Start Required

When ANY Docker error occurs (daemon not running, cannot connect, etc.), you MUST:

1. DO NOT just tell the user to start Docker manually
2. DO ask: "Docker isn't running. Would you like me to start Docker Desktop for you?"
3. If yes, run the appropriate command:
   • Windows: "/c/Program Files/Docker/Docker/Docker Desktop.exe" &
   • macOS: open -a Docker
   • Linux: sudo systemctl start docker
4. Wait for Docker to be ready (30-60 seconds):

   for i in {1..30}; do docker info >/dev/null 2>&1 && echo "Docker is ready!" && break; sleep 2; done
   

5. Retry the original command automatically

Error patterns to detect:

• docker daemon is not running
• Cannot connect to the Docker daemon
• failed to connect to the docker API
• The system cannot find the file specified (Docker pipe error)
• Is the docker daemon running?

---

azd Commands - ALWAYS Use Non-Interactive Mode

CRITICAL: azd commands MUST be run non-interactively. Claude cannot provide interactive input.

Before ANY azd command:

1. Create environment first: azd env new <env-name> --no-prompt
2. Set required values:

   azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"
   azd env set AZURE_LOCATION "<location>"
   

3. Always use --no-prompt: All azd commands should include --no-prompt

Correct patterns:

# Initialize with environment name
azd init --environment my-app-dev --no-prompt

# Or create environment separately first
azd env new my-app-dev --no-prompt
azd env set AZURE_SUBSCRIPTION_ID "xxxx-xxxx-xxxx"
azd env set AZURE_LOCATION "eastus2"

# Then provision/deploy
azd up --no-prompt
azd provision --no-prompt
azd deploy --no-prompt

NEVER run these without --no-prompt or pre-configured environment:

• azd init (prompts for environment name)
• azd up (prompts for environment, subscription, location)
• azd provision (prompts for subscription)