APEX

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 REST API
 Note right of IaC: Unified IaC Planner (05)<br/>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.