jonathan-vella/apex

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

Key entry points:

• Accelerator template
• MicroHack
• Contributing guide

Workflow

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<br/>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<br/>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<br/>queries Azure Policy via R