https://github.com/jonathan-vella/apex
APEX turns Azure platform engineering requirements into verified, deploy-ready IaC — powered by GitHub Copilot agents, real-time pricing, and built-in compliance.
https://github.com/jonathan-vella/apex
agentic-ai agents anthropic azure azureverifiedmodules bicep cluade copilot github gpt iac infrastructure-as-code microsoft openai skills terraform vscode well-architected-framework
Last synced: about 2 hours ago
JSON representation
APEX turns Azure platform engineering requirements into verified, deploy-ready IaC — powered by GitHub Copilot agents, real-time pricing, and built-in compliance.
- Host: GitHub
- URL: https://github.com/jonathan-vella/apex
- Owner: jonathan-vella
- License: mit
- Created: 2025-12-04T07:50:25.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-06-22T14:02:28.000Z (6 days ago)
- Last Synced: 2026-06-22T16:04:30.616Z (6 days ago)
- Topics: agentic-ai, agents, anthropic, azure, azureverifiedmodules, bicep, cluade, copilot, github, gpt, iac, infrastructure-as-code, microsoft, openai, skills, terraform, vscode, well-architected-framework
- Language: JavaScript
- Homepage: https://apexops.pro/
- Size: 76.5 MB
- Stars: 211
- Watchers: 8
- Forks: 76
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
# APEX
 
Agentic Platform Engineering eXperience for Azure.
This repository is the source project for a multi-agent workflow that turns Azure
platform engineering requirements into deployable Bicep or Terraform with human approval
gates across the lifecycle.
The full documentation for this repository lives here:
- [APEX documentation](https://apexops.pro/)
Key entry points:
- [Accelerator template](https://github.com/jonathan-vella/apex-accelerator)
- [MicroHack](https://microhack.apexops.pro/)
- [Contributing guide](CONTRIBUTING.md)
## Workflow
```mermaid
sequenceDiagram
autonumber
participant U as User
participant O as Orchestrator
participant R as Requirements
participant X as Challenger
participant A as Architect
participant IaC as IaC Plan
participant Gen as IaC Code
participant D as Deploy
participant W as As-Built
Note over C: ORCHESTRATION LAYER
AI prepares. Humans decide.
U->>C: Describe infrastructure intent
C->>R: Translate intent into structured requirements
R-->>C: 01-requirements.md (includes iac_tool selection)
C->>X: Challenge requirements
X-->>C: challenge-findings.json
C->>U: Present requirements + challenge findings
rect rgba(255, 200, 0, 0.15)
Note over U,C: HUMAN APPROVAL GATE
U-->>C: Approve requirements
end
C->>A: Assess architecture (WAF + Cost)
Note right of A: cost-estimate-subagent
handles pricing queries
A-->>C: 02-assessment.md + 03-cost-estimate.md
C->>X: Challenge architecture
X-->>C: challenge-findings.json
C->>U: Present architecture + challenge findings
rect rgba(255, 200, 0, 0.15)
Note over U,C: HUMAN APPROVAL GATE
U-->>C: Approve architecture
end
C->>IaC: Create implementation plan + governance
Note right of IaC: azure-governance-discovery skill
queries Azure Policy via REST API
Note right of IaC: Unified IaC Planner (05)
routes based on decisions.iac_tool
IaC-->>C: 04-plan.md + governance constraints
C->>X: Challenge implementation plan
X-->>C: challenge-findings.json
C->>U: Present plan + challenge findings
rect rgba(255, 200, 0, 0.15)
Note over U,C: HUMAN APPROVAL GATE
U-->>C: Approve plan
end
C->>Gen: Generate IaC templates (AVM-first)
Note right of Gen: Bicep codegen or Terraform codegen
Gen-->>C: infra/bicep/{project} or infra/terraform/{project}
rect rgba(0, 150, 255, 0.08)
Note over C,Gen: Validation loop
alt Validation passes
C->>U: Present templates for deployment
rect rgba(255, 200, 0, 0.15)
Note over U,C: HUMAN APPROVAL GATE
U-->>C: Approve for deployment
end
else Validation fails
C->>Gen: Revise with feedback
end
end
C->>D: Execute deployment
Note right of D: what-if or terraform plan preview first
D-->>C: 06-deployment-summary.md
C->>U: Present deployment summary
rect rgba(255, 200, 0, 0.15)
Note over U,D: HUMAN VERIFICATION
U-->>C: Verify deployment
end
C->>W: Generate workload documentation
Note right of W: Reads prior artifacts and deployed resource state
W-->>C: 07-*.md documentation suite
C->>U: Present as-built docs
Note over U,W: AI orchestrated. Human governed. Azure ready.
```
## Start Here
For new projects, use the Accelerator template rather than cloning this repository
directly.
1. Create a repository from the [Accelerator template](https://github.com/jonathan-vella/apex-accelerator).
2. Open that repository in VS Code and reopen it in the dev container.
3. Start with the published docs:
[https://apexops.pro/](https://apexops.pro/)
## What This Repository Contains
- Agent definitions, skills, and instruction files for the workflow engine
- Reference implementations for Bicep and Terraform tracks
- Validation scripts, MCP configuration, and sample agent outputs
- `apex-recall` CLI for progressive session recall across agent-output projects
- Source content for the published documentation site
## License
MIT. See [LICENSE](LICENSE).