Skip to content

Conversation

@maniSbindra
Copy link
Contributor

@maniSbindra maniSbindra commented Jan 22, 2026

Summary

This PR adds an AGENTS.md file that provides instructions for AI agents (such as GitHub Copilot CLI) to automatically analyze Azure IaC repositories using MPF.

Changes

  • AGENTS.md: New file with structured instructions for AI agents covering:

    • IaC type detection (ARM, Bicep, Terraform)
    • MPF execution commands for each provider
    • Output parsing guidance
    • Azure built-in role suggestions
    • Cleanup procedures
  • .github/copilot-instructions.md: Symlink to AGENTS.md for VS Code Copilot Chat support

  • README.md: Added AI-assisted analysis section with:

    • Example prompt
    • Instructions for copying AGENTS.md to other repositories

Why

AI coding assistants like GitHub Copilot CLI can automatically discover and follow instructions in AGENTS.md files. This enables users to simply ask:

"Analyze this repository and find the minimum Azure permissions required to deploy the infrastructure"

And have the AI agent:

  1. Detect the IaC type
  2. Set up the MPF environment
  3. Run the appropriate MPF command
  4. Parse results and suggest Azure RBAC roles

Portable Usage

Users can copy AGENTS.md to their own Azure IaC projects:

curl -sO https://raw.githubusercontent.com/Azure/mpf/main/AGENTS.md

Supported Tools

Tool Support
GitHub Copilot CLI ✅ Reads AGENTS.md
GitHub Copilot Coding Agent ✅ Reads AGENTS.md
VS Code Copilot Chat ✅ Reads .github/copilot-instructions.md

Testing

Tested with GitHub Copilot CLI against:

  • Bicep templates (storage account creation)
  • Successfully identified minimum permissions and suggested appropriate built-in roles

fixes #108

- Add AGENTS.md with instructions for AI agents (GitHub Copilot CLI, etc.)
- Document IaC detection, MPF execution, and role suggestion workflow
- Update README.md with reference to AI-assisted analysis
@DariuszPorowski DariuszPorowski merged commit 7582054 into main Jan 22, 2026
17 checks passed
@DariuszPorowski DariuszPorowski deleted the add-agents-md branch January 22, 2026 18:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add guidance for Copilots/Agents to consume MPF

3 participants