# BuildBotsBetter Specification: Creating Reddit Content for the AI, SI, and Agentic Era

## Course Metadata
- **Task Key**: `reddit-content-ai-si-agentic-era`
- **Course Title**: Creating Reddit Content for the AI, SI, and Agentic Era
- **Subtitle**: Beyond Upvotes and Karma: Architecting Reddit-Native Knowledge, Community Intelligence, Comment-to-Knowledge Extraction, AI Discoverability, and Agent-Ready Content for Humans, Reddit Answers, and Synthetic Intelligence
- **Category**: Content Knowledge Architecture, Community Intelligence & Synthetic Intelligence
- **Target Audience**: AI Builders, Engineers, Technical Creators, Content Agents, Developers, and Community Architects navigating Reddit's conversational ecosystem, AI search engines, and multi-agent discovery environments
- **Course Mission**: Train the Build Bots Better Reddit Content Agent to transform canonical knowledge objects into authentic, community-native Reddit contributions, facilitate high-signal conversations, extract structured knowledge from discussions, and optimize for both human peers and AI/SI retrieval systems.

---

## The Central Thesis
> **"One Knowledge Source → Reddit-Native Knowledge Experience."**
> **"Don't just create content FOR Reddit. Create content FROM knowledge that happens to be distributed natively on Reddit."**
> **"Reddit is not YouTube with a link, TikTok with a link, or Facebook with different formatting. Reddit is a community-driven knowledge and conversation network."**

The fundamental continuum operates as:
**Humans create information → communities debate & refine information → platforms index & rank discussions → AI models retrieve & synthesize conversations → autonomous agents execute verified solutions → Synthetic Intelligence coordinates multi-agent systems.**

The core optimization progression:
**Human Optimization → Community Optimization → Subreddit Optimization → Conversation Optimization → Search Optimization → Reddit AI Optimization → AI Discoverability → Agentic Optimization → Synthetic Intelligence Optimization.**

---

## Epistemic Rigor & Conceptual Guardrails

### Crucial Scientific Distinction
Creators, marketers, and developers must **NEVER** claim that posting on Reddit, earning upvotes, adding flairs, or participating in threads automatically causes commercial AI models to train on or permanently incorporate the content into base model weights.

Creators and autonomous agents must explicitly distinguish among 13 distinct machine-interaction mechanisms:
1. **Training Data**: Base model pre-training corpora (Reddit licensed datasets, Common Crawl, deduplicated web archives).
2. **Fine-Tuning**: Supervised fine-tuning (SFT) and instruction alignment datasets derived from conversational forums.
3. **Retrieval**: Real-time retrieval via search engines, Reddit API, and crawler indexing.
4. **Search Indexing**: Traditional keyword matching and inverted indexing across titles, selftext, and top comments.
5. **RAG (Retrieval-Augmented Generation)**: Grounding LLM prompts with live Reddit thread contexts.
6. **Dense Embeddings**: Mathematical vector space representations for semantic search and question-answer matching.
7. **Knowledge Graphs**: Structured entity triples (Subreddit, Post, Author, Solution, Tool, Outcome).
8. **Recommendation Systems**: Personalized candidate generation, Hot/Best/Rising ranking algorithms, and user engagement scoring.
9. **Context Windows**: Ephemeral prompt memory during inference when processing Reddit discussions.
10. **AI Search & Citations**: Real-time generative summarization with Reddit thread citations (e.g. Google AI Overviews, Perplexity, Reddit Answers).
11. **Content Provenance**: Cryptographic signing, author attribution, timestamped commit history, and reproducible test proofs.
12. **Agentic Retrieval**: Autonomous software agents querying Reddit for troubleshooting recipes and tool configurations.
13. **Platform-Specific AI Systems**: Reddit Answers, Reddit Pro AI tools, automated spam moderation, and machine-learning content classifiers.

### Epistemic Labeling Taxonomy
Every concept, recommendation, and observation must be categorized into one of five epistemic tiers:
- **[ESTABLISHED]**: Verified by official Reddit engineering documentation, published API specs, or peer-reviewed computer science research.
- **[EVIDENCE-SUPPORTED]**: Demonstrated through reproducible community experiments, documented search crawler behavior, and empirical testing.
- **[EMERGING]**: Active developments in early deployment across Reddit Answers, AI Overviews, and agentic search engines.
- **[HYPOTHESIS]**: Conceptually grounded frameworks under active verification on operational testbeds.
- **[SPECULATION]**: Forward-looking theoretical projections regarding future Synthetic Intelligence (SI) coordination.

---

## Complete 24-Part Curriculum Architecture

