# sanjairajbhogaai/agency-agents architecture

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

- Interactive diagram: https://gitdiagram.com/sanjairajbhogaai/agency-agents
- Repository: https://github.com/sanjairajbhogaai/agency-agents

## Overview

The Agency is a curated roster of role-specific AI agent instructions, with scripts and integrations for installing or exposing selected specialists in AI coding tools. The main user journey is to browse or select agents, then install them into a supported runtime. The README documents this workflow and the multi-tool options; the sampled Hermes builder shows roster parsing and tool registration, but most installer and integration internals were not sampled.

Main entry points: [`scripts/build-hermes-plugin.py`](https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/build-hermes-plugin.py) (Hermes router builder), [`scripts/install.sh`](https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/install.sh) (Agent installer), [`scripts/convert.sh`](https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/convert.sh) (Integration converter), [`integrations/hermes`](https://github.com/sanjairajbhogaai/agency-agents/tree/main/integrations/hermes) (Hermes integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_roster["Agent roster"]
  node_browse["Browse specialists"]
  node_engineering["Engineering agents"]
  node_marketing["Marketing agents"]
  node_specialized["Specialist agents"]
  node_other_divisions["Other divisions"]
end

subgraph group_delivery["Install and convert"]
  node_installer["Agent installer<br/>[install.sh]"]
  node_converter["Integration converter<br/>[convert.sh]"]
  node_hermes_builder["Hermes router builder"]
end

subgraph group_integrations["Tool integrations"]
  node_tool_runtimes["AI tool runtimes"]
  node_hermes["Hermes integration"]
  node_other_integrations["Other integrations"]
end

node_user(("User"))

node_user -->|"browses"| node_browse
node_user -->|"selects agents"| node_installer
node_browse -->|"offers"| node_engineering
node_browse -->|"offers"| node_marketing
node_browse -->|"offers"| node_specialized
node_browse -->|"offers"| node_other_divisions
node_installer -->|"installs agents"| node_tool_runtimes
node_user -->|"requests conversion"| node_converter
node_converter -->|"generates files"| node_other_integrations
node_hermes_builder -->|"builds plugin"| node_hermes
node_hermes_builder -->|"collects roster"| node_engineering
node_hermes -->|"exposes tools"| node_tool_runtimes

click node_engineering "https://github.com/sanjairajbhogaai/agency-agents/tree/main/engineering"
click node_marketing "https://github.com/sanjairajbhogaai/agency-agents/tree/main/marketing"
click node_specialized "https://github.com/sanjairajbhogaai/agency-agents/tree/main/specialized"
click node_installer "https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/install.sh"
click node_converter "https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/convert.sh"
click node_hermes_builder "https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/build-hermes-plugin.py"
click node_hermes "https://github.com/sanjairajbhogaai/agency-agents/tree/main/integrations/hermes"
click node_other_integrations "https://github.com/sanjairajbhogaai/agency-agents/tree/main/integrations"

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_browse,node_engineering,node_marketing,node_specialized,node_other_divisions,node_user toneBlue
class node_installer,node_converter,node_hermes_builder toneAmber
class node_tool_runtimes,node_hermes,node_other_integrations toneMint
```

## Components

### Agent roster

- **Browse specialists**
- [Engineering agents](https://github.com/sanjairajbhogaai/agency-agents/tree/main/engineering): `engineering`
- [Marketing agents](https://github.com/sanjairajbhogaai/agency-agents/tree/main/marketing): `marketing`
- [Specialist agents](https://github.com/sanjairajbhogaai/agency-agents/tree/main/specialized): `specialized`
- **Other divisions**

### Install and convert

- [Agent installer](https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/install.sh): `scripts/install.sh`
- [Integration converter](https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/convert.sh): `scripts/convert.sh`
- [Hermes router builder](https://github.com/sanjairajbhogaai/agency-agents/blob/main/scripts/build-hermes-plugin.py): `scripts/build-hermes-plugin.py`

### Tool integrations

- **AI tool runtimes**
- [Hermes integration](https://github.com/sanjairajbhogaai/agency-agents/tree/main/integrations/hermes): `integrations/hermes`
- [Other integrations](https://github.com/sanjairajbhogaai/agency-agents/tree/main/integrations): `integrations`

### Other components

- **User**

## Connections

- User → Browse specialists: browses (evidence: `README.md`)
- User → Agent installer: selects agents (evidence: `README.md`)
- Browse specialists → Engineering agents: offers (evidence: `README.md`)
- Browse specialists → Marketing agents: offers (evidence: `README.md`)
- Browse specialists → Specialist agents: offers (evidence: `README.md`)
- Browse specialists → Other divisions: offers (evidence: `README.md`)
- Agent installer → AI tool runtimes: installs agents (evidence: `README.md`)
- User → Integration converter: requests conversion (evidence: `README.md`)
- Integration converter → Other integrations: generates files (evidence: `README.md`)
- Hermes router builder → Hermes integration: builds plugin (evidence: `scripts/build-hermes-plugin.py`)
- Hermes router builder → Engineering agents: collects roster (evidence: `scripts/build-hermes-plugin.py`)
- Hermes integration → AI tool runtimes: exposes tools
