# parham-wien/agency-agents architecture

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

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

## Overview

The Agency is a collection of specialist AI-agent prompts, organized by professional division and intended to be selected, activated, or adapted for a task. The README documents both direct use and installation into supported AI tools. A separate Hermes integration builder collects the roster for a lazy-search plugin; the excerpt shows its roster collection and tool behavior, but not the generated plugin files. The graph emphasizes the prompt library and these documented use paths; it does not infer interactions among divisions.

Main entry points: [`scripts/build-hermes-plugin.py`](https://github.com/parham-wien/agency-agents/blob/main/scripts/build-hermes-plugin.py) (Hermes roster builder), [`engineering`](https://github.com/parham-wien/agency-agents/tree/main/engineering) (Engineering), [`design`](https://github.com/parham-wien/agency-agents/tree/main/design) (Design), [`academic`](https://github.com/parham-wien/agency-agents/tree/main/academic) (Research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_roster["Specialist roster"]
  node_roster["Agent collection"]
end

subgraph group_work["Work domains"]
  node_engineering["Engineering"]
  node_design["Design"]
  node_research["Research"]
  node_finance["Finance"]
  node_marketing["Marketing"]
  node_product["Product"]
  node_security["Security"]
  node_testing["Testing"]
  node_specialized["Specialized services"]
  node_project["Project management"]
  node_game["Game development"]
  node_gis["GIS and spatial"]
  node_healthcare["Healthcare"]
end

subgraph group_integrations["Tool integrations"]
  node_integration_docs["Integration guides"]
  node_hermes_builder["Hermes roster builder"]
end

node_user(("User"))

node_user -->|"browses or adapts"| node_roster
node_user -->|"activates or installs"| node_engineering
node_user -->|"selects specialist"| node_design
node_user -->|"selects specialist"| node_research
node_user -->|"selects specialist"| node_finance
node_user -->|"selects specialist"| node_marketing
node_user -->|"selects specialist"| node_product
node_user -->|"selects specialist"| node_security
node_user -->|"selects specialist"| node_testing
node_user -->|"selects specialist"| node_specialized
node_user -->|"selects specialist"| node_project
node_user -->|"selects specialist"| node_game
node_user -->|"selects specialist"| node_gis
node_user -->|"selects specialist"| node_healthcare
node_user -->|"follows setup guide"| node_integration_docs
node_hermes_builder -->|"collects agents"| node_roster

click node_engineering "https://github.com/parham-wien/agency-agents/tree/main/engineering"
click node_design "https://github.com/parham-wien/agency-agents/tree/main/design"
click node_research "https://github.com/parham-wien/agency-agents/tree/main/academic"
click node_finance "https://github.com/parham-wien/agency-agents/tree/main/finance"
click node_marketing "https://github.com/parham-wien/agency-agents/tree/main/marketing"
click node_product "https://github.com/parham-wien/agency-agents/tree/main/product"
click node_security "https://github.com/parham-wien/agency-agents/tree/main/security"
click node_testing "https://github.com/parham-wien/agency-agents/tree/main/testing"
click node_specialized "https://github.com/parham-wien/agency-agents/tree/main/specialized"
click node_project "https://github.com/parham-wien/agency-agents/tree/main/project-management"
click node_game "https://github.com/parham-wien/agency-agents/tree/main/game-development"
click node_gis "https://github.com/parham-wien/agency-agents/tree/main/gis"
click node_healthcare "https://github.com/parham-wien/agency-agents/tree/main/healthcare"
click node_integration_docs "https://github.com/parham-wien/agency-agents/tree/main/integrations"
click node_hermes_builder "https://github.com/parham-wien/agency-agents/blob/main/scripts/build-hermes-plugin.py"

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_roster,node_user toneBlue
class node_engineering,node_design,node_research,node_finance,node_marketing,node_product,node_security,node_testing,node_specialized,node_project,node_game,node_gis,node_healthcare toneAmber
class node_integration_docs,node_hermes_builder toneMint
```

## Components

### Specialist roster

- **Agent collection**

### Work domains

- [Engineering](https://github.com/parham-wien/agency-agents/tree/main/engineering): `engineering`
- [Design](https://github.com/parham-wien/agency-agents/tree/main/design): `design`
- [Research](https://github.com/parham-wien/agency-agents/tree/main/academic): `academic`
- [Finance](https://github.com/parham-wien/agency-agents/tree/main/finance): `finance`
- [Marketing](https://github.com/parham-wien/agency-agents/tree/main/marketing): `marketing`
- [Product](https://github.com/parham-wien/agency-agents/tree/main/product): `product`
- [Security](https://github.com/parham-wien/agency-agents/tree/main/security): `security`
- [Testing](https://github.com/parham-wien/agency-agents/tree/main/testing): `testing`
- [Specialized services](https://github.com/parham-wien/agency-agents/tree/main/specialized): `specialized`
- [Project management](https://github.com/parham-wien/agency-agents/tree/main/project-management): `project-management`
- [Game development](https://github.com/parham-wien/agency-agents/tree/main/game-development): `game-development`
- [GIS and spatial](https://github.com/parham-wien/agency-agents/tree/main/gis): `gis`
- [Healthcare](https://github.com/parham-wien/agency-agents/tree/main/healthcare): `healthcare`

### Tool integrations

- [Integration guides](https://github.com/parham-wien/agency-agents/tree/main/integrations): `integrations`
- [Hermes roster builder](https://github.com/parham-wien/agency-agents/blob/main/scripts/build-hermes-plugin.py): `scripts/build-hermes-plugin.py`

### Other components

- **User**

## Connections

- User → Agent collection: browses or adapts (evidence: `README.md`)
- User → Engineering: activates or installs (evidence: `README.md`)
- User → Design: selects specialist (evidence: `README.md`)
- User → Research: selects specialist (evidence: `README.md`)
- User → Finance: selects specialist (evidence: `README.md`)
- User → Marketing: selects specialist (evidence: `README.md`)
- User → Product: selects specialist (evidence: `README.md`)
- User → Security: selects specialist (evidence: `README.md`)
- User → Testing: selects specialist (evidence: `README.md`)
- User → Specialized services: selects specialist (evidence: `README.md`)
- User → Project management: selects specialist (evidence: `README.md`)
- User → Game development: selects specialist (evidence: `README.md`)
- User → GIS and spatial: selects specialist (evidence: `README.md`)
- User → Healthcare: selects specialist (evidence: `README.md`)
- User → Integration guides: follows setup guide (evidence: `README.md`)
- Hermes roster builder → Agent collection: collects agents (evidence: `scripts/build-hermes-plugin.py`)
