# purecloudlabs/genesys-ava-skills architecture

> Architecture diagram of the GitHub repository purecloudlabs/genesys-ava-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/purecloudlabs/genesys-ava-skills
- Repository: https://github.com/purecloudlabs/genesys-ava-skills

## Overview

AVA is presented as an IDE-based, spec-driven workflow for designing, building, testing, evaluating, and critiquing Genesys Cloud virtual agents. The documented entry point is an IDE agent session, routed by ava-dispatch; the README also describes setup, MCP sign-in, knowledge authoring, publishing, and live sessions. The supplied tree contains installers and documentation but no application source, so runtime components are shown as documented capabilities rather than inspected implementations; edges reflect README statements only.

Main entry points: [`install.sh`](https://github.com/purecloudlabs/genesys-ava-skills/blob/main/install.sh) (Platform installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation and access"]
  node_installer["Platform installer<br/>[install.sh]"]
  node_setup["Setup wizard"]
  node_mcp["AVA MCP server"]
  node_auth["Sign-in and permissions"]
end

subgraph group_author["AVA authoring"]
  node_dispatch["ava-dispatch"]
  node_design["AVA design"]
  node_knowledge["Knowledge authoring"]
  node_build["Build and publish"]
end

subgraph group_validation["Testing and review"]
  node_scenarios["Evaluation scenarios"]
  node_evaluation["AVA evaluation"]
  node_critique["Quality critique"]
  node_session["Published AVA session"]
end

node_developer(("IDE user"))
node_ide["Coding IDE"]
node_genesys["Genesys Cloud"]

node_developer -->|"runs"| node_installer
node_installer -->|"installs CLI for"| node_setup
node_developer -->|"configures"| node_setup
node_setup -->|"registers MCP in"| node_ide
node_ide -->|"starts"| node_mcp
node_mcp -->|"opens sign-in"| node_auth
node_auth -->|"authenticates with"| node_genesys
node_developer -->|"starts agent session"| node_ide
node_ide -->|"invokes"| node_dispatch
node_dispatch -->|"routes to"| node_design
node_dispatch -->|"routes to"| node_knowledge
node_dispatch -->|"routes to"| node_build
node_dispatch -->|"routes to"| node_scenarios
node_dispatch -->|"routes to"| node_evaluation
node_dispatch -->|"routes to"| node_critique
node_dispatch -->|"routes to"| node_session

click node_installer "https://github.com/purecloudlabs/genesys-ava-skills/blob/main/install.sh"

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_installer,node_setup,node_mcp,node_auth,node_developer toneBlue
class node_dispatch,node_design,node_knowledge,node_build toneAmber
class node_scenarios,node_evaluation,node_critique,node_session toneMint
class node_ide,node_genesys toneIndigo
```

## Components

### Installation and access

- [Platform installer](https://github.com/purecloudlabs/genesys-ava-skills/blob/main/install.sh): `install.sh`
- **Setup wizard**
- **AVA MCP server**
- **Sign-in and permissions**

### AVA authoring

- **ava-dispatch**
- **AVA design**
- **Knowledge authoring**
- **Build and publish**

### Testing and review

- **Evaluation scenarios**
- **AVA evaluation**
- **Quality critique**
- **Published AVA session**

### Other components

- **IDE user**
- **Coding IDE**
- **Genesys Cloud**

## Connections

- IDE user → Platform installer: runs (evidence: `README.md`)
- Platform installer → Setup wizard: installs CLI for (evidence: `README.md`)
- IDE user → Setup wizard: configures (evidence: `README.md`)
- Setup wizard → Coding IDE: registers MCP in (evidence: `README.md`)
- Coding IDE → AVA MCP server: starts (evidence: `README.md`)
- AVA MCP server → Sign-in and permissions: opens sign-in (evidence: `README.md`)
- Sign-in and permissions → Genesys Cloud: authenticates with (evidence: `README.md`)
- IDE user → Coding IDE: starts agent session (evidence: `README.md`)
- Coding IDE → ava-dispatch: invokes (evidence: `README.md`)
- ava-dispatch → AVA design: routes to (evidence: `README.md`)
- ava-dispatch → Knowledge authoring: routes to (evidence: `README.md`)
- ava-dispatch → Build and publish: routes to (evidence: `README.md`)
- ava-dispatch → Evaluation scenarios: routes to (evidence: `README.md`)
- ava-dispatch → AVA evaluation: routes to (evidence: `README.md`)
- ava-dispatch → Quality critique: routes to (evidence: `README.md`)
- ava-dispatch → Published AVA session: routes to (evidence: `README.md`)