reddit-engagement

name	reddit-engagement
description	Create and execute robust Reddit engagement workflows (create post, add comment, upvote) using browser accessibility-tree semantics instead of brittle DOM ids/CSS selectors. Use when asked to automate Reddit actions with high success rate across UI changes, A/B tests, and localization differences; especially when reliability and intent-based element targeting are required.

Reddit Engagement

Execute Reddit actions by intent and semantics, not static selectors.

⚠️ Content Policy — Read Before Writing Anything

1. Read PERSONA.md (workspace root) before composing any comment or post.
2. Never fabricate personal stories — no invented family members, relationships, health events, or "I personally experienced..." narratives unless the fact is recorded in PERSONA.md.
3. Use only: documented personal facts from PERSONA.md, opinion-based responses, or general observations that don't claim specific personal experience.
4. After posting, log it in the "已使用的故事/内容记录" table in PERSONA.md to prevent contradictions across posts.

---

Core Operating Rules

1. Use accessibility snapshots (snapshot with refs="aria") before every critical step.
2. Target elements by role+label+context, never by fixed DOM id/class/XPath.
3. Re-snapshot after each navigation, modal open/close, submit, or failure.
4. Validate page state before action (logged-in, subreddit resolved, composer visible, button enabled).
5. Require confirmation text for destructive/high-visibility actions when user did not explicitly pre-authorize immediate send.

Resource Index

Resource	Location	Purpose
Post Strategy	references/post-strategy.md	Content angles, anti-AI rules, subreddit cultures, engagement triggers
Comment Strategy	references/comment-strategy.md	(Reserved) Reply patterns, comment-specific tactics
Interaction Patterns	references/interaction-patterns.md	UI automation playbooks (how to click/type/verify)
Sub Archives	references/sub-archives.md	Core info for all subreddits (one file)
Persona Facts	PERSONA.md (workspace root)	Authentic personal facts to use in content

---

Subreddit Name Index

Pre-defined Archives (in post-strategy.md)

These subreddits have curated cultural profiles:

Subreddit	Focus	Posting Bar
r/Startup_Ideas	Idea validation, feedback	Medium — show research
r/SaaS	SaaS building, metrics, growth	Medium-High — data expected
r/TheFounders	Founder experiences, support	Medium — authenticity valued
r/openclaw	OpenClaw tool discussions	Low-Medium — technical

Dynamic Archive System

For subreddits NOT listed above:

1. Check for existing archive: Read references/sub-archives.md, find the sub section
2. If not found: Execute interaction-patterns.md §0 (Dynamic Subreddit Analysis Framework)
3. Append to file: Add new sub info to references/sub-archives.md using the template at bottom
4. Use for content generation: Treat like pre-defined profile

Supported Subreddit Categories

Category	Example Subs	Strategy
Startup/Business	r/Entrepreneur, r/smallbusiness, r/marketing	Use r/Startup_Ideas baseline
Technology	r/technology, r/programming, r/webdev	Use r/openclaw baseline
AI/ML	r/artificial, r/MachineLearning, r/LocalLLaMA	Technical + data-driven tone
Productivity	r/productivity, r/Notion, r/Obsidian	Workflow-focused, practical
General Discussion	r/CasualConversation, r/AskReddit	Casual, low bar

Rule: If no archive exists in sub-archives.md and category match is unclear → always run dynamic analysis (§0) before posting.

---

Workflow Router

Create Post

Trigger: user asks to publish in a subreddit.

Content Generation Flow:

1. Determine Input Type

   • If user provides full content (title + body) → use as-is, skip strategy
   • If user provides fuzzy request (e.g., "post about OpenClaw") → execute strategy flow below

2. Strategy Flow (for fuzzy requests) a. Identify Target Subreddit — extract from user request or ask b. Load Sub Profile — read references/post-strategy.md §1 for subreddit rules/tone c. Select Content Angle — read references/post-strategy.md §3 for angle matching intent d. Load Persona Facts — read workspace PERSONA.md for authentic personal facts e. Apply Anti-AI Rules — read references/post-strategy.md §2 to avoid AI-sounding language f. Draft Content — combine sub profile + angle + persona facts + anti-AI rules g. Add Engagement Hook — read references/post-strategy.md §4 for comment triggers h. Craft Title — read references/post-strategy.md §1 for subreddit-specific title patterns

