# skpaul82/agency-agents architecture

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

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

## Overview

The Agency is a collection of AI specialist prompts, not an executable agent platform. A user chooses an agent, activates or adapts its prompt, and uses its domain workflow and deliverables. The README documents the roster and prompt contents; no source excerpts were supplied, so the graph does not infer runtime orchestration or connections between agents. Directory-level nodes represent prompt families where individual prompt behavior was not sampled.

Main entry points: [`design`](https://github.com/skpaul82/agency-agents/tree/main/design) (Design Agents), [`engineering`](https://github.com/skpaul82/agency-agents/tree/main/engineering) (Engineering Agents), [`marketing`](https://github.com/skpaul82/agency-agents/tree/main/marketing) (Marketing Agents), [`product`](https://github.com/skpaul82/agency-agents/tree/main/product) (Product Agents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_craft["Design &amp; Engineering"]
  node_design["Design Agents"]
  node_engineering["Engineering Agents"]
end

subgraph group_growth["Marketing &amp; Product"]
  node_marketing["Marketing Agents"]
  node_product["Product Agents"]
end

subgraph group_delivery["Project Delivery &amp; Testing"]
  node_project["Project Management"]
  node_testing["Testing Agents"]
  node_support["Support Agents"]
end

subgraph group_specialists["Specialist Practices"]
  node_specialized["Specialized Agents"]
  node_spatial["Spatial Computing"]
end

subgraph group_coordination["Strategy &amp; Coordination"]
  node_strategy["Strategy Playbooks"]
end

node_user(("User"))

node_user -->|"activates or adapts"| node_design
node_user -->|"activates or adapts"| node_engineering
node_user -->|"activates or adapts"| node_marketing
node_user -->|"activates or adapts"| node_product
node_user -->|"activates or adapts"| node_project
node_user -->|"activates or adapts"| node_testing

click node_design "https://github.com/skpaul82/agency-agents/tree/main/design"
click node_engineering "https://github.com/skpaul82/agency-agents/tree/main/engineering"
click node_marketing "https://github.com/skpaul82/agency-agents/tree/main/marketing"
click node_product "https://github.com/skpaul82/agency-agents/tree/main/product"
click node_project "https://github.com/skpaul82/agency-agents/tree/main/project-management"
click node_testing "https://github.com/skpaul82/agency-agents/tree/main/testing"
click node_support "https://github.com/skpaul82/agency-agents/tree/main/support"
click node_specialized "https://github.com/skpaul82/agency-agents/tree/main/specialized"
click node_spatial "https://github.com/skpaul82/agency-agents/tree/main/spatial-computing"
click node_strategy "https://github.com/skpaul82/agency-agents/tree/main/strategy"

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_design,node_engineering,node_user toneBlue
class node_marketing,node_product toneAmber
class node_project,node_testing,node_support toneMint
class node_specialized,node_spatial toneRose
class node_strategy toneIndigo
```

## Components

### Design & Engineering

- [Design Agents](https://github.com/skpaul82/agency-agents/tree/main/design): `design`
- [Engineering Agents](https://github.com/skpaul82/agency-agents/tree/main/engineering): `engineering`

### Marketing & Product

- [Marketing Agents](https://github.com/skpaul82/agency-agents/tree/main/marketing): `marketing`
- [Product Agents](https://github.com/skpaul82/agency-agents/tree/main/product): `product`

### Project Delivery & Testing

- [Project Management](https://github.com/skpaul82/agency-agents/tree/main/project-management): `project-management`
- [Testing Agents](https://github.com/skpaul82/agency-agents/tree/main/testing): `testing`
- [Support Agents](https://github.com/skpaul82/agency-agents/tree/main/support): `support`

### Specialist Practices

- [Specialized Agents](https://github.com/skpaul82/agency-agents/tree/main/specialized): `specialized`
- [Spatial Computing](https://github.com/skpaul82/agency-agents/tree/main/spatial-computing): `spatial-computing`

### Strategy & Coordination

- [Strategy Playbooks](https://github.com/skpaul82/agency-agents/tree/main/strategy): `strategy`

### Other components

- **User**

## Connections

- User → Design Agents: activates or adapts (evidence: `README.md`)
- User → Engineering Agents: activates or adapts (evidence: `README.md`)
- User → Marketing Agents: activates or adapts (evidence: `README.md`)
- User → Product Agents: activates or adapts (evidence: `README.md`)
- User → Project Management: activates or adapts (evidence: `README.md`)
- User → Testing Agents: activates or adapts (evidence: `README.md`)