### Part 1: Understand Reddit Before Creating Content
- Deconstructing Reddit's platform architecture: subreddits, posts, comments, nested threads, upvotes, downvotes, karma, post flair, user flair, moderation teams, AutoModerator rules, unwritten cultural norms.
- Content types: text (selftext markdown), native images, galleries, native video, polls, AMAs, profile posts, comment media.
- Discovery surfaces: Home, Popular, Best (Wilson score confidence interval), Hot (logarithmic decay), New, Rising, Trending topics, community recommendations.
- Reddit Pro, Publisher tools, Reddit Answers, and AI-powered community search.
- Core rule: Reddit is not one audience; it is a federation of thousands of specialized, sovereign micro-communities.

### Part 2: The Subreddit Is the Audience
- Paradigm shift: **YouTube → audience**, but **Reddit → community**.
- The 10-Question Subreddit Pre-Flight Analysis:
  1. Which subreddit?
  2. Why does this subreddit exist?
  3. What does this community care about?
  4. What conversations are currently happening?
  5. What terminology and tone does the community use?
  6. What content does the community reward?
  7. What content does the community reject or downvote?
  8. What are the explicit community rules (sidebar, wiki)?
  9. What are the unwritten cultural and social norms?
  10. What makes the post feel native and contributory rather than promotional?

### Part 3: Reddit Community Intelligence
- Building the Community Intelligence Profile: purpose, subscriber count, active users, posting frequency, top posts (all time / year / month), typical title syntax, post length distribution, comment depth, recurring questions, controversial disagreements, and banned topics.
- Governance profiling: AutoModerator constraints, account age requirements, minimum karma thresholds, link restrictions, flair mandates, external media bans, and AI content policies.
- Generating the **Reddit Community Fit Score** (0-100) before any content is submitted.

### Part 4: Reddit Is a Conversation Engine
- Shift from broadcast mindset (*Create post → collect views*) to conversational contribution (*Create contribution → start conversation → participate in conversation → extract new knowledge*).
- 17 Conversational Archetypes: questions, troubleshooting problems, unexpected discoveries, post-mortems and failures, head-to-head comparisons, empirical experiments, technical breakdowns, architecture walk-throughs, before/after transformations, defensible contrarian opinions, and community resource compilations.
- Optimizing for conversation depth, comment quality, and insight density over raw impression counts.

### Part 5: Reddit Post Types
- Mastering native formats:
  - **Text Posts (Selftext)**: Deep-dive tutorials, architecture breakdowns, lessons learned, and empirical experiments formatted with crisp Markdown, clear headers, code blocks, and structured takeaways.
  - **Image Posts**: Architectural diagrams, benchmark graphs, debugging screenshots, and workflow visualizations where the visual conveys instant technical truth.
  - **Gallery Posts**: Sequential multi-step workflows, step-by-step UI progressions, and before/after comparisons.
  - **Native Video Posts**: Standalone demos, live console screencasts, and technical proofs where audio/video provides self-contained value within the player.
  - **Video Comments**: High-signal visual responses providing context that text alone cannot convey.
  - **Link Posts**: Strategic citations pointing to primary documentation, RFCs, or repositories only when the external resource is the primary subject.

### Part 6: Native Reddit Video vs External Video
- Systematic decision matrix for video assets:
  - Option A: Native Reddit Video (low friction, autoplay, high in-app retention, subreddit permitting).
  - Option B: YouTube Link (deep educational reference, complex multi-hour code walk).
  - Option C: TikTok Link (fast vertical micro-hook, empirical comparison).
  - Option D: Instagram Link (visual carousel/reel demonstration).
  - Option E: Other External Media.
- Measuring distribution: tracking impressions, views, upvotes, downvotes, comment sentiment, outbound click-through, preview rendering, and removal rates.
- Building the dynamic **Reddit Video Distribution Model**.

### Part 7: Reddit Titles Are a Specialized Skill
- De-marketing the title: eliminating sensationalism, clickbait ("You won't believe...", "This changed everything..."), emotional hype, and excessive emojis.
- Subreddit-native title syntax: descriptive, specific, problem-oriented, contextual, and curiosity-producing through intellectual merit.
- Comparing Title Archetypes across engineering, DevOps, and AI communities.

### Part 8: Reddit Comments Are Content
- The agent as a **Comment Intelligence Agent**:
  - Identifying high-leverage technical discussions.
  - Answering developer questions with verifiable code and commands.
  - Clarifying technical misconceptions without condescension.
  - Sharing reproducible benchmarks and debugging traces.
  - Respectfully engaging with critiques and acknowledging legitimate edge cases.
- Recognizing that comment karma and comment authority often exceed the impact of original submissions.

