# cbrock84/headcount architecture

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

- Interactive diagram: https://gitdiagram.com/cbrock84/headcount
- Repository: https://github.com/cbrock84/headcount
- Video tour (about a minute): https://gitdiagram.com/cbrock84/headcount/video

## Overview

headcount is a repository of installable, role-specific AI agent skills organized as a company: a CEO function and 15 departments, with optional industry verticals. The main workflow is that someone asks a question or invokes a skill; Claude Code or ChatGPT/Codex loads the matching department skill, which guides the response and can consult its references. Departments are independently installable, and the same skill content serves both host ecosystems. The graph represents documented capabilities; sampled implementation excerpts mainly cover repository tooling, so they do not establish additional runtime call paths.

Main entry points: [`plugins`](https://github.com/cbrock84/headcount/tree/main/plugins) (Department skills), [`plugins/executive`](https://github.com/cbrock84/headcount/tree/main/plugins/executive) (Executive), [`sources`](https://github.com/cbrock84/headcount/tree/main/sources) (Skill references), [`verticals`](https://github.com/cbrock84/headcount/tree/main/verticals) (Industry extensions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_org["Executive and strategy"]
  node_executive["Executive"]
  node_strategy["Corporate strategy"]
end

subgraph group_business["Business departments"]
  node_revenue["Revenue"]
  node_marketing["Marketing"]
  node_demand["Demand generation"]
  node_customer["Customer experience"]
  node_finance["Finance"]
  node_people["People"]
  node_operations["Operations"]
  node_pmo["Project management"]
end

subgraph group_delivery["Technology and assurance"]
  node_analytics["Data analytics"]
  node_technology["Technology"]
  node_itops["IT operations"]
  node_security["Security"]
  node_legal["Legal and risk"]
  node_product["Product"]
end

subgraph group_catalog["Skill catalog and extensions"]
  node_skills["Department skills"]
  node_references["Skill references"]
  node_verticals["Industry extensions"]
  node_charters["Agent charters<br/>[agents]"]
end

node_user(("User"))
node_hosts["Agent hosts"]
node_answer["Guided response"]

node_user -->|"asks or invokes"| node_hosts
node_hosts -->|"matches and loads"| node_skills
node_skills -->|"selects role"| node_executive
node_skills -->|"selects role"| node_strategy
node_skills -->|"selects role"| node_revenue
node_skills -->|"selects role"| node_marketing
node_skills -->|"selects role"| node_demand
node_skills -->|"selects role"| node_customer
node_skills -->|"selects role"| node_finance
node_skills -->|"selects role"| node_people
node_skills -->|"selects role"| node_operations
node_skills -->|"selects role"| node_pmo
node_skills -->|"selects role"| node_analytics
node_skills -->|"selects role"| node_technology
node_skills -->|"selects role"| node_itops
node_skills -->|"selects role"| node_security
node_skills -->|"selects role"| node_legal
node_skills -->|"selects role"| node_product
node_hosts -->|"returns guidance"| node_answer
node_references -->|"informs answers"| node_skills
node_verticals -.->|"adds context and skills"| node_skills
node_charters -.->|"supports delegation"| node_executive

click node_executive "https://github.com/cbrock84/headcount/tree/main/plugins/executive"
click node_strategy "https://github.com/cbrock84/headcount/tree/main/plugins/corporate-strategy"
click node_revenue "https://github.com/cbrock84/headcount/tree/main/plugins/revenue"
click node_marketing "https://github.com/cbrock84/headcount/tree/main/plugins/marketing"
click node_demand "https://github.com/cbrock84/headcount/tree/main/plugins/demand-generation"
click node_customer "https://github.com/cbrock84/headcount/tree/main/plugins/customer-experience"
click node_finance "https://github.com/cbrock84/headcount/tree/main/plugins/finance"
click node_people "https://github.com/cbrock84/headcount/tree/main/plugins/people"
click node_operations "https://github.com/cbrock84/headcount/tree/main/plugins/operations"
click node_pmo "https://github.com/cbrock84/headcount/tree/main/plugins/pmo"
click node_analytics "https://github.com/cbrock84/headcount/tree/main/plugins/data-analytics"
click node_technology "https://github.com/cbrock84/headcount/tree/main/plugins/technology"
click node_itops "https://github.com/cbrock84/headcount/tree/main/plugins/it-operations"
click node_security "https://github.com/cbrock84/headcount/tree/main/plugins/security"
click node_legal "https://github.com/cbrock84/headcount/tree/main/plugins/legal-risk"
click node_product "https://github.com/cbrock84/headcount/tree/main/plugins/product"
click node_skills "https://github.com/cbrock84/headcount/tree/main/plugins"
click node_references "https://github.com/cbrock84/headcount/tree/main/sources"
click node_verticals "https://github.com/cbrock84/headcount/tree/main/verticals"
click node_charters "https://github.com/cbrock84/headcount/tree/main/.claude/agents"

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_executive,node_strategy,node_user toneBlue
class node_revenue,node_marketing,node_demand,node_customer,node_finance,node_people,node_operations,node_pmo toneAmber
class node_analytics,node_technology,node_itops,node_security,node_legal,node_product toneMint
class node_skills,node_references,node_verticals,node_charters toneRose
class node_hosts,node_answer toneIndigo
```

## Components

### Executive and strategy

- [Executive](https://github.com/cbrock84/headcount/tree/main/plugins/executive): `plugins/executive`
- [Corporate strategy](https://github.com/cbrock84/headcount/tree/main/plugins/corporate-strategy): `plugins/corporate-strategy`

### Business departments

- [Revenue](https://github.com/cbrock84/headcount/tree/main/plugins/revenue): `plugins/revenue`
- [Marketing](https://github.com/cbrock84/headcount/tree/main/plugins/marketing): `plugins/marketing`
- [Demand generation](https://github.com/cbrock84/headcount/tree/main/plugins/demand-generation): `plugins/demand-generation`
- [Customer experience](https://github.com/cbrock84/headcount/tree/main/plugins/customer-experience): `plugins/customer-experience`
- [Finance](https://github.com/cbrock84/headcount/tree/main/plugins/finance): `plugins/finance`
- [People](https://github.com/cbrock84/headcount/tree/main/plugins/people): `plugins/people`
- [Operations](https://github.com/cbrock84/headcount/tree/main/plugins/operations): `plugins/operations`
- [Project management](https://github.com/cbrock84/headcount/tree/main/plugins/pmo): `plugins/pmo`

### Technology and assurance

- [Data analytics](https://github.com/cbrock84/headcount/tree/main/plugins/data-analytics): `plugins/data-analytics`
- [Technology](https://github.com/cbrock84/headcount/tree/main/plugins/technology): `plugins/technology`
- [IT operations](https://github.com/cbrock84/headcount/tree/main/plugins/it-operations): `plugins/it-operations`
- [Security](https://github.com/cbrock84/headcount/tree/main/plugins/security): `plugins/security`
- [Legal and risk](https://github.com/cbrock84/headcount/tree/main/plugins/legal-risk): `plugins/legal-risk`
- [Product](https://github.com/cbrock84/headcount/tree/main/plugins/product): `plugins/product`

### Skill catalog and extensions

- [Department skills](https://github.com/cbrock84/headcount/tree/main/plugins): `plugins`
- [Skill references](https://github.com/cbrock84/headcount/tree/main/sources): `sources`
- [Industry extensions](https://github.com/cbrock84/headcount/tree/main/verticals): `verticals`
- [Agent charters](https://github.com/cbrock84/headcount/tree/main/.claude/agents): `.claude/agents`

### Other components

- **User**
- **Agent hosts**
- **Guided response**

## Connections

- User → Agent hosts: asks or invokes
- Agent hosts → Department skills: matches and loads
- Department skills → Executive: selects role
- Department skills → Corporate strategy: selects role
- Department skills → Revenue: selects role
- Department skills → Marketing: selects role
- Department skills → Demand generation: selects role
- Department skills → Customer experience: selects role
- Department skills → Finance: selects role
- Department skills → People: selects role
- Department skills → Operations: selects role
- Department skills → Project management: selects role
- Department skills → Data analytics: selects role
- Department skills → Technology: selects role
- Department skills → IT operations: selects role
- Department skills → Security: selects role
- Department skills → Legal and risk: selects role
- Department skills → Product: selects role
- Agent hosts → Guided response: returns guidance
- Skill references → Department skills: informs answers
- Industry extensions → Department skills: adds context and skills
- Agent charters → Executive: supports delegation