# aaron-he-zhu/aaron-marketing-skills architecture

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

- Interactive diagram: https://gitdiagram.com/aaron-he-zhu/aaron-marketing-skills
- Repository: https://github.com/aaron-he-zhu/aaron-marketing-skills

## Overview

Aaron Marketing Skills packages 120 Markdown-based marketing skills for plugin, portable-skill, and named-bot use. A user describes a goal; the shared auto router selects relevant skills across seven disciplines, whose documented lifecycle stages guide work toward discipline-specific evaluation gates. The protocol layer provides routing, memory, and truth registries; sampled runtime scripts expose context/run management and registry events. The supplied tree is limited to scripts, so the skill bodies and several README-described capabilities have no exact source paths here. Links reflect documented or excerpted behavior; unsampled integrations are omitted.

Main entry points: [`scripts/runtime-controller.py`](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/runtime-controller.py) (Run controller), [`scripts/connectors/resend.py`](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/resend.py) (Resend connector), [`scripts/connectors/_http.py`](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/_http.py) (Polite HTTP), [`scripts/connectors/sitemap.py`](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/sitemap.py) (Sitemap fetcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Skills and routing"]
  node_auto["Auto routing"]
  node_narrative["Narrative skills"]
  node_seo["SEO/GEO skills"]
  node_social["Social skills"]
  node_email["Email skills"]
  node_paid["Paid ads skills"]
  node_influencer["Influencer skills"]
  node_launch["Launch skills"]
  node_auditors["Discipline auditors"]
end

subgraph group_runtime["Run context"]
  node_controller["Run controller"]
  node_context_plan["Context planning<br/>[context-plan.py]"]
  node_context_resolution["Context resolution"]
  node_context_assembly["Context assembly"]
  node_profiles["Profile resolution"]
  node_usage["Context usage<br/>[context-usage.py]"]
end

subgraph group_protocol["Protocol state"]
  node_registry["Truth registries<br/>[registry-events.py]"]
  node_workflow["Workflow lifecycle<br/>[workflow_loop.py]"]
end

subgraph group_integrations["External connectors"]
  node_resend["Resend connector<br/>[resend.py]"]
  node_connector_http["Polite HTTP<br/>[_http.py]"]
  node_sitemap["Sitemap fetcher<br/>[sitemap.py]"]
end

node_marketer(("Marketing user"))

node_marketer -->|"describes goal"| node_auto
node_auto -->|"routes to"| node_narrative
node_auto -->|"routes to"| node_seo
node_auto -->|"routes to"| node_social
node_auto -->|"routes to"| node_email
node_auto -->|"routes to"| node_paid
node_auto -->|"routes to"| node_influencer
node_auto -->|"routes to"| node_launch
node_seo -->|"evaluated by"| node_auditors
node_email -->|"evaluated by"| node_auditors
node_paid -->|"evaluated by"| node_auditors
node_influencer -->|"evaluated by"| node_auditors
node_controller -->|"plans context"| node_context_plan
node_controller -->|"resolves context"| node_context_resolution
node_controller -->|"assembles snapshot"| node_context_assembly
node_email -->|"uses connector"| node_resend
node_resend -->|"sends requests"| node_connector_http
node_sitemap -->|"fetches URLs"| node_connector_http

click node_controller "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/runtime-controller.py"
click node_context_plan "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-plan.py"
click node_context_resolution "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-resolver.py"
click node_context_assembly "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-assembly.py"
click node_profiles "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-profile-resolver.py"
click node_usage "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-usage.py"
click node_registry "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/registry-events.py"
click node_workflow "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/workflow_loop.py"
click node_resend "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/resend.py"
click node_connector_http "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/_http.py"
click node_sitemap "https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/sitemap.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_auto,node_narrative,node_seo,node_social,node_email,node_paid,node_influencer,node_launch,node_auditors,node_marketer toneBlue
class node_controller,node_context_plan,node_context_resolution,node_context_assembly,node_profiles,node_usage toneAmber
class node_registry,node_workflow toneMint
class node_resend,node_connector_http,node_sitemap toneRose
```

## Components

### Skills and routing

- **Auto routing**
- **Narrative skills**
- **SEO/GEO skills**
- **Social skills**
- **Email skills**
- **Paid ads skills**
- **Influencer skills**
- **Launch skills**
- **Discipline auditors**

### Run context

- [Run controller](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/runtime-controller.py): `scripts/runtime-controller.py`
- [Context planning](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-plan.py): `scripts/context-plan.py`
- [Context resolution](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-resolver.py): `scripts/context-resolver.py`
- [Context assembly](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-assembly.py): `scripts/context-assembly.py`
- [Profile resolution](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-profile-resolver.py): `scripts/context-profile-resolver.py`
- [Context usage](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/context-usage.py): `scripts/context-usage.py`

### Protocol state

- [Truth registries](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/registry-events.py): `scripts/registry-events.py`
- [Workflow lifecycle](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/workflow_loop.py): `scripts/workflow_loop.py`

### External connectors

- [Resend connector](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/resend.py): `scripts/connectors/resend.py`
- [Polite HTTP](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/_http.py): `scripts/connectors/_http.py`
- [Sitemap fetcher](https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/main/scripts/connectors/sitemap.py): `scripts/connectors/sitemap.py`

### Other components

- **Marketing user**

## Connections

- Marketing user → Auto routing: describes goal (evidence: `README.md`)
- Auto routing → Narrative skills: routes to (evidence: `README.md`)
- Auto routing → SEO/GEO skills: routes to (evidence: `README.md`)
- Auto routing → Social skills: routes to (evidence: `README.md`)
- Auto routing → Email skills: routes to (evidence: `README.md`)
- Auto routing → Paid ads skills: routes to (evidence: `README.md`)
- Auto routing → Influencer skills: routes to (evidence: `README.md`)
- Auto routing → Launch skills: routes to (evidence: `README.md`)
- SEO/GEO skills → Discipline auditors: evaluated by (evidence: `README.md`)
- Email skills → Discipline auditors: evaluated by (evidence: `README.md`)
- Paid ads skills → Discipline auditors: evaluated by (evidence: `README.md`)
- Influencer skills → Discipline auditors: evaluated by (evidence: `README.md`)
- Run controller → Context planning: plans context (evidence: `scripts/runtime-controller.py`)
- Run controller → Context resolution: resolves context (evidence: `scripts/runtime-controller.py`)
- Run controller → Context assembly: assembles snapshot (evidence: `scripts/runtime-controller.py`)
- Email skills → Resend connector: uses connector (evidence: `scripts/connectors/resend.py`)
- Resend connector → Polite HTTP: sends requests (evidence: `scripts/connectors/resend.py`)
- Sitemap fetcher → Polite HTTP: fetches URLs (evidence: `scripts/connectors/sitemap.py`)