### Part 9: Comment-to-Knowledge (Knowledge Extraction)
- Treating high-signal Reddit discussions as primary knowledge assets.
- The 9-Point Discussion Extraction Schema:
  1. Core Question / Problem Statement
  2. Dominant Consensus Solution
  3. Competing Alternative Solutions
  4. Empirical Evidence & Benchmarks
  5. Practical Code Examples & Traces
  6. Documented Edge Cases & Disagreements
  7. Root Cause Conclusions
  8. Unresolved Questions & Follow-ups
  9. Permanent Entities & Tool Bindings
- Recomposition pipeline: **Reddit Discussion → Canonical Knowledge Object → Article / Documentation / Course / Video / AI Retrieval Asset**.

### Part 10: Reddit Search & Semantic Discovery
- Inverted index matching, title token weighting, body text parsing, comment threading search, and media alt tags.
- Semantic relevance and entity disambiguation within subreddits.
- Optimizing for human discoverability first while establishing explicit entity references for Reddit's internal search and external search crawlers.

### Part 11: Reddit's AI Layer
- Ingesting and evaluating Reddit's contemporary AI stack:
  - Reddit AI-Powered Search and conversational queries.
  - Reddit Answers: generative multi-thread summarization and citation.
  - ML recommendation systems: Best sorting, Home feed personalized discovery, and related community clustering.
  - Reddit Pro AI features: sentiment tracking, conversation trend prediction, and audience insights.
  - AI moderation systems: automated spam detection, synthetic text flags, and toxic behavior classifiers.

### Part 12: Reddit as an AI Knowledge Source
- Dissecting how LLMs, AI search engines, and web crawlers consume Reddit data.
- The critical boundary: Base Model Training vs Retrieval/RAG vs Synthetic Grounding.
- Explicit Knowledge Structuring: ensuring problems, tools, versions, error codes, and verified resolutions are unambiguous for AI ingestion.
- Enforcing the 5-Tier Epistemic Taxonomy on all technical claims.

### Part 13: Reddit + AI Discoverability
- Designing posts for dual human/machine discoverability:
  - Explicit named entities (software names, version numbers, API endpoints, protocol RFCs).
  - Subject-Predicate-Object semantic triples.
  - Clear architectural taxonomy and structured code blocks.
  - Source attribution and verifiable external references.

### Part 14: Reddit + Agent-Ready Content
- Formatting troubleshooting and operational knowledge so autonomous AI agents can ingest and execute solutions deterministically.
- Answering the 6 Core Agent Questions:
  1. *What is this object/tool?*
  2. *Who/what environment is this for?*
  3. *What exact problem does it solve?*
  4. *How does it work mechanically?*
  5. *What are the failure modes and edge cases?*
  6. *What deterministic command must be executed next?*
- The Multi-OS Command Card Standard: Windows PowerShell, macOS zsh, Linux bash equivalents for every platform task.

### Part 15: Reddit Culture vs Marketing Culture
- The Contribution vs Promotion divide:
  - *Contribution*: "We tested 7 AI coding agents against an 8,000-token context window; here is the raw latency and memory profile."
  - *Promotion*: "Check out our revolutionary new AI coding agent that beats everyone!"
- Zero tolerance for astroturfing, fake sockpuppet accounts, artificial upvote manipulation, manufactured controversy, or deceptive promotional links.
- Emphasizing transparency, honest disclosure of failures, and authentic engineering logs.

### Part 16: Build Bots Better on Reddit
- Operational persona: an active, transparent engineering participant in technical communities (r/MachineLearning, r/LocalLLaMA, r/artificial, r/programming, r/devops).
- Sharing the real journey of multi-agent development: context window bottlenecks, database concurrency issues, prompt drift, and automated test harnesses.

### Part 17: Reddit Experimentation Lab
- Designing structured, reproducible empirical experiments:
  - Content structure tests (Text vs Image vs Gallery vs Video).
  - Title framing tests (Descriptive Problem vs Question vs Case Study).
  - Timing and velocity tests (Day of week, peak community hours).
  - Engagement triggers (Technical question vs invitation to critique vs benchmark challenge).
- Documenting results in structured experiment logs.

### Part 18: Reddit Analytics & Knowledge Metrics
- Quantitative metrics: upvotes, downvotes, upvote ratio, comment count, comment depth, share count, profile views, outbound referral clicks.
- Qualitative Knowledge Metrics:
  - Did the community validate or challenge the technical findings?
  - Did subject-matter experts contribute novel insights?
  - Were bugs, edge cases, or corrections identified?
  - Did the thread become a persistent reference cited by others?

### Part 19: Reddit Content Quality Score
- The 10-Dimension Evaluation Matrix (0-100 total):
  1. Reddit Native Score (0-10)
  2. Community Fit Score (0-10)
  3. Conversation Depth Score (0-10)
  4. Technical Value Score (0-10)
  5. Trust & Transparency Score (0-10)
  6. AI Discoverability Score (0-10)
  7. Agent Execution Readiness Score (0-10)
  8. Promotional Inversion Score (Low promotion = high score) (0-10)
  9. Moderation Compliance Score (0-10)
  10. Cross-Platform Reusability Score (0-10)
