How jeetpatel92/reddit-engagement-agent-system works
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: publisher.py Publisher · scheduler.py Scheduler · coach.py Weekly coach · analyst.py Analyst
Components 28
Engagement pipeline
- Scout
engine/ygr/agents/scout.py - Rulekeeper
engine/ygr/agents/rulekeeper.py - Analyst
engine/ygr/agents/analyst.py - Drafting loop
engine/ygr/agents/drafting.py - Writer
engine/ygr/agents/writer.py - Critic
engine/ygr/agents/critic.py - Code checks
engine/ygr/checks.py
Approval and learning
- Publisher
engine/ygr/agents/publisher.py - Approval dashboard
engine/ygr/web.py - Watcher
engine/ygr/agents/watcher.py - Lead closer
engine/ygr/agents/closer.py - Weekly coach
engine/ygr/agents/coach.py - Regression evaluation
engine/ygr/evalrun.py
Shared runtime
- SQLite state
engine/ygr/store.py - Policy and config
engine/ygr/config.py - Claude client
engine/ygr/llm.py - Reddit adapter
engine/ygr/reddit_io.py - Notifications
engine/ygr/notify.py - Notion CRM
engine/ygr/notion.py
Manual workflow
- Daily session skill
skills/reddit-daily/SKILL.md - Manual Reddit CLI
scripts/reddit.py
Other components
- Scheduled trigger
- Founder
- Reddit API
- Anthropic API
- Notion
Connections 31
- Scheduled trigger → Scheduler: triggers
README.md - Scheduler → Conductor: runs daily
engine/ygr/scheduler.py - Conductor → Scout: finds threads
engine/ygr/agents/conductor.py - Scout → Rulekeeper: screens candidates
README.md - Rulekeeper → Analyst: adds policies
README.md - Analyst → Drafting loop: briefs picks
README.md - Drafting loop → Writer: requests drafts
engine/ygr/agents/drafting.py - Drafting loop → Critic: reviews drafts
engine/ygr/agents/drafting.py - Critic → Code checks: runs code checks
engine/ygr/agents/critic.py - Conductor → Publisher: queues approved drafts
engine/ygr/agents/conductor.py - Publisher → Approval dashboard: announces approvals
README.md - Founder → Approval dashboard: approves comments
engine/ygr/web.py - Approval dashboard → Publisher: submits approval
engine/ygr/web.py - Publisher → Reddit adapter: posts comments
engine/ygr/agents/publisher.py - Reddit adapter → Reddit API: reads and posts
README.md - Publisher → SQLite state: records posting
engine/ygr/agents/publisher.py - Scheduler → Watcher: runs monitoring
engine/ygr/scheduler.py - Watcher → Analyst: routes reply jobs
README.md - Watcher → Lead closer: routes buying intent
README.md - Lead closer → Notion CRM: creates CRM records
README.md - Notion CRM → Notion: writes records
README.md - Scheduler → Weekly coach: runs weekly
engine/ygr/scheduler.py - Weekly coach → SQLite state: reads outcomes
engine/ygr/agents/coach.py - Weekly coach → Policy and config: tunes settings
README.md - Weekly coach → Regression evaluation: regression-checks proposals
README.md - Analyst → Claude client: requests scoring
engine/ygr/agents/analyst.py - Writer → Claude client: requests drafts
engine/ygr/agents/writer.py - Critic → Claude client: requests review
engine/ygr/agents/critic.py - Claude client → Anthropic API: calls model
README.md - Founder → Daily session skill: starts session
README.md - Daily session skill → Manual Reddit CLI: uses CLI