# msitarzewski/agency-agents architecture

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

- Interactive diagram: https://gitdiagram.com/msitarzewski/agency-agents
- Repository: https://github.com/msitarzewski/agency-agents
- Video tour (about a minute): https://gitdiagram.com/msitarzewski/agency-agents/video

## Overview

The Agency is a collection of specialized AI-agent prompts, with scripts and integrations for installing or adapting those agents to AI tools. The main user workflow is to choose an agent or team, install it for a supported tool, then activate it in a session. The roster spans many professional domains; the graph groups those domains rather than listing every prompt. The Hermes router is an additional way to search, inspect, load, or delegate to agents. Evidence is limited to the README and sampled Hermes builder excerpts; other implementation links are omitted where their behavior was not shown.

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

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_roster["Agent roster"]
  node_agent_roster["Specialist prompts"]
  node_creative_roster["Creative specialists"]
  node_business_roster["Business specialists"]
  node_research_roster["Research specialists"]
  node_other_rosters["Other domains"]
  node_division_index["Division index<br/>[divisions.json]"]
end

subgraph group_install["Installation"]
  node_installer["Agent installer<br/>[install.sh]"]
  node_converter["Format converter<br/>[convert.sh]"]
end

subgraph group_integrations["Tool integrations"]
  node_hermes_builder["Hermes router builder"]
  node_hermes_tools["Hermes router tools"]
  node_tool_guides["Tool integration guides"]
end

subgraph group_guidance["Workflow guidance"]
  node_strategy_playbooks["Project playbooks"]
  node_runbooks["Scenario runbooks"]
  node_examples["Workflow examples"]
end

node_user(("User"))
node_ai_tool(("AI tool"))

node_user -->|"chooses specialist"| node_agent_roster
node_user -->|"chooses specialist"| node_creative_roster
node_user -->|"chooses specialist"| node_business_roster
node_user -->|"chooses specialist"| node_research_roster
node_user -->|"chooses specialist"| node_other_rosters
node_division_index -.->|"supports selection"| node_installer
node_user -->|"selects agents"| node_installer
node_installer -->|"installs agents"| node_ai_tool
node_user -->|"requests conversion"| node_converter
node_converter -->|"generates integration files"| node_tool_guides
node_user -->|"follows setup guide"| node_tool_guides
node_hermes_builder -->|"collects agent prompts"| node_agent_roster
node_hermes_builder -->|"builds router plugin"| node_hermes_tools
node_ai_tool -.->|"invokes router tools"| node_hermes_tools
node_user -->|"follows project phases"| node_strategy_playbooks
node_user -->|"selects scenario"| node_runbooks
node_user -->|"references workflow"| node_examples

click node_agent_roster "https://github.com/msitarzewski/agency-agents/tree/main/engineering"
click node_creative_roster "https://github.com/msitarzewski/agency-agents/tree/main/design"
click node_business_roster "https://github.com/msitarzewski/agency-agents/tree/main/marketing"
click node_research_roster "https://github.com/msitarzewski/agency-agents/tree/main/academic"
click node_other_rosters "https://github.com/msitarzewski/agency-agents/tree/main/specialized"
click node_division_index "https://github.com/msitarzewski/agency-agents/blob/main/divisions.json"
click node_installer "https://github.com/msitarzewski/agency-agents/blob/main/scripts/install.sh"
click node_converter "https://github.com/msitarzewski/agency-agents/blob/main/scripts/convert.sh"
click node_hermes_builder "https://github.com/msitarzewski/agency-agents/blob/main/scripts/build-hermes-plugin.py"
click node_hermes_tools "https://github.com/msitarzewski/agency-agents/tree/main/integrations/hermes"
click node_tool_guides "https://github.com/msitarzewski/agency-agents/tree/main/integrations"
click node_strategy_playbooks "https://github.com/msitarzewski/agency-agents/tree/main/strategy/playbooks"
click node_runbooks "https://github.com/msitarzewski/agency-agents/tree/main/strategy/runbooks"
click node_examples "https://github.com/msitarzewski/agency-agents/tree/main/examples"

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_agent_roster,node_creative_roster,node_business_roster,node_research_roster,node_other_rosters,node_division_index,node_user toneBlue
class node_installer,node_converter toneAmber
class node_hermes_builder,node_hermes_tools,node_tool_guides toneMint
class node_strategy_playbooks,node_runbooks,node_examples toneRose
class node_ai_tool toneIndigo
```

## Components

### Agent roster

- [Specialist prompts](https://github.com/msitarzewski/agency-agents/tree/main/engineering): `engineering`
- [Creative specialists](https://github.com/msitarzewski/agency-agents/tree/main/design): `design`
- [Business specialists](https://github.com/msitarzewski/agency-agents/tree/main/marketing): `marketing`
- [Research specialists](https://github.com/msitarzewski/agency-agents/tree/main/academic): `academic`
- [Other domains](https://github.com/msitarzewski/agency-agents/tree/main/specialized): `specialized`
- [Division index](https://github.com/msitarzewski/agency-agents/blob/main/divisions.json): `divisions.json`

### Installation

- [Agent installer](https://github.com/msitarzewski/agency-agents/blob/main/scripts/install.sh): `scripts/install.sh`
- [Format converter](https://github.com/msitarzewski/agency-agents/blob/main/scripts/convert.sh): `scripts/convert.sh`

### Tool integrations

- [Hermes router builder](https://github.com/msitarzewski/agency-agents/blob/main/scripts/build-hermes-plugin.py): `scripts/build-hermes-plugin.py`
- [Hermes router tools](https://github.com/msitarzewski/agency-agents/tree/main/integrations/hermes): `integrations/hermes`
- [Tool integration guides](https://github.com/msitarzewski/agency-agents/tree/main/integrations): `integrations`

### Workflow guidance

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

### Other components

- **User**
- **AI tool**

## Connections

- User → Specialist prompts: chooses specialist (evidence: `README.md`)
- User → Creative specialists: chooses specialist (evidence: `README.md`)
- User → Business specialists: chooses specialist (evidence: `README.md`)
- User → Research specialists: chooses specialist (evidence: `README.md`)
- User → Other domains: chooses specialist (evidence: `README.md`)
- Division index → Agent installer: supports selection
- User → Agent installer: selects agents (evidence: `README.md`)
- Agent installer → AI tool: installs agents (evidence: `README.md`)
- User → Format converter: requests conversion (evidence: `README.md`)
- Format converter → Tool integration guides: generates integration files (evidence: `README.md`)
- User → Tool integration guides: follows setup guide (evidence: `README.md`)
- Hermes router builder → Specialist prompts: collects agent prompts (evidence: `scripts/build-hermes-plugin.py`)
- Hermes router builder → Hermes router tools: builds router plugin (evidence: `scripts/build-hermes-plugin.py`)
- AI tool → Hermes router tools: invokes router tools
- User → Project playbooks: follows project phases (evidence: `README.md`)
- User → Scenario runbooks: selects scenario (evidence: `README.md`)
- User → Workflow examples: references workflow (evidence: `README.md`)