- Readiness Tiers: Tier 1 (90-100, Canonical Knowledge), Tier 2 (80-89, High-Signal Contribution), Tier 3 (70-79, Community Passable), Tier 4 (50-69, Needs Semantic Refinement), Tier 5 (<50, Non-Compliant / Promotional Risk).

### Part 20: The Reddit Knowledge Flywheel
- The continuous B3 learning loop:
  **Build Bots Better Build → Real-World Experiment → Reddit Contribution & Discussion → Community Feedback & Critiques → Knowledge Extraction → Structured Knowledge Object → Improved Build → Next Experiment.**

### Part 21: Reddit → Multi-Platform Knowledge
- Recomposing extracted Reddit knowledge into platform-native expressions:
  - **Reddit**: Deep conversational breakdown, raw debugging traces, community debate.
  - **YouTube**: In-depth video architecture walkthrough, screen recording, chaptered analysis.
  - **TikTok**: Rapid 60-second visual insight with hook, sound, and quick takeaway.
  - **Instagram**: Multi-slide carousel diagram with visual aesthetic and saveable summary.
  - **LinkedIn**: Strategic industry implication, business impact, and enterprise architecture.
  - **X**: High-velocity thread chain, entity tags, and real-time discussion.
  - **Facebook**: Practical community group case study and implementation tips.
  - **Build Bots Better**: Canonical, versioned Knowledge Object in repository.

### Part 22: The Reddit Content Factory Pipeline
- End-to-end deterministic pipeline:
  Specification → Knowledge Object → Subreddit Intelligence → Fit Verification → Content Strategy → Native Post Composition → First-Comment Strategy → Real-Time Moderation → Community Discussion → Knowledge Extraction → Analytics Logging → Model Feedback.

### Part 23: The Reddit Content Agent Operating System
- The 17 Pre-Flight Execution Checks executed before publishing:
  1. Knowledge source validated?
  2. Target audience defined?
  3. Target subreddit selected?
  4. Subreddit purpose aligned?
  5. Community rules and wiki verified?
  6. Format chosen (Text, Image, Gallery, Video, Link)?
  7. Video format decided (Native vs External)?
  8. External destination justified?
  9. Title passes anti-clickbait filter?
  10. Value delivered upfront before any request?
  11. First-comment roadmap established?
  12. Conversation triggers embedded?
  13. Multi-OS command cards verified?
  14. Epistemic labels assigned?
  15. Moderation risk evaluated?
  16. Extraction schema initialized?
  17. Logging hooks active?

### Part 24: Final Capstone Project
- Complete 22-step end-to-end execution of a real BuildBotsBetter engineering scenario:
  From diagnosing an AI agent context bottleneck → running empirical tests → creating a Reddit-native contribution in r/LocalLLaMA → engaging in technical community debate → extracting 3 new edge cases → updating the canonical knowledge repository → recomposing into multi-platform assets.

---

## Mandatory Build Bots Better Operational Safeguards
In accordance with fleet rules (#31, #1050, #1051, #1073), the build must include:
1. **Onboarding Checklist (7 items)**: Verified credentials, database connection, hub inbox check, CI/CD validation, safety boundary check, git configuration, and backup verification.
2. **Variable-Limit Delete Guard Demo**: Demonstration of protective regex intercepting dangerous variables (e.g. `$tmp = $env:USERPROFILE; Remove-Item -Recurse $tmp` blocked with exit code 1).
3. **Automated Backup**: Off-volume / dedicated backup archive routine preserving build integrity.
4. **Practiced Restore Drill (`proof.txt`)**: Verifiable end-to-end backup and restore verification ledger.
5. **Fail-Closed Workspace Policy**: Technical boundary enforcement preventing cross-agent tree modifications without explicit authorization.

---

## SEO and AI/SI Technical Requirements
1. Full Meta Tags: Title, description, keywords, robots, canonical URL, author, OpenGraph (og:title, og:description, og:type, og:image, og:url), Twitter Card (twitter:card, twitter:title, twitter:description, twitter:image).
2. Schema.org JSON-LD:
   - `Course`: Name, description, provider, educationalLevel, hasCourseInstance.
   - `VideoObject`: Name, description, transcript, duration, clips, interactionStatistic.
   - `HowTo`: Steps, tools, supplies, totalTime.
   - `Speakable`: Key summary CSS selectors.
3. Standalone `faqs.json`: Machine-readable FAQ dataset for AI crawlers, RAG vectors, and generative search engines.
4. Interactive AI Coach: Dedicated conversational agent interface simulating Reddit AI query resolution, community fit scoring, and knowledge extraction.