# jeetpatel92/reddit-engagement-agent-system architecture

> Architecture diagram of the GitHub repository jeetpatel92/reddit-engagement-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/reddit-engagement-agent-system
- Repository: https://github.com/jeetpatel92/reddit-engagement-agent-system

## Overview

YuvGro’s Reddit Engagement Agent System automates discovery through monitoring and weekly learning, while reserving the final posting decision for a person. The engine’s scheduled path moves from topic and limits through thread screening, community rules, analysis, drafting and review, then an approval queue and posting. Monitoring routes replies and leads back into the workflow; weekly coaching learns from outcomes. The README also describes a separate Claude Code manual workflow. Several engine relationships below are documented in the README; unsampled implementation details are not inferred.

Main entry points: [`engine/ygr/agents/publisher.py`](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/publisher.py) (Publisher), [`engine/ygr/scheduler.py`](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/scheduler.py) (Scheduler), [`engine/ygr/agents/coach.py`](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/coach.py) (Weekly coach), [`engine/ygr/agents/analyst.py`](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/analyst.py) (Analyst)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and orchestration"]
  node_conductor["Conductor<br/>[conductor.py]"]
  node_scheduler["Scheduler<br/>[scheduler.py]"]
end

subgraph group_pipeline["Engagement pipeline"]
  node_scout["Scout<br/>[scout.py]"]
  node_rulekeeper["Rulekeeper<br/>[rulekeeper.py]"]
  node_analyst["Analyst<br/>[analyst.py]"]
  node_drafting["Drafting loop<br/>[drafting.py]"]
  node_writer["Writer<br/>[writer.py]"]
  node_critic["Critic<br/>[critic.py]"]
  node_checks["Code checks<br/>[checks.py]"]
end

subgraph group_oversight["Approval and learning"]
  node_publisher["Publisher<br/>[publisher.py]"]
  node_dashboard["Approval dashboard<br/>[web.py]"]
  node_watcher["Watcher<br/>[watcher.py]"]
  node_closer["Lead closer<br/>[closer.py]"]
  node_coach["Weekly coach<br/>[coach.py]"]
  node_evalrun["Regression evaluation<br/>[evalrun.py]"]
end

subgraph group_foundation["Shared runtime"]
  node_store[("SQLite state<br/>[store.py]")]
  node_config["Policy and config<br/>[config.py]"]
  node_llm["Claude client<br/>[llm.py]"]
  node_reddit_io["Reddit adapter<br/>[reddit_io.py]"]
  node_notify["Notifications<br/>[notify.py]"]
  node_notion["Notion CRM<br/>[notion.py]"]
end

subgraph group_manual["Manual workflow"]
  node_manual_skill["Daily session skill<br/>[SKILL.md]"]
  node_manual_script["Manual Reddit CLI<br/>[reddit.py]"]
end

node_cron(("Scheduled trigger"))
node_founder(("Founder"))
node_reddit_service{{"Reddit API"}}
node_claude_service{{"Anthropic API"}}
node_crm_service{{"Notion"}}

node_cron -->|"triggers"| node_scheduler
node_scheduler -->|"runs daily"| node_conductor
node_conductor -->|"finds threads"| node_scout
node_scout -->|"screens candidates"| node_rulekeeper
node_rulekeeper -->|"adds policies"| node_analyst
node_analyst -->|"briefs picks"| node_drafting
node_drafting -->|"requests drafts"| node_writer
node_drafting -->|"reviews drafts"| node_critic
node_critic -->|"runs code checks"| node_checks
node_conductor -->|"queues approved drafts"| node_publisher
node_publisher -->|"announces approvals"| node_dashboard
node_founder -->|"approves comments"| node_dashboard
node_dashboard -->|"submits approval"| node_publisher
node_publisher -->|"posts comments"| node_reddit_io
node_reddit_io -->|"reads and posts"| node_reddit_service
node_publisher -->|"records posting"| node_store
node_scheduler -->|"runs monitoring"| node_watcher
node_watcher -->|"routes reply jobs"| node_analyst
node_watcher -->|"routes buying intent"| node_closer
node_closer -->|"creates CRM records"| node_notion
node_notion -->|"writes records"| node_crm_service
node_scheduler -->|"runs weekly"| node_coach
node_coach -->|"reads outcomes"| node_store
node_coach -->|"tunes settings"| node_config
node_coach -->|"regression-checks proposals"| node_evalrun
node_analyst -->|"requests scoring"| node_llm
node_writer -->|"requests drafts"| node_llm
node_critic -->|"requests review"| node_llm
node_llm -->|"calls model"| node_claude_service
node_founder -->|"starts session"| node_manual_skill
node_manual_skill -.->|"uses CLI"| node_manual_script

