# vuongdiensharing-performance/performance architecture

> Architecture diagram of the GitHub repository vuongdiensharing-performance/performance, 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/vuongdiensharing-performance/performance
- Repository: https://github.com/vuongdiensharing-performance/performance

## Overview

The README describes an AI-agent marketing-skills collection spanning SEO, CRO, content, paid measurement, growth, sales, and strategy. The provided tree does not include those skill files, so their internal implementation cannot be mapped. The visible runtime includes an MCP server for UTM generation and campaign KPI analysis, a small CLI, and many standalone marketing-platform CLIs. The diagram focuses on those evidenced components; the sampled integrations are examples, not a complete inventory.

Main entry points: [`mcp/server.ts`](https://github.com/vuongdiensharing-performance/performance/blob/main/mcp/server.ts) (MCP tool server), [`cli/utm-generator.ts`](https://github.com/vuongdiensharing-performance/performance/blob/main/cli/utm-generator.ts) (UTM link generator), [`cli/index.ts`](https://github.com/vuongdiensharing-performance/performance/blob/main/cli/index.ts) (Marketing CLI), [`tools/clis/google-search-console.js`](https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/google-search-console.js) (Search Console CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrypoints["Agent and CLI entrypoints"]
  node_mcp["MCP tool server<br/>[server.ts]"]
  node_cli["Marketing CLI<br/>[index.ts]"]
end

subgraph group_performance["Campaign utilities"]
  node_utm["UTM link generator<br/>[utm-generator.ts]"]
  node_cleaner["Campaign metrics<br/>[data-cleaner.ts]"]
  node_kpi["Education KPI rules<br/>[constants.ts]"]
  node_metrics["Campaign metric types<br/>[types.ts]"]
end

subgraph group_integrations["Marketing integrations"]
  node_seo["Search Console CLI"]
  node_crm["ActiveCampaign CLI<br/>[activecampaign.js]"]
  node_support["Intercom CLI<br/>[intercom.js]"]
end

node_agent(("AI agent"))
node_marketing_services{{"Marketing platform APIs"}}
node_mcp_client(("MCP client"))

node_mcp_client -->|"invokes tools"| node_mcp
node_mcp -->|"generates links"| node_utm
node_mcp -->|"calculates metrics"| node_cleaner
node_mcp -->|"checks thresholds"| node_kpi
node_mcp -->|"uses metric type"| node_metrics
node_cli -->|"imports generator"| node_utm
node_seo -->|"calls Search Console API"| node_marketing_services
node_crm -->|"calls ActiveCampaign API"| node_marketing_services
node_support -->|"calls Intercom API"| node_marketing_services

click node_mcp "https://github.com/vuongdiensharing-performance/performance/blob/main/mcp/server.ts"
click node_cli "https://github.com/vuongdiensharing-performance/performance/blob/main/cli/index.ts"
click node_utm "https://github.com/vuongdiensharing-performance/performance/blob/main/cli/utm-generator.ts"
click node_cleaner "https://github.com/vuongdiensharing-performance/performance/blob/main/cli/data-cleaner.ts"
click node_kpi "https://github.com/vuongdiensharing-performance/performance/blob/main/shared/constants.ts"
click node_metrics "https://github.com/vuongdiensharing-performance/performance/blob/main/shared/types.ts"
click node_seo "https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/google-search-console.js"
click node_crm "https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/activecampaign.js"
click node_support "https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/intercom.js"

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_mcp,node_cli,node_mcp_client toneBlue
class node_utm,node_cleaner,node_kpi,node_metrics toneAmber
class node_seo,node_crm,node_support,node_marketing_services toneMint
class node_agent toneIndigo
```

## Components

### Agent and CLI entrypoints

- [MCP tool server](https://github.com/vuongdiensharing-performance/performance/blob/main/mcp/server.ts): `mcp/server.ts`
- [Marketing CLI](https://github.com/vuongdiensharing-performance/performance/blob/main/cli/index.ts): `cli/index.ts`

### Campaign utilities

- [UTM link generator](https://github.com/vuongdiensharing-performance/performance/blob/main/cli/utm-generator.ts): `cli/utm-generator.ts`
- [Campaign metrics](https://github.com/vuongdiensharing-performance/performance/blob/main/cli/data-cleaner.ts): `cli/data-cleaner.ts`
- [Education KPI rules](https://github.com/vuongdiensharing-performance/performance/blob/main/shared/constants.ts): `shared/constants.ts`
- [Campaign metric types](https://github.com/vuongdiensharing-performance/performance/blob/main/shared/types.ts): `shared/types.ts`

### Marketing integrations

- [Search Console CLI](https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/google-search-console.js): `tools/clis/google-search-console.js`
- [ActiveCampaign CLI](https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/activecampaign.js): `tools/clis/activecampaign.js`
- [Intercom CLI](https://github.com/vuongdiensharing-performance/performance/blob/main/tools/clis/intercom.js): `tools/clis/intercom.js`

### Other components

- **AI agent**
- **Marketing platform APIs**
- **MCP client**

## Connections

- MCP client → MCP tool server: invokes tools (evidence: `mcp/server.ts`)
- MCP tool server → UTM link generator: generates links (evidence: `mcp/server.ts`)
- MCP tool server → Campaign metrics: calculates metrics (evidence: `mcp/server.ts`)
- MCP tool server → Education KPI rules: checks thresholds (evidence: `mcp/server.ts`)
- MCP tool server → Campaign metric types: uses metric type (evidence: `mcp/server.ts`)
- Marketing CLI → UTM link generator: imports generator (evidence: `cli/index.ts`)
- Search Console CLI → Marketing platform APIs: calls Search Console API (evidence: `tools/clis/google-search-console.js`)
- ActiveCampaign CLI → Marketing platform APIs: calls ActiveCampaign API (evidence: `tools/clis/activecampaign.js`)
- Intercom CLI → Marketing platform APIs: calls Intercom API (evidence: `tools/clis/intercom.js`)