Agentic InfraOps - Copilot Instructions
VS Code Copilot-specific orchestration instructions.
For general project conventions, build commands, and code style, see the root AGENTS.md.
Quick Start
- Enable subagents:
"github.copilot.chat": { "customAgentInSubagent": { "enabled": true } }
- Open Chat (
Ctrl+Shift+I) → Select InfraOps Conductor → Describe your project
- The Conductor guides you through all 7 steps with approval gates
7-Step Workflow
| Step |
Agent |
Output |
Review |
Gate |
| 1 |
Requirements |
01-requirements.md |
1x |
Approval |
| 2 |
Architect |
02-architecture-assessment.md + cost estimate |
3x+1x |
Approval |
| 3 |
Design (opt) |
03-des-*.{py,png,md} |
— |
— |
| 4 |
IaC Plan (Bicep: 05b-Bicep Planner / Terraform: 05t-Terraform Planner) |
04-implementation-plan.md + governance + 04-dependency-diagram.py/.png + 04-runtime-diagram.py/.png |
1x+3x |
Approval |
| 5 |
IaC Code (Bicep: 06b-Bicep CodeGen / Terraform: 06t-Terraform CodeGen) |
infra/bicep/{project}/ or infra/terraform/{project}/ |
3x |
Validation |
| 6 |
Deploy (Bicep: 07b-Bicep Deploy / Terraform: 07t-Terraform Deploy) |
06-deployment-summary.md |
1x |
Approval |
| 7 |
As-Built |
07-*.md documentation suite |
— |
— |
All outputs → agent-output/{project}/. Context flows via artifact files + handoffs.
Review column = adversarial passes by challenger-review-subagent (3x = rotating lenses; 1x = comprehensive).
Skills (Auto-Invoked by Agents)
| Skill |
Purpose |
azure-defaults |
Regions, tags, naming, AVM, security, governance, pricing |
azure-artifacts |
Template H2 structures, styling, generation rules |
azure-bicep-patterns |
Reusable Bicep patterns (hub-spoke, PE, diagnostics) |
azure-troubleshooting |
KQL templates, health checks, remediation playbooks |
azure-diagrams |
Python architecture diagram generation |
azure-adr |
Architecture Decision Records |
github-operations |
GitHub issues, PRs, CLI, Actions, releases |
git-commit |
Commit message conventions |
docs-writer |
Documentation generation |
make-skill-template |
Scaffold new Agent Skills from templates |
microsoft-docs |
Query official Microsoft/Azure docs (requires Learn MCP) |
microsoft-code-reference |
Verify SDK methods and find working code samples (requires Learn MCP) |
microsoft-skill-creator |
Create hybrid skills for Microsoft technologies (requires Learn MCP) |
terraform-patterns |
Terraform HCL patterns (hub-spoke, PE, diagnostics, AVM pitfalls) |
Agents read skills via: "Read .github/skills/{name}/SKILL.md" in their body.
Chat Triggers
- If a user message starts with
gh, treat it as a GitHub operation.
Examples: gh pr create ..., gh workflow run ..., gh api ....
- Automatically follow the
github-operations skill guidance (MCP-first, gh CLI fallback) from .github/skills/github-operations/SKILL.md.
GitHub MCP Priority (Mandatory)
- For issues and pull requests, always prefer GitHub MCP tools over
gh CLI.
- Only use
gh for operations that have no equivalent MCP write tool in the current environment.
- In devcontainers, do not run
gh auth commands unless the user explicitly asks for CLI authentication troubleshooting.
Key Conventions
See the root AGENTS.md for full conventions. Summary of VS Code-specific overrides:
- AVM-first: Always prefer Azure Verified Modules over raw Bicep/Terraform
- Governance: Always check
04-governance-constraints.md for subscription-level Azure Policy
Full details in .github/skills/azure-defaults/SKILL.md.
Terraform Conventions
Full details in .github/skills/terraform-patterns/SKILL.md and root AGENTS.md.
Key Files
| Path |
Purpose |
AGENTS.md |
Cross-agent project conventions and commands |
.github/agents/*.agent.md |
Agent definitions |
.github/skills/*/SKILL.md |
Reusable skill knowledge |
.github/instructions/ |
File-type rules (Bicep, Markdown, etc.) |
agent-output/{project}/ |
Agent-generated artifacts |
infra/bicep/{project}/ |
Bicep templates |
mcp/azure-pricing-mcp/ |
Azure Pricing MCP server |
.vscode/mcp.json |
MCP server configuration |
.vscode/infraops.toolsets.jsonc |
Workspace tool groups for interactive chat (8 toolsets) |
infra/terraform/{project}/ |
Terraform templates by project |
docs/tf-support/ |
Terraform support planning docs and prompts |
Validation
See AGENTS.md for full build and validation commands. Quick reference:
npm run validate:all
npm run lint:md
1---2name: agentic-infraops-copilot-instructions-43description: All outputs → agent-output/{project}/. Context flows via artifact files + handoffs. Review column = adversarial passes by challenger-review-subagent (3x = rotating lenses; 1x = comprehensive).4---5# Agentic InfraOps - Copilot Instructions67> VS Code Copilot-specific orchestration instructions.8> For general project conventions, build commands, and code style, see the root `AGENTS.md`.910## Quick Start11121. Enable subagents: `"github.copilot.chat": { "customAgentInSubagent": { "enabled": true } }`132. Open Chat (`Ctrl+Shift+I`) → Select **InfraOps Conductor** → Describe your project143. The Conductor guides you through all 7 steps with approval gates1516## 7-Step Workflow1718| Step | Agent | Output | Review | Gate |19| ---- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------ | ---------- |20| 1 | Requirements | `01-requirements.md` | 1x | Approval |21| 2 | Architect | `02-architecture-assessment.md` + cost estimate | 3x+1x | Approval |22| 3 | Design (opt) | `03-des-*.{py,png,md}` | — | — |23| 4 | IaC Plan (Bicep: `05b-Bicep Planner` / Terraform: `05t-Terraform Planner`) | `04-implementation-plan.md` + governance + `04-dependency-diagram.py/.png` + `04-runtime-diagram.py/.png` | 1x+3x | Approval |24| 5 | IaC Code (Bicep: `06b-Bicep CodeGen` / Terraform: `06t-Terraform CodeGen`) | `infra/bicep/{project}/` or `infra/terraform/{project}/` | 3x | Validation |25| 6 | Deploy (Bicep: `07b-Bicep Deploy` / Terraform: `07t-Terraform Deploy`) | `06-deployment-summary.md` | 1x | Approval |26| 7 | As-Built | `07-*.md` documentation suite | — | — |2728All outputs → `agent-output/{project}/`. Context flows via artifact files + handoffs.29Review column = adversarial passes by `challenger-review-subagent` (3x = rotating lenses; 1x = comprehensive).3031## Skills (Auto-Invoked by Agents)3233| Skill | Purpose |34| -------------------------- | --------------------------------------------------------------------- |35| `azure-defaults` | Regions, tags, naming, AVM, security, governance, pricing |36| `azure-artifacts` | Template H2 structures, styling, generation rules |37| `azure-bicep-patterns` | Reusable Bicep patterns (hub-spoke, PE, diagnostics) |38| `azure-troubleshooting` | KQL templates, health checks, remediation playbooks |39| `azure-diagrams` | Python architecture diagram generation |40| `azure-adr` | Architecture Decision Records |41| `github-operations` | GitHub issues, PRs, CLI, Actions, releases |42| `git-commit` | Commit message conventions |43| `docs-writer` | Documentation generation |44| `make-skill-template` | Scaffold new Agent Skills from templates |45| `microsoft-docs` | Query official Microsoft/Azure docs (requires Learn MCP) |46| `microsoft-code-reference` | Verify SDK methods and find working code samples (requires Learn MCP) |47| `microsoft-skill-creator` | Create hybrid skills for Microsoft technologies (requires Learn MCP) |48| `terraform-patterns` | Terraform HCL patterns (hub-spoke, PE, diagnostics, AVM pitfalls) |4950Agents read skills via: **"Read `.github/skills/{name}/SKILL.md`"** in their body.5152## Chat Triggers5354- If a user message starts with `gh`, treat it as a GitHub operation.55 Examples: `gh pr create ...`, `gh workflow run ...`, `gh api ...`.56- Automatically follow the `github-operations` skill guidance (MCP-first, `gh` CLI fallback) from `.github/skills/github-operations/SKILL.md`.5758### GitHub MCP Priority (Mandatory)5960- For issues and pull requests, always prefer GitHub MCP tools over `gh` CLI.61- Only use `gh` for operations that have no equivalent MCP write tool in the current environment.62- In devcontainers, do not run `gh auth` commands unless the user explicitly asks for CLI authentication troubleshooting.6364## Key Conventions6566See the root `AGENTS.md` for full conventions. Summary of VS Code-specific overrides:6768- **AVM-first**: Always prefer Azure Verified Modules over raw Bicep/Terraform69- **Governance**: Always check `04-governance-constraints.md` for subscription-level Azure Policy7071Full details in `.github/skills/azure-defaults/SKILL.md`.7273### Terraform Conventions7475Full details in `.github/skills/terraform-patterns/SKILL.md` and root `AGENTS.md`.7677## Key Files7879| Path | Purpose |80| --------------------------------- | ------------------------------------------------------- |81| `AGENTS.md` | Cross-agent project conventions and commands |82| `.github/agents/*.agent.md` | Agent definitions |83| `.github/skills/*/SKILL.md` | Reusable skill knowledge |84| `.github/instructions/` | File-type rules (Bicep, Markdown, etc.) |85| `agent-output/{project}/` | Agent-generated artifacts |86| `infra/bicep/{project}/` | Bicep templates |87| `mcp/azure-pricing-mcp/` | Azure Pricing MCP server |88| `.vscode/mcp.json` | MCP server configuration |89| `.vscode/infraops.toolsets.jsonc` | Workspace tool groups for interactive chat (8 toolsets) |90| `infra/terraform/{project}/` | Terraform templates by project |91| `docs/tf-support/` | Terraform support planning docs and prompts |9293## Validation9495See `AGENTS.md` for full build and validation commands. Quick reference:9697```bash98npm run validate:all99npm run lint:md100```
tools-only