# iammukeshm/agency-agents architecture

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

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

## Overview

The Agency is a curated library of specialist AI-agent prompts, organized by professional division and designed to be browsed, adapted, or installed into supported AI tools. The main workflow is to choose a specialist, then use its prompt in a session or install it through the provided integrations. The README documents the broad roster and installation options; the sampled source additionally shows how the Hermes integration builds a searchable, lazily loaded roster. Source-level relationships beyond those excerpts are not inferred.

Main entry points: [`scripts/build-hermes-plugin.py`](https://github.com/iammukeshm/agency-agents/blob/main/scripts/build-hermes-plugin.py) (Hermes roster builder), [`engineering`](https://github.com/iammukeshm/agency-agents/tree/main/engineering) (Engineering), [`scripts/install.sh`](https://github.com/iammukeshm/agency-agents/blob/main/scripts/install.sh) (Agent installer), [`integrations/hermes`](https://github.com/iammukeshm/agency-agents/tree/main/integrations/hermes) (Hermes plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_roster["Agent roster"]
  node_engineering["Engineering"]
  node_design["Design"]
  node_research["Research"]
  node_marketing["Marketing"]
  node_product["Product"]
  node_operations["Business operations"]
  node_other["Other specialties"]
end

subgraph group_integrations["Tool integrations"]
  node_installer["Agent installer<br/>[install.sh]"]
  node_converter["Integration converter<br/>[convert.sh]"]
  node_tool["AI tools"]
end

subgraph group_hermes["Hermes router"]
  node_hermes_builder["Hermes roster builder"]
  node_hermes_plugin["Hermes plugin"]
  node_agent_data["Agent data"]
end

node_user(("User"))

node_user -->|"chooses specialist"| node_engineering
node_user -->|"chooses specialist"| node_design
node_user -->|"chooses specialist"| node_research
node_user -->|"chooses specialist"| node_marketing
node_user -->|"chooses specialist"| node_product
node_user -->|"chooses specialist"| node_operations
node_user -->|"chooses specialist"| node_other
node_engineering -->|"installs agents"| node_installer
node_installer -->|"installs into"| node_tool
node_converter -->|"generates integration files"| node_tool
node_hermes_builder -->|"generates plugin"| node_hermes_plugin
node_hermes_builder -->|"writes roster JSON"| node_agent_data
node_hermes_plugin -->|"searches and loads"| node_agent_data

click node_engineering "https://github.com/iammukeshm/agency-agents/tree/main/engineering"
click node_design "https://github.com/iammukeshm/agency-agents/tree/main/design"
click node_research "https://github.com/iammukeshm/agency-agents/tree/main/academic"
click node_marketing "https://github.com/iammukeshm/agency-agents/tree/main/marketing"
click node_product "https://github.com/iammukeshm/agency-agents/tree/main/product"
click node_operations "https://github.com/iammukeshm/agency-agents/tree/main/specialized"
click node_other "https://github.com/iammukeshm/agency-agents/tree/main/testing"
click node_installer "https://github.com/iammukeshm/agency-agents/blob/main/scripts/install.sh"
click node_converter "https://github.com/iammukeshm/agency-agents/blob/main/scripts/convert.sh"
click node_hermes_builder "https://github.com/iammukeshm/agency-agents/blob/main/scripts/build-hermes-plugin.py"
click node_hermes_plugin "https://github.com/iammukeshm/agency-agents/tree/main/integrations/hermes"
click node_agent_data "https://github.com/iammukeshm/agency-agents/tree/main/integrations/hermes"

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_engineering,node_design,node_research,node_marketing,node_product,node_operations,node_other,node_user toneBlue
class node_installer,node_converter,node_tool toneAmber
class node_hermes_builder,node_hermes_plugin,node_agent_data toneMint
```

## Components

### Agent roster

- [Engineering](https://github.com/iammukeshm/agency-agents/tree/main/engineering): `engineering`
- [Design](https://github.com/iammukeshm/agency-agents/tree/main/design): `design`
- [Research](https://github.com/iammukeshm/agency-agents/tree/main/academic): `academic`
- [Marketing](https://github.com/iammukeshm/agency-agents/tree/main/marketing): `marketing`
- [Product](https://github.com/iammukeshm/agency-agents/tree/main/product): `product`
- [Business operations](https://github.com/iammukeshm/agency-agents/tree/main/specialized): `specialized`
- [Other specialties](https://github.com/iammukeshm/agency-agents/tree/main/testing): `testing`

### Tool integrations

- [Agent installer](https://github.com/iammukeshm/agency-agents/blob/main/scripts/install.sh): `scripts/install.sh`
- [Integration converter](https://github.com/iammukeshm/agency-agents/blob/main/scripts/convert.sh): `scripts/convert.sh`
- **AI tools**

### Hermes router

- [Hermes roster builder](https://github.com/iammukeshm/agency-agents/blob/main/scripts/build-hermes-plugin.py): `scripts/build-hermes-plugin.py`
- [Hermes plugin](https://github.com/iammukeshm/agency-agents/tree/main/integrations/hermes): `integrations/hermes`
- [Agent data](https://github.com/iammukeshm/agency-agents/tree/main/integrations/hermes): `integrations/hermes`

### Other components

- **User**

## Connections

- User → Engineering: chooses specialist (evidence: `README.md`)
- User → Design: chooses specialist (evidence: `README.md`)
- User → Research: chooses specialist (evidence: `README.md`)
- User → Marketing: chooses specialist (evidence: `README.md`)
- User → Product: chooses specialist (evidence: `README.md`)
- User → Business operations: chooses specialist (evidence: `README.md`)
- User → Other specialties: chooses specialist (evidence: `README.md`)
- Engineering → Agent installer: installs agents (evidence: `README.md`)
- Agent installer → AI tools: installs into (evidence: `README.md`)
- Integration converter → AI tools: generates integration files (evidence: `README.md`)
- Hermes roster builder → Hermes plugin: generates plugin (evidence: `scripts/build-hermes-plugin.py`)
- Hermes roster builder → Agent data: writes roster JSON (evidence: `scripts/build-hermes-plugin.py`)
- Hermes plugin → Agent data: searches and loads