click node_conductor "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/conductor.py"
click node_scheduler "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/scheduler.py"
click node_scout "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/scout.py"
click node_rulekeeper "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/rulekeeper.py"
click node_analyst "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/analyst.py"
click node_drafting "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/drafting.py"
click node_writer "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/writer.py"
click node_critic "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/critic.py"
click node_checks "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/checks.py"
click node_publisher "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/publisher.py"
click node_dashboard "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/web.py"
click node_watcher "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/watcher.py"
click node_closer "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/closer.py"
click node_coach "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/coach.py"
click node_evalrun "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/evalrun.py"
click node_store "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/store.py"
click node_config "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/config.py"
click node_llm "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/llm.py"
click node_reddit_io "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/reddit_io.py"
click node_notify "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/notify.py"
click node_notion "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/notion.py"
click node_manual_skill "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/skills/reddit-daily/SKILL.md"
click node_manual_script "https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/scripts/reddit.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_scheduler toneBlue
class node_scout,node_rulekeeper,node_analyst,node_drafting,node_writer,node_critic,node_checks toneAmber
class node_publisher,node_dashboard,node_watcher,node_closer,node_coach,node_evalrun,node_reddit_service,node_claude_service toneMint
class node_store,node_config,node_llm,node_reddit_io,node_notify,node_notion toneRose
class node_manual_skill,node_manual_script,node_cron,node_founder,node_crm_service toneIndigo
```

## Components

### Entry and orchestration

- [Conductor](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/conductor.py): `engine/ygr/agents/conductor.py`
- [Scheduler](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/scheduler.py): `engine/ygr/scheduler.py`

### Engagement pipeline

- [Scout](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/scout.py): `engine/ygr/agents/scout.py`
- [Rulekeeper](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/rulekeeper.py): `engine/ygr/agents/rulekeeper.py`
- [Analyst](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/analyst.py): `engine/ygr/agents/analyst.py`
- [Drafting loop](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/drafting.py): `engine/ygr/agents/drafting.py`
- [Writer](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/writer.py): `engine/ygr/agents/writer.py`
- [Critic](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/critic.py): `engine/ygr/agents/critic.py`
- [Code checks](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/checks.py): `engine/ygr/checks.py`

### Approval and learning

- [Publisher](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/publisher.py): `engine/ygr/agents/publisher.py`
- [Approval dashboard](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/web.py): `engine/ygr/web.py`
- [Watcher](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/watcher.py): `engine/ygr/agents/watcher.py`
- [Lead closer](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/closer.py): `engine/ygr/agents/closer.py`
- [Weekly coach](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/agents/coach.py): `engine/ygr/agents/coach.py`
- [Regression evaluation](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/evalrun.py): `engine/ygr/evalrun.py`

### Shared runtime

- [SQLite state](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/store.py): `engine/ygr/store.py`
- [Policy and config](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/config.py): `engine/ygr/config.py`
- [Claude client](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/llm.py): `engine/ygr/llm.py`
- [Reddit adapter](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/reddit_io.py): `engine/ygr/reddit_io.py`
- [Notifications](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/notify.py): `engine/ygr/notify.py`
- [Notion CRM](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/engine/ygr/notion.py): `engine/ygr/notion.py`

### Manual workflow

- [Daily session skill](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/skills/reddit-daily/SKILL.md): `skills/reddit-daily/SKILL.md`
- [Manual Reddit CLI](https://github.com/jeetpatel92/reddit-engagement-agent-system/blob/main/scripts/reddit.py): `scripts/reddit.py`

### Other components

- **Scheduled trigger**
- **Founder**
- **Reddit API**
- **Anthropic API**
- **Notion**

## Connections

- Scheduled trigger → Scheduler: triggers (evidence: `README.md`)
- Scheduler → Conductor: runs daily (evidence: `engine/ygr/scheduler.py`)
- Conductor → Scout: finds threads (evidence: `engine/ygr/agents/conductor.py`)
- Scout → Rulekeeper: screens candidates (evidence: `README.md`)
- Rulekeeper → Analyst: adds policies (evidence: `README.md`)
- Analyst → Drafting loop: briefs picks (evidence: `README.md`)
- Drafting loop → Writer: requests drafts (evidence: `engine/ygr/agents/drafting.py`)
- Drafting loop → Critic: reviews drafts (evidence: `engine/ygr/agents/drafting.py`)
- Critic → Code checks: runs code checks (evidence: `engine/ygr/agents/critic.py`)
- Conductor → Publisher: queues approved drafts (evidence: `engine/ygr/agents/conductor.py`)
- Publisher → Approval dashboard: announces approvals (evidence: `README.md`)
- Founder → Approval dashboard: approves comments (evidence: `engine/ygr/web.py`)
- Approval dashboard → Publisher: submits approval (evidence: `engine/ygr/web.py`)
- Publisher → Reddit adapter: posts comments (evidence: `engine/ygr/agents/publisher.py`)
- Reddit adapter → Reddit API: reads and posts (evidence: `README.md`)
- Publisher → SQLite state: records posting (evidence: `engine/ygr/agents/publisher.py`)
- Scheduler → Watcher: runs monitoring (evidence: `engine/ygr/scheduler.py`)
- Watcher → Analyst: routes reply jobs (evidence: `README.md`)
- Watcher → Lead closer: routes buying intent (evidence: `README.md`)
- Lead closer → Notion CRM: creates CRM records (evidence: `README.md`)
- Notion CRM → Notion: writes records (evidence: `README.md`)
- Scheduler → Weekly coach: runs weekly (evidence: `engine/ygr/scheduler.py`)
- Weekly coach → SQLite state: reads outcomes (evidence: `engine/ygr/agents/coach.py`)
- Weekly coach → Policy and config: tunes settings (evidence: `README.md`)
- Weekly coach → Regression evaluation: regression-checks proposals (evidence: `README.md`)
- Analyst → Claude client: requests scoring (evidence: `engine/ygr/agents/analyst.py`)
- Writer → Claude client: requests drafts (evidence: `engine/ygr/agents/writer.py`)
- Critic → Claude client: requests review (evidence: `engine/ygr/agents/critic.py`)
- Claude client → Anthropic API: calls model (evidence: `README.md`)
- Founder → Daily session skill: starts session (evidence: `README.md`)
- Daily session skill → Manual Reddit CLI: uses CLI