3. Confirmation

   • Echo generated content to user for approval (unless user pre-authorized immediate send)

4. Publish

   • Execute references/interaction-patterns.md §1 (Create Post workflow)

5. Log Usage

   • Update PERSONA.md "已使用内容登记" table to prevent future contradictions

Flow Reference: references/interaction-patterns.md §1

---

Create Comment

Trigger: user asks to reply to a post or comment.

Content Generation Flow:

1. Determine Input Type

   • If user provides full comment text → use as-is
   • If user provides fuzzy request (e.g., "comment on this post") → execute strategy flow below

2. Strategy Flow (for fuzzy requests) a. Read Target Post/Comment — understand context and existing discussion b. Check Subreddit Info

   • Read references/sub-archives.md for this sub
   • If NOT found: Execute interaction-patterns.md §0 (Dynamic Subreddit Analysis Framework), then append sub info to references/sub-archives.md
   • If found: Use existing info (tone, rules, restrictions) c. Load Comment Strategy — read references/comment-strategy.md (when available) or apply post-strategy.md Human-First rules d. Load Persona Facts — read workspace PERSONA.md for authentic personal facts e. Apply Anti-AI Rules — read references/post-strategy.md (Word Razor, Two-Beat Flow, etc.) f. Draft Comment — ensure information increment, not just "+1"; match sub tone from step b

3. Confirmation

   • Echo generated comment to user for approval (unless pre-authorized)

4. Publish

   • Execute references/interaction-patterns.md §2 (Create Comment workflow)

5. Log Usage

   • Update PERSONA.md "已使用内容登记" table if persona facts were used

Flow Reference: references/interaction-patterns.md §2

---

Upvote

Trigger: user asks to like/upvote a post or comment.

Flow: Execute references/interaction-patterns.md §3 (Upvote workflow)

No content generation needed.

Universal Reliability Loop

For each action step:

1. Snapshot current tab with aria refs.
2. Resolve target candidates by semantic cues (role, accessible name, nearby headings/text).
3. Score candidates (exact intent match > synonym match > position-based guess).
4. Execute one action.
5. Verify outcome with independent evidence (state change, toast, button state, new content visible).
6. If verification fails, rollback one step (or refresh context) and retry with next candidate.

Stop after 3 failed attempts and return a clear diagnostic with:

• last confirmed state
• failing intent
• top 2 alternate hypotheses

Semantic Targeting Standard

Prefer these signals (highest to lowest confidence):

1. Accessible role + accessible name exact match (e.g., button "Post", "Comment", "Upvote").
2. Accessible name synonym match (e.g., "Submit", "Reply", "Send").
3. Relative context anchor (inside composer region; under post action row; near subreddit title).
4. Visibility and enabled state checks.

Never rely on:

• hardcoded CSS selectors
• hardcoded DOM ids/classes
• absolute XPath
• static child index paths

Submission Safety Gates

Before clicking final submit:

1. Echo target summary: subreddit/post URL/action/content preview.
2. Ensure required fields are non-empty and within Reddit limits.
3. Confirm account/session is authenticated.
4. Confirm no blocking validation/errors are visible.

If explicit user request already includes immediate-send intent, submit directly. Otherwise ask one short confirmation.

Output Contract

After completion, return:

• Action performed
• Target (subreddit/post/comment)
• Result (success | partial | failed)
• Evidence (what changed in UI)
• If failed: next best recovery step

Fast Troubleshooting

• Login wall/captcha: pause and ask user to complete challenge, then resume from latest snapshot.
• Button exists but disabled: inspect missing required fields or rate limits.
• Multiple matching buttons: choose candidate within nearest semantic container (composer/action row).
• UI redesign: rely on role/name/context fallback chain from references/interaction-patterns.md.