Growth Engine

---
name: growth-engine
description: "Growth Engine — a bounded, gated X growth system for @Agentik_os aimed at real follower growth (north star 10k) by being genuinely useful in the right conversations, never by spam automation. A daily Reply Radar finds high-leverage AI-agents/Claude threads via last30days/ScrapeCreators, drafts genuine on-voice replies, passes them through an adversarial anti-spam gate, then (only when ARMED with a valid X session) posts a LOW-CAPPED number of replies + likes via Playwright driving the operator's logged-in session, with human pacing, dedup, and a kill-switch. Use when the user says '/omg-growth-engine', '/growth-engine', 'growth X', 'gagner des followers', 'reply radar', 'engager sur X', 'arm/disarm the growth engine'. NOT a mass like/follow/DM bot (that gets the account suspended and is refused), NOT the content publisher (that is agent-ecosystem-watch): this is the engagement layer, deliberately small-volume and quality-gated."
---

# Growth Engine

Durable follower growth is content plus genuine presence in the right conversations, not
automation X detects and suspends. This engine automates the HARD part (finding the best
threads, drafting excellent replies) and keeps the action layer deliberately small: a few
quality replies and light likes a day from @Agentik_os, gated and human-paced. The 10k
followers goal is the north star of a bounded loop (R-LOOP), measured weekly, never a
"spam until it works" loop.

## Why not full auto like/comment/follow

Mass automated engagement is the number-one pattern X spam-detection nukes. The realistic
outcome is a shadowban or suspension of the brand account, not growth. Bought/botted
followers are dead weight. So this engine refuses mass follow/unfollow, auto-DM, and
spray-reply. It does bounded, genuine, gated engagement only.

## Pipeline

```
cron (daily) → [1] RADAR   find threads → last30days --search x (ScrapeCreators)
             → [2] DRAFT   genuine on-voice replies (claude, sonnet)
             → [3] GATE    adversarial anti-spam/anti-cringe (claude, opus) — default reject
             → [4] QUEUE   dedup vs seen, cap replies + likes
             → [5] EXECUTE (armed + valid session) Playwright → bounded replies + likes, human-paced
             → [6] REPORT  HTML in ~/.omega/artifacts + Telegram alert
```

## Safety rails (non-negotiable)

- `armed` flag (`~/.omega/state/growth-engine/armed`) — kill-switch. Absent = drafts only.
- valid X session at `~/.omega/secrets/x-session.json` (else nothing posts, alert fires).
- gate `keep=true`, fingerprint unseen, under `EG_REPLIES_CAP` (6) and `EG_LIKES_CAP` (15).
- human pacing (22-75s between actions), per-char typing delay, skip already-liked.
- no em/en dash, <=280 chars, no @-spam (enforced in gate + queue, R-NODASH).

## Setup (one-time)

1. Bun runtime with Playwright: `mkdir -p ~/.omega/lib/growth-engine && cd $_ && bun add playwright`,
   then copy the executor: `cp scripts/playwright-engage.mjs ~/.omega/lib/growth-engine/`.
2. X session cookies (drives @Agentik_os): log into x.com, DevTools → Application → Cookies →
   copy `auth_token` and `ct0`, then:
   `bash scripts/x-session-setup.sh <auth_token> <ct0>` → writes ~/.omega/secrets/x-session.json.
3. Verify: `bun ~/.omega/lib/growth-engine/playwright-engage.mjs --check` → `check_ok`.

## Run

```
bash scripts/engage-run.sh                 # full run (drafts unless armed + session)
EG_MOCK=1 bash scripts/engage-run.sh       # fixtures, never posts (smoke test)
```

Env: `EG_REPLIES_CAP` (6), `EG_LIKES_CAP` (15), `EG_DAYS` (2), `EG_ANALYZE_MODEL`
(claude-sonnet-5), `EG_GATE_MODEL` (claude-opus-4-8), `EG_TOPICS_FILE`.

## Arm / disarm

```
touch ~/.omega/state/growth-engine/armed    # bounded auto-engagement on
rm    ~/.omega/state/growth-engine/armed     # kill-switch: drafts only
```

## Config & state

- `config/engage-topics.txt` — thread-finding queries.
- `~/.omega/state/growth-engine/seen.jsonl` — engaged fingerprints (never engage twice).
- `~/.omega/state/growth-engine/runs/<date>/` — radar, queue, results, screenshots.
- `~/.omega/artifacts/growth-engine-<date>.html` — daily report.

## Requires

- `SCRAPECREATORS_API_KEY` in ~/.omega/secrets/ (thread finding).
- `claude` CLI, `bun` + Playwright + chromium, a valid X session (setup above).
- last30days checkout at ~/.omega/repos/last30days-skill/.