# jeetpatel92/seo-aeo-geo-aio-optimization-agent-system architecture

> Architecture diagram of the GitHub repository jeetpatel92/seo-aeo-geo-aio-optimization-agent-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system
- Repository: https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system

## Overview

SAGO is an unattended website optimization system for SEO, answer-engine and generative-search visibility, and performance. Its main workflow is scheduled orchestration: gather a site snapshot, run specialist audits, prioritize findings, draft and review changes, apply them, verify the live result, and roll back failures. A learning loop measures outcomes and tunes future decisions. The map includes the documented specialist roles and integrations; relationships not established by the excerpts or README are omitted. Several agent implementations were not sampled, so their edges reflect the README’s documented pipeline.

Main entry points: [`engine/sago/agents/conductor.py`](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/conductor.py) (Conductor), [`engine/sago/llm.py`](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/llm.py) (Claude interface), [`engine/sago/agents/scout.py`](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/scout.py) (Scout), [`engine/sago/agents`](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/tree/main/engine/sago/agents) (Specialist auditors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Run orchestration"]
  node_conductor["Conductor<br/>[conductor.py]"]
  node_scout["Scout<br/>[scout.py]"]
  node_context["Shared context<br/>[core.py]"]
end

subgraph group_audits["Audits and planning"]
  node_analysts["Specialist auditors"]
  node_strategist["Strategist<br/>[strategist.py]"]
  node_knowledge["Detectors and recipes<br/>[knowledge.py]"]
end

subgraph group_changes["Change lifecycle"]
  node_copywriter["Copywriter<br/>[copywriter.py]"]
  node_engineer["Theme engineer<br/>[engineer.py]"]
  node_gatekeeper["Gatekeeper<br/>[gatekeeper.py]"]
  node_operator["Operator<br/>[operator.py]"]
  node_verifier["Verifier<br/>[verifier.py]"]
  node_policy["Action policy<br/>[policy.py]"]
end

subgraph group_learning["Learning and state"]
  node_coach["Coach<br/>[coach.py]"]
  node_store[("Run state<br/>[store.py]")]
end

subgraph group_adapters["Site and data adapters"]
  node_llm["Claude interface<br/>[llm.py]"]
  node_connector["WordPress connector<br/>[sago-connector.php]"]
  node_io["Crawl and data adapters"]
  node_notifier["Notifications<br/>[notify.py]"]
end

node_schedule(("Daily schedule"))
node_site["WordPress site"]
node_data_sources["Search and performance data"]

node_schedule -->|"starts run"| node_conductor
node_conductor -->|"runs first"| node_scout
node_scout -->|"provides snapshot"| node_analysts
node_analysts -->|"send findings"| node_strategist
node_strategist -->|"plans actions"| node_conductor
node_conductor -->|"drafts copy"| node_copywriter
node_conductor -->|"builds theme"| node_engineer
node_conductor -->|"submits action"| node_gatekeeper
node_gatekeeper -->|"checks policy"| node_policy
node_conductor -->|"dispatches approved"| node_operator
node_operator -->|"applies changes"| node_connector
node_connector -->|"updates site"| node_site
node_conductor -->|"checks live change"| node_verifier
node_verifier -->|"checks as guest"| node_site
node_verifier -->|"failure rolls back"| node_operator
node_conductor -->|"runs learning"| node_coach
node_coach -->|"reads outcomes"| node_store
node_strategist -->|"uses change history"| node_store
node_conductor -->|"tracks run state"| node_store
node_scout -->|"collects snapshots"| node_io
node_io -->|"fetches metrics"| node_data_sources
node_io -->|"crawls pages"| node_site
node_analysts -->|"uses detectors"| node_knowledge
node_engineer -->|"uses recipes"| node_knowledge
node_copywriter -->|"generates copy"| node_llm
node_engineer -->|"requests edits"| node_llm
node_gatekeeper -->|"requests review"| node_llm
node_coach -->|"tunes outcomes"| node_llm
node_conductor -->|"uses shared context"| node_context
node_conductor -->|"sends alerts"| node_notifier

click node_conductor "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/conductor.py"
click node_scout "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/scout.py"
click node_analysts "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/tree/main/engine/sago/agents"
click node_strategist "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/strategist.py"
click node_knowledge "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/knowledge.py"
click node_copywriter "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/copywriter.py"
click node_engineer "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/engineer.py"
click node_gatekeeper "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/gatekeeper.py"
click node_operator "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/operator.py"
click node_verifier "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/verifier.py"
click node_coach "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/coach.py"
click node_store "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/store.py"
click node_context "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/core.py"
click node_policy "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/policy.py"
click node_llm "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/llm.py"
click node_connector "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/connector/sago-connector/sago-connector.php"
click node_io "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/tree/main/engine/sago/io"
click node_notifier "https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/notify.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_conductor,node_scout,node_context toneBlue
class node_analysts,node_strategist,node_knowledge toneAmber
class node_copywriter,node_engineer,node_gatekeeper,node_operator,node_verifier,node_policy toneMint
class node_coach,node_store toneRose
class node_llm,node_connector,node_io,node_notifier,node_schedule,node_site,node_data_sources toneIndigo
```

## Components

### Run orchestration

- [Conductor](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/conductor.py): `engine/sago/agents/conductor.py`
- [Scout](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/scout.py): `engine/sago/agents/scout.py`
- [Shared context](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/core.py): `engine/sago/core.py`

### Audits and planning

- [Specialist auditors](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/tree/main/engine/sago/agents): `engine/sago/agents`
- [Strategist](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/strategist.py): `engine/sago/agents/strategist.py`
- [Detectors and recipes](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/knowledge.py): `engine/sago/knowledge.py`

### Change lifecycle

- [Copywriter](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/copywriter.py): `engine/sago/agents/copywriter.py`
- [Theme engineer](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/engineer.py): `engine/sago/agents/engineer.py`
- [Gatekeeper](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/gatekeeper.py): `engine/sago/agents/gatekeeper.py`
- [Operator](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/operator.py): `engine/sago/agents/operator.py`
- [Verifier](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/verifier.py): `engine/sago/agents/verifier.py`
- [Action policy](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/policy.py): `engine/sago/policy.py`

### Learning and state

- [Coach](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/agents/coach.py): `engine/sago/agents/coach.py`
- [Run state](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/store.py): `engine/sago/store.py`

### Site and data adapters

- [Claude interface](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/llm.py): `engine/sago/llm.py`
- [WordPress connector](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/connector/sago-connector/sago-connector.php): `connector/sago-connector/sago-connector.php`
- [Crawl and data adapters](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/tree/main/engine/sago/io): `engine/sago/io`
- [Notifications](https://github.com/jeetpatel92/seo-aeo-geo-aio-optimization-agent-system/blob/main/engine/sago/notify.py): `engine/sago/notify.py`

### Other components

- **Daily schedule**
- **WordPress site**
- **Search and performance data**

## Connections

- Daily schedule → Conductor: starts run (evidence: `README.md`)
- Conductor → Scout: runs first (evidence: `README.md`)
- Scout → Specialist auditors: provides snapshot (evidence: `README.md`)
- Specialist auditors → Strategist: send findings (evidence: `README.md`)
- Strategist → Conductor: plans actions (evidence: `README.md`)
- Conductor → Copywriter: drafts copy (evidence: `README.md`)
- Conductor → Theme engineer: builds theme (evidence: `engine/sago/agents/conductor.py`)
- Conductor → Gatekeeper: submits action (evidence: `README.md`)
- Gatekeeper → Action policy: checks policy (evidence: `engine/sago/agents/gatekeeper.py`)
- Conductor → Operator: dispatches approved (evidence: `README.md`)
- Operator → WordPress connector: applies changes (evidence: `README.md`)
- WordPress connector → WordPress site: updates site (evidence: `README.md`)
- Conductor → Verifier: checks live change (evidence: `README.md`)
- Verifier → WordPress site: checks as guest (evidence: `README.md`)
- Verifier → Operator: failure rolls back (evidence: `README.md`)
- Conductor → Coach: runs learning (evidence: `README.md`)
- Coach → Run state: reads outcomes (evidence: `engine/sago/agents/coach.py`)
- Strategist → Run state: uses change history (evidence: `engine/sago/agents/strategist.py`)
- Conductor → Run state: tracks run state (evidence: `engine/sago/agents/conductor.py`)
- Scout → Crawl and data adapters: collects snapshots (evidence: `engine/sago/agents/scout.py`)
- Crawl and data adapters → Search and performance data: fetches metrics (evidence: `README.md`)
- Crawl and data adapters → WordPress site: crawls pages (evidence: `README.md`)
- Specialist auditors → Detectors and recipes: uses detectors (evidence: `engine/sago/agents/ai_visibility.py`)
- Theme engineer → Detectors and recipes: uses recipes (evidence: `engine/sago/agents/engineer.py`)
- Copywriter → Claude interface: generates copy (evidence: `engine/sago/agents/copywriter.py`)
- Theme engineer → Claude interface: requests edits (evidence: `engine/sago/agents/engineer.py`)
- Gatekeeper → Claude interface: requests review (evidence: `engine/sago/agents/gatekeeper.py`)
- Coach → Claude interface: tunes outcomes (evidence: `engine/sago/agents/coach.py`)
- Conductor → Shared context: uses shared context (evidence: `engine/sago/agents/conductor.py`)
- Conductor → Notifications: sends alerts (evidence: `README.md`)
