# raheel2774/agency-agents architecture

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

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

## Overview

The Agency is a curated library of specialized AI-agent profiles, organized by professional division and intended to be selected, installed or adapted, then activated in an AI tool. Its main product is the agent content and its cross-tool integration guidance—not a conventional application runtime. The README documents the user workflow and supported integrations; the source excerpt is a generator rather than runtime code, so implementation-level relationships beyond those documented are not inferred.

Main entry points: [`engineering`](https://github.com/raheel2774/agency-agents/tree/main/engineering) (Agent profiles), [`scripts/install.sh`](https://github.com/raheel2774/agency-agents/blob/main/scripts/install.sh) (CLI installer), [`scripts/convert.sh`](https://github.com/raheel2774/agency-agents/blob/main/scripts/convert.sh) (Integration converter), [`design`](https://github.com/raheel2774/agency-agents/tree/main/design) (Creative fields)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_roster["Agent roster"]
  node_agent_roster["Agent profiles"]
end

subgraph group_domains["Specialist divisions"]
  node_engineering["Engineering"]
  node_creative["Creative fields"]
  node_business["Business fields"]
  node_specialized["Specialized roles"]
end

subgraph group_integrations["Tool integrations"]
  node_installer["CLI installer<br/>[install.sh]"]
  node_converter["Integration converter<br/>[convert.sh]"]
  node_claude["Claude Code<br/>[README.md]"]
  node_cursor["Cursor<br/>[README.md]"]
  node_codex["Codex<br/>[README.md]"]
  node_gemini["Gemini CLI<br/>[README.md]"]
  node_hermes["Hermes<br/>[README.md]"]
end

subgraph group_workflows["Usage workflows"]
  node_strategy["Strategy playbooks"]
  node_examples["Workflow examples"]
end

node_user(("User"))
node_ai_tools(("AI tools"))
node_task(("Specialist task"))

node_user -->|"browses or selects"| node_agent_roster
node_agent_roster -->|"organized into"| node_engineering
node_agent_roster -->|"organized into"| node_creative
node_agent_roster -->|"organized into"| node_business
node_agent_roster -->|"organized into"| node_specialized
node_user -->|"runs to install"| node_installer
node_user -->|"runs to generate integrations"| node_converter
node_installer -->|"targets"| node_claude
node_installer -->|"targets"| node_cursor
node_installer -->|"targets"| node_codex
node_installer -->|"targets"| node_gemini
node_converter -->|"supports"| node_hermes
node_user -->|"follows playbooks"| node_strategy
node_user -->|"consults examples"| node_examples
node_user -->|"activates specialist in"| node_ai_tools
node_ai_tools -->|"produces deliverables"| node_task

click node_agent_roster "https://github.com/raheel2774/agency-agents/tree/main/engineering"
click node_engineering "https://github.com/raheel2774/agency-agents/tree/main/engineering"
click node_creative "https://github.com/raheel2774/agency-agents/tree/main/design"
click node_business "https://github.com/raheel2774/agency-agents/tree/main/marketing"
click node_specialized "https://github.com/raheel2774/agency-agents/tree/main/specialized"
click node_strategy "https://github.com/raheel2774/agency-agents/tree/main/strategy"
click node_examples "https://github.com/raheel2774/agency-agents/tree/main/examples"
click node_installer "https://github.com/raheel2774/agency-agents/blob/main/scripts/install.sh"
click node_converter "https://github.com/raheel2774/agency-agents/blob/main/scripts/convert.sh"
click node_claude "https://github.com/raheel2774/agency-agents/blob/main/integrations/claude-code/README.md"
click node_cursor "https://github.com/raheel2774/agency-agents/blob/main/integrations/cursor/README.md"
click node_codex "https://github.com/raheel2774/agency-agents/blob/main/integrations/codex/README.md"
click node_gemini "https://github.com/raheel2774/agency-agents/blob/main/integrations/gemini-cli/README.md"
click node_hermes "https://github.com/raheel2774/agency-agents/blob/main/integrations/hermes/README.md"

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_user toneBlue
class node_engineering,node_creative,node_business,node_specialized toneAmber
class node_installer,node_converter,node_claude,node_cursor,node_codex,node_gemini,node_hermes toneMint
class node_strategy,node_examples,node_task toneRose
class node_ai_tools toneIndigo
```

## Components

### Agent roster

- [Agent profiles](https://github.com/raheel2774/agency-agents/tree/main/engineering): `engineering`

### Specialist divisions

- [Engineering](https://github.com/raheel2774/agency-agents/tree/main/engineering): `engineering`
- [Creative fields](https://github.com/raheel2774/agency-agents/tree/main/design): `design`
- [Business fields](https://github.com/raheel2774/agency-agents/tree/main/marketing): `marketing`
- [Specialized roles](https://github.com/raheel2774/agency-agents/tree/main/specialized): `specialized`

### Tool integrations

- [CLI installer](https://github.com/raheel2774/agency-agents/blob/main/scripts/install.sh): `scripts/install.sh`
- [Integration converter](https://github.com/raheel2774/agency-agents/blob/main/scripts/convert.sh): `scripts/convert.sh`
- [Claude Code](https://github.com/raheel2774/agency-agents/blob/main/integrations/claude-code/README.md): `integrations/claude-code/README.md`
- [Cursor](https://github.com/raheel2774/agency-agents/blob/main/integrations/cursor/README.md): `integrations/cursor/README.md`
- [Codex](https://github.com/raheel2774/agency-agents/blob/main/integrations/codex/README.md): `integrations/codex/README.md`
- [Gemini CLI](https://github.com/raheel2774/agency-agents/blob/main/integrations/gemini-cli/README.md): `integrations/gemini-cli/README.md`
- [Hermes](https://github.com/raheel2774/agency-agents/blob/main/integrations/hermes/README.md): `integrations/hermes/README.md`

### Usage workflows

- [Strategy playbooks](https://github.com/raheel2774/agency-agents/tree/main/strategy): `strategy`
- [Workflow examples](https://github.com/raheel2774/agency-agents/tree/main/examples): `examples`

### Other components

- **User**
- **AI tools**
- **Specialist task**

## Connections

- User → Agent profiles: browses or selects (evidence: `README.md`)
- Agent profiles → Engineering: organized into (evidence: `README.md`)
- Agent profiles → Creative fields: organized into (evidence: `README.md`)
- Agent profiles → Business fields: organized into (evidence: `README.md`)
- Agent profiles → Specialized roles: organized into (evidence: `README.md`)
- User → CLI installer: runs to install (evidence: `README.md`)
- User → Integration converter: runs to generate integrations (evidence: `README.md`)
- CLI installer → Claude Code: targets (evidence: `README.md`)
- CLI installer → Cursor: targets (evidence: `README.md`)
- CLI installer → Codex: targets (evidence: `README.md`)
- CLI installer → Gemini CLI: targets (evidence: `README.md`)
- Integration converter → Hermes: supports (evidence: `README.md`)
- User → Strategy playbooks: follows playbooks (evidence: `README.md`)
- User → Workflow examples: consults examples (evidence: `README.md`)
- User → AI tools: activates specialist in (evidence: `README.md`)
- AI tools → Specialist task: produces deliverables (evidence: `README.md`)