# microsoft/agent-academy architecture

> Architecture diagram of the GitHub repository microsoft/agent-academy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/agent-academy
- Repository: https://github.com/microsoft/agent-academy

## Overview

Copilot Studio Agent Academy is a documentation site for learning to build agents, with a three-part course as its principal learner journey. The repository also contains standalone mission collections, events, and product/industry reference pages. The README establishes the course purpose and names the course sections, but no site-runtime source was excerpted; the graph therefore shows the documented content journey rather than inferred implementation calls.

Main entry points: [`docs/index.md`](https://github.com/microsoft/agent-academy/blob/main/docs/index.md) (Academy Site), [`docs/recruit`](https://github.com/microsoft/agent-academy/tree/main/docs/recruit) (Recruit Course), [`docs/operative`](https://github.com/microsoft/agent-academy/tree/main/docs/operative) (Operative Course), [`docs/commander`](https://github.com/microsoft/agent-academy/tree/main/docs/commander) (Commander Course)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Core Courses"]
  node_recruit["Recruit Course"]
  node_operative["Operative Course"]
  node_commander["Commander Course"]
  node_recruit_next["Recruit Nextgen"]
  node_operative_next["Operative Nextgen"]
  node_commander_preview["Commander Preview"]
end

subgraph group_missions["Mission Collections"]
  node_special_ops["Special Ops"]
  node_cowork["Cowork Collective"]
end

subgraph group_reference["Reference Content"]
  node_events["Events"]
  node_industries["Industry Pages"]
  node_products["Product Pages"]
  node_tags["Tag Index"]
end

subgraph group_site["Academy Entry"]
  node_academy["Academy Site<br/>[index.md]"]
end

node_learner(("Learner"))

node_learner -->|"visits"| node_academy
node_academy -->|"offers course"| node_recruit
node_academy -->|"offers course"| node_operative
node_academy -->|"offers course"| node_commander
node_academy -->|"includes course"| node_recruit_next
node_academy -->|"includes course"| node_operative_next
node_academy -->|"includes preview"| node_commander_preview
node_academy -->|"includes missions"| node_special_ops
node_academy -->|"includes missions"| node_cowork
node_academy -.->|"includes events"| node_events
node_academy -.->|"includes reference"| node_industries
node_academy -.->|"includes reference"| node_products
node_academy -.->|"indexes topics"| node_tags

click node_academy "https://github.com/microsoft/agent-academy/blob/main/docs/index.md"
click node_recruit "https://github.com/microsoft/agent-academy/tree/main/docs/recruit"
click node_operative "https://github.com/microsoft/agent-academy/tree/main/docs/operative"
click node_commander "https://github.com/microsoft/agent-academy/tree/main/docs/commander"
click node_recruit_next "https://github.com/microsoft/agent-academy/tree/main/docs/recruit-nextgen"
click node_operative_next "https://github.com/microsoft/agent-academy/tree/main/docs/operative-nextgen"
click node_commander_preview "https://github.com/microsoft/agent-academy/tree/main/docs/commander-preview"
click node_special_ops "https://github.com/microsoft/agent-academy/tree/main/docs/special-ops"
click node_cowork "https://github.com/microsoft/agent-academy/tree/main/docs/cowork-collective"
click node_events "https://github.com/microsoft/agent-academy/tree/main/docs/events"
click node_industries "https://github.com/microsoft/agent-academy/tree/main/docs/industries"
click node_products "https://github.com/microsoft/agent-academy/tree/main/docs/products"
click node_tags "https://github.com/microsoft/agent-academy/tree/main/docs/tags"

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_recruit,node_operative,node_commander,node_recruit_next,node_operative_next,node_commander_preview toneBlue
class node_special_ops,node_cowork toneAmber
class node_events,node_industries,node_products,node_tags toneMint
class node_academy toneRose
class node_learner toneIndigo
```

## Components

### Core Courses

- [Recruit Course](https://github.com/microsoft/agent-academy/tree/main/docs/recruit): `docs/recruit`
- [Operative Course](https://github.com/microsoft/agent-academy/tree/main/docs/operative): `docs/operative`
- [Commander Course](https://github.com/microsoft/agent-academy/tree/main/docs/commander): `docs/commander`
- [Recruit Nextgen](https://github.com/microsoft/agent-academy/tree/main/docs/recruit-nextgen): `docs/recruit-nextgen`
- [Operative Nextgen](https://github.com/microsoft/agent-academy/tree/main/docs/operative-nextgen): `docs/operative-nextgen`
- [Commander Preview](https://github.com/microsoft/agent-academy/tree/main/docs/commander-preview): `docs/commander-preview`

### Mission Collections

- [Special Ops](https://github.com/microsoft/agent-academy/tree/main/docs/special-ops): `docs/special-ops`
- [Cowork Collective](https://github.com/microsoft/agent-academy/tree/main/docs/cowork-collective): `docs/cowork-collective`

### Reference Content

- [Events](https://github.com/microsoft/agent-academy/tree/main/docs/events): `docs/events`
- [Industry Pages](https://github.com/microsoft/agent-academy/tree/main/docs/industries): `docs/industries`
- [Product Pages](https://github.com/microsoft/agent-academy/tree/main/docs/products): `docs/products`
- [Tag Index](https://github.com/microsoft/agent-academy/tree/main/docs/tags): `docs/tags`

### Academy Entry

- [Academy Site](https://github.com/microsoft/agent-academy/blob/main/docs/index.md): `docs/index.md`

### Other components

- **Learner**

## Connections

- Learner → Academy Site: visits (evidence: `README.md`)
- Academy Site → Recruit Course: offers course (evidence: `README.md`)
- Academy Site → Operative Course: offers course (evidence: `README.md`)
- Academy Site → Commander Course: offers course (evidence: `README.md`)
- Academy Site → Recruit Nextgen: includes course (evidence: `README.md`)
- Academy Site → Operative Nextgen: includes course (evidence: `README.md`)
- Academy Site → Commander Preview: includes preview (evidence: `README.md`)
- Academy Site → Special Ops: includes missions (evidence: `README.md`)
- Academy Site → Cowork Collective: includes missions (evidence: `README.md`)
- Academy Site → Events: includes events
- Academy Site → Industry Pages: includes reference
- Academy Site → Product Pages: includes reference
- Academy Site → Tag Index: indexes topics
