# brunorfernandes-tech/agency-agents architecture

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

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

## Overview

The Agency is a curated library of specialist AI-agent instructions, with scripts and tool-specific integrations for installing or using those agents in supported AI tools. The main workflow is to choose an agent or division, install it into a tool, then activate it in a session; the README also describes browsing agents as reference material. The Hermes builder excerpt shows a separate search, inspect, load, and delegate plugin capability. The sampled source is limited, so links beyond those documented in the README or visible in the builder are omitted.

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

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_roster["Agent roster"]
  node_agents_eng["Engineering agents"]
  node_agents_design["Design agents"]
  node_agents_marketing["Marketing agents"]
  node_agents_domain["Domain agents"]
  node_agents_special["Specialist agents"]
  node_agent_catalog["Agent divisions<br/>[divisions.json]"]
end

subgraph group_workflow["Strategy workflows"]
  node_runbooks["Scenario runbooks"]
  node_playbooks["Project playbooks"]
end

subgraph group_integration["Tool integrations"]
  node_installer["Agent installer<br/>[install.sh]"]
  node_converter["Format converter<br/>[convert.sh]"]
  node_claude_integration["Claude Code setup"]
  node_tool_integrations["Other tool setups"]
end

subgraph group_hermes["Hermes router"]
  node_hermes_builder["Hermes plugin builder"]
  node_hermes_plugin["Hermes router plugin"]
end

node_user(("User"))
node_ai_tool["AI tool"]
node_hermes_runtime["Hermes runtime"]

node_user -->|"chooses specialist"| node_agents_eng
node_user -->|"chooses specialist"| node_agents_design
node_user -->|"chooses specialist"| node_agents_marketing
node_user -->|"browses roster"| node_agents_domain
node_user -->|"browses roster"| node_agents_special
node_user -->|"selects division"| node_agent_catalog
node_user -->|"selects team"| node_runbooks
node_user -->|"follows phases"| node_playbooks
node_user -->|"starts install"| node_installer
node_installer -->|"installs agents"| node_ai_tool
node_user -->|"generates integrations"| node_converter
node_converter -->|"generates files"| node_tool_integrations
node_user -->|"copies agents"| node_claude_integration
node_user -->|"builds plugin"| node_hermes_builder
node_hermes_builder -->|"writes plugin"| node_hermes_plugin
node_hermes_runtime -.->|"loads tools"| node_hermes_plugin
node_hermes_plugin -.->|"searches roster"| node_agents_eng
node_hermes_plugin -.->|"loads specialist"| node_agents_special

