# schoolofdevops/309-agentic-iac-labs architecture

> Architecture diagram of the GitHub repository schoolofdevops/309-agentic-iac-labs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/schoolofdevops/309-agentic-iac-labs
- Repository: https://github.com/schoolofdevops/309-agentic-iac-labs

## Overview

This repository is a learner-lab course, not a single deployed application. Its documented progression moves from governed Terraform repair through planning, context, tools, workflow evaluation, and infrastructure foundations; later sections extend the material toward security, workload deployment, and GitOps. The graph keeps those domain stages distinct and includes the sampled MCP, workflow-harness, and GitOps lifecycle components. Source coverage is uneven: some connections are documented or visible in excerpts, while unsampled lab internals are represented only by their existing directories.

Main entry points: [`section-10/scripts/run-gitops-lifecycle.mjs`](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/run-gitops-lifecycle.mjs) (GitOps lifecycle), [`section-10/scripts/prepare-git-mirror.mjs`](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/prepare-git-mirror.mjs) (Prepare Git mirror), [`section-10/scripts/cleanup-gitops.mjs`](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/cleanup-gitops.mjs) (GitOps cleanup), [`section-6/starter/harness/run-workflow.mjs`](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/run-workflow.mjs) (Workflow runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course stages"]
  node_repair["Governed repair"]
  node_plan["Change planning"]
  node_context["Context curation"]
end

subgraph group_agent["Agent workflow"]
  node_capabilities["Tools and skills"]
  node_mcp["MCP context server<br/>[server.mjs]"]
  node_workflow["Workflow runner<br/>[run-workflow.mjs]"]
  node_harness_core["Harness operations<br/>[core.mjs]"]
  node_run_eval["Run evaluator<br/>[evaluate-run.mjs]"]
end

subgraph group_delivery["Workload delivery"]
  node_foundation["Infrastructure foundation"]
  node_evidence["Evidence pipeline"]
  node_workload["AI workload platform"]
end

subgraph group_gitops["GitOps lifecycle"]
  node_delivery_lab["Reviewed delivery"]
  node_approval_gate["Approval gate"]
  node_lifecycle["GitOps lifecycle"]
  node_mirror_prepare["Prepare Git mirror"]
  node_mirror_start["Start Git mirror"]
  node_mirror_stop["Stop Git mirror"]
  node_cleanup["GitOps cleanup<br/>[cleanup-gitops.mjs]"]
end

node_learner(("Learner"))

node_learner -->|"learns repair"| node_repair
node_learner -->|"learns planning"| node_plan
node_learner -->|"learns context"| node_context
node_learner -->|"learns tooling"| node_capabilities
node_learner -->|"learns workflows"| node_workflow
node_learner -->|"learns infrastructure"| node_foundation
node_workflow -->|"uses operations"| node_harness_core
node_run_eval -->|"uses helpers"| node_harness_core
node_learner -.->|"reads context"| node_mcp
node_lifecycle -->|"starts mirror"| node_mirror_start
node_lifecycle -->|"stops mirror"| node_mirror_stop
node_mirror_start -->|"loads state"| node_mirror_prepare
node_mirror_stop -->|"loads state"| node_mirror_prepare
node_approval_gate -->|"references runner"| node_lifecycle
node_cleanup -->|"uses lifecycle config"| node_lifecycle
node_cleanup -->|"loads mirror state"| node_mirror_prepare

click node_repair "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-2"
click node_plan "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-3"
click node_context "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-4"
click node_capabilities "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-5"
click node_mcp "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-5/starter/mcp/server.mjs"
click node_workflow "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/run-workflow.mjs"
click node_harness_core "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/lib/core.mjs"
click node_run_eval "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/evaluate-run.mjs"
click node_foundation "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-7"
click node_evidence "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-8"
click node_workload "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-9"
click node_delivery_lab "https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-10"
click node_approval_gate "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/open-gitops-approval-gate.mjs"
click node_lifecycle "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/run-gitops-lifecycle.mjs"
click node_mirror_prepare "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/prepare-git-mirror.mjs"
click node_mirror_start "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/start-git-mirror.mjs"
click node_mirror_stop "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/stop-git-mirror.mjs"
click node_cleanup "https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/cleanup-gitops.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_repair,node_plan,node_context toneBlue
class node_capabilities,node_mcp,node_workflow,node_harness_core,node_run_eval toneAmber
class node_foundation,node_evidence,node_workload toneMint
class node_delivery_lab,node_approval_gate,node_lifecycle,node_mirror_prepare,node_mirror_start,node_mirror_stop,node_cleanup toneRose
class node_learner toneIndigo
```

## Components

### Course stages

- [Governed repair](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-2): `section-2`
- [Change planning](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-3): `section-3`
- [Context curation](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-4): `section-4`

### Agent workflow

- [Tools and skills](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-5): `section-5`
- [MCP context server](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-5/starter/mcp/server.mjs): `section-5/starter/mcp/server.mjs`
- [Workflow runner](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/run-workflow.mjs): `section-6/starter/harness/run-workflow.mjs`
- [Harness operations](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/lib/core.mjs): `section-6/starter/harness/lib/core.mjs`
- [Run evaluator](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-6/starter/harness/evaluate-run.mjs): `section-6/starter/harness/evaluate-run.mjs`

### Workload delivery

- [Infrastructure foundation](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-7): `section-7`
- [Evidence pipeline](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-8): `section-8`
- [AI workload platform](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-9): `section-9`

### GitOps lifecycle

- [Reviewed delivery](https://github.com/schoolofdevops/309-agentic-iac-labs/tree/main/section-10): `section-10`
- [Approval gate](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/open-gitops-approval-gate.mjs): `section-10/scripts/open-gitops-approval-gate.mjs`
- [GitOps lifecycle](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/run-gitops-lifecycle.mjs): `section-10/scripts/run-gitops-lifecycle.mjs`
- [Prepare Git mirror](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/prepare-git-mirror.mjs): `section-10/scripts/prepare-git-mirror.mjs`
- [Start Git mirror](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/start-git-mirror.mjs): `section-10/scripts/start-git-mirror.mjs`
- [Stop Git mirror](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/stop-git-mirror.mjs): `section-10/scripts/stop-git-mirror.mjs`
- [GitOps cleanup](https://github.com/schoolofdevops/309-agentic-iac-labs/blob/main/section-10/scripts/cleanup-gitops.mjs): `section-10/scripts/cleanup-gitops.mjs`

### Other components

- **Learner**

## Connections

- Learner → Governed repair: learns repair (evidence: `README.md`)
- Learner → Change planning: learns planning (evidence: `README.md`)
- Learner → Context curation: learns context (evidence: `README.md`)
- Learner → Tools and skills: learns tooling (evidence: `README.md`)
- Learner → Workflow runner: learns workflows (evidence: `README.md`)
- Learner → Infrastructure foundation: learns infrastructure (evidence: `README.md`)
- Workflow runner → Harness operations: uses operations (evidence: `section-6/starter/harness/run-workflow.mjs`)
- Run evaluator → Harness operations: uses helpers (evidence: `section-6/starter/harness/evaluate-run.mjs`)
- Learner → MCP context server: reads context
- GitOps lifecycle → Start Git mirror: starts mirror (evidence: `section-10/scripts/run-gitops-lifecycle.mjs`)
- GitOps lifecycle → Stop Git mirror: stops mirror (evidence: `section-10/scripts/run-gitops-lifecycle.mjs`)
- Start Git mirror → Prepare Git mirror: loads state (evidence: `section-10/scripts/start-git-mirror.mjs`)
- Stop Git mirror → Prepare Git mirror: loads state (evidence: `section-10/scripts/stop-git-mirror.mjs`)
- Approval gate → GitOps lifecycle: references runner (evidence: `section-10/scripts/open-gitops-approval-gate.mjs`)
- GitOps cleanup → GitOps lifecycle: uses lifecycle config (evidence: `section-10/scripts/cleanup-gitops.mjs`)
- GitOps cleanup → Prepare Git mirror: loads mirror state (evidence: `section-10/scripts/cleanup-gitops.mjs`)