click node_agents_eng "https://github.com/brunorfernandes-tech/agency-agents/tree/main/engineering"
click node_agents_design "https://github.com/brunorfernandes-tech/agency-agents/tree/main/design"
click node_agents_marketing "https://github.com/brunorfernandes-tech/agency-agents/tree/main/marketing"
click node_agents_domain "https://github.com/brunorfernandes-tech/agency-agents/tree/main/academic"
click node_agents_special "https://github.com/brunorfernandes-tech/agency-agents/tree/main/specialized"
click node_agent_catalog "https://github.com/brunorfernandes-tech/agency-agents/blob/main/divisions.json"
click node_runbooks "https://github.com/brunorfernandes-tech/agency-agents/tree/main/strategy/runbooks"
click node_playbooks "https://github.com/brunorfernandes-tech/agency-agents/tree/main/strategy/playbooks"
click node_installer "https://github.com/brunorfernandes-tech/agency-agents/blob/main/scripts/install.sh"
click node_converter "https://github.com/brunorfernandes-tech/agency-agents/blob/main/scripts/convert.sh"
click node_claude_integration "https://github.com/brunorfernandes-tech/agency-agents/tree/main/integrations/claude-code"
click node_tool_integrations "https://github.com/brunorfernandes-tech/agency-agents/tree/main/integrations"
click node_hermes_builder "https://github.com/brunorfernandes-tech/agency-agents/blob/main/scripts/build-hermes-plugin.py"
click node_hermes_plugin "https://github.com/brunorfernandes-tech/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_agents_eng,node_agents_design,node_agents_marketing,node_agents_domain,node_agents_special,node_agent_catalog,node_user toneBlue
class node_runbooks,node_playbooks toneAmber
class node_installer,node_converter,node_claude_integration,node_tool_integrations toneMint
class node_hermes_builder,node_hermes_plugin toneRose
class node_ai_tool,node_hermes_runtime toneIndigo
```

## Components

### Agent roster

- [Engineering agents](https://github.com/brunorfernandes-tech/agency-agents/tree/main/engineering): `engineering`
- [Design agents](https://github.com/brunorfernandes-tech/agency-agents/tree/main/design): `design`
- [Marketing agents](https://github.com/brunorfernandes-tech/agency-agents/tree/main/marketing): `marketing`
- [Domain agents](https://github.com/brunorfernandes-tech/agency-agents/tree/main/academic): `academic`
- [Specialist agents](https://github.com/brunorfernandes-tech/agency-agents/tree/main/specialized): `specialized`
- [Agent divisions](https://github.com/brunorfernandes-tech/agency-agents/blob/main/divisions.json): `divisions.json`

### Strategy workflows

- [Scenario runbooks](https://github.com/brunorfernandes-tech/agency-agents/tree/main/strategy/runbooks): `strategy/runbooks`
- [Project playbooks](https://github.com/brunorfernandes-tech/agency-agents/tree/main/strategy/playbooks): `strategy/playbooks`

### Tool integrations

- [Agent installer](https://github.com/brunorfernandes-tech/agency-agents/blob/main/scripts/install.sh): `scripts/install.sh`
- [Format converter](https://github.com/brunorfernandes-tech/agency-agents/blob/main/scripts/convert.sh): `scripts/convert.sh`
- [Claude Code setup](https://github.com/brunorfernandes-tech/agency-agents/tree/main/integrations/claude-code): `integrations/claude-code`
- [Other tool setups](https://github.com/brunorfernandes-tech/agency-agents/tree/main/integrations): `integrations`

### Hermes router

- [Hermes plugin builder](https://github.com/brunorfernandes-tech/agency-agents/blob/main/scripts/build-hermes-plugin.py): `scripts/build-hermes-plugin.py`
- [Hermes router plugin](https://github.com/brunorfernandes-tech/agency-agents/tree/main/integrations/hermes): `integrations/hermes`

### Other components

- **User**
- **AI tool**
- **Hermes runtime**

## Connections

- User → Engineering agents: chooses specialist (evidence: `README.md`)
- User → Design agents: chooses specialist (evidence: `README.md`)
- User → Marketing agents: chooses specialist (evidence: `README.md`)
- User → Domain agents: browses roster (evidence: `README.md`)
- User → Specialist agents: browses roster (evidence: `README.md`)
- User → Agent divisions: selects division (evidence: `README.md`)
- User → Scenario runbooks: selects team (evidence: `README.md`)
- User → Project playbooks: follows phases (evidence: `README.md`)
- User → Agent installer: starts install (evidence: `README.md`)
- Agent installer → AI tool: installs agents (evidence: `README.md`)
- User → Format converter: generates integrations (evidence: `README.md`)
- Format converter → Other tool setups: generates files (evidence: `README.md`)
- User → Claude Code setup: copies agents (evidence: `README.md`)
- User → Hermes plugin builder: builds plugin (evidence: `scripts/build-hermes-plugin.py`)
- Hermes plugin builder → Hermes router plugin: writes plugin (evidence: `scripts/build-hermes-plugin.py`)
- Hermes runtime → Hermes router plugin: loads tools
- Hermes router plugin → Engineering agents: searches roster
- Hermes router plugin → Specialist agents: loads specialist
