sinapse-ai 9.3.0 → 9.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/CLAUDE.md +56 -343
- package/.claude/rules/agent-authority.md +6 -0
- package/.claude/rules/agent-handoff.md +5 -0
- package/.claude/rules/cross-squad-routing.md +5 -0
- package/.claude/rules/hook-governance.md +6 -0
- package/.claude/rules/mcp-usage.md +3 -1
- package/.claude/rules/safe-collaboration.md +10 -0
- package/.claude/rules/security-data-protection.md +9 -0
- package/.claude/rules/squad-awareness.md +3 -1
- package/.claude/rules/tool-examples.md +6 -0
- package/.claude/rules/workflow-execution.md +7 -0
- package/.codex/agents/analyst.md +253 -72
- package/.codex/agents/architect.md +455 -68
- package/.codex/agents/data-engineer.md +492 -106
- package/.codex/agents/developer.md +560 -0
- package/.codex/agents/devops.md +518 -69
- package/.codex/agents/product-lead.md +335 -0
- package/.codex/agents/project-lead.md +377 -0
- package/.codex/agents/quality-gate.md +449 -0
- package/.codex/agents/sinapse-orqx.md +9 -7
- package/.codex/agents/sprint-lead.md +287 -0
- package/.codex/agents/squad-creator.md +344 -0
- package/.codex/agents/ux-design-expert.md +495 -0
- package/.codex/delegation-matrix.json +756 -44
- package/.codex/handoff-packet.schema.json +30 -6
- package/.sinapse-ai/data/entity-registry.yaml +175 -363
- package/.sinapse-ai/data/registry-update-log.jsonl +16 -0
- package/.sinapse-ai/development/agents/analyst.md +90 -0
- package/.sinapse-ai/development/agents/architect.md +73 -0
- package/.sinapse-ai/development/agents/developer.md +69 -0
- package/.sinapse-ai/development/agents/devops.md +117 -0
- package/.sinapse-ai/development/agents/quality-gate.md +85 -0
- package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
- package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
- package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
- package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
- package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
- package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
- package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
- package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
- package/.sinapse-ai/development/skills/debug.md +57 -0
- package/.sinapse-ai/development/skills/fast-review.md +69 -0
- package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
- package/.sinapse-ai/development/skills/security-scan.md +73 -0
- package/.sinapse-ai/development/skills/verify.md +53 -0
- package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
- package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
- package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
- package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
- package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
- package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
- package/.sinapse-ai/install-manifest.yaml +71 -35
- package/docs/codex-integration-process.md +22 -0
- package/docs/codex-parity-program.md +27 -0
- package/docs/ide-integration.md +36 -0
- package/package.json +1 -1
- package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
- package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
- package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
- package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
- package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
- package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
- package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
- package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
- package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
- package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
- package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
- package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
- package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
- package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
- package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
- package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
- package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
- package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
- package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
- package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
- package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
- package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
- package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
- package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
- package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
- package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
- package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
- package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
- package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
- package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
- package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
- package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
- package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
- package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
- package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
- package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
- package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
- package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
- package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
- package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
- package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
- package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
- package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
- package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
- package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
- package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
- package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
- package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
- package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
- package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
- package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
- package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
- package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
- package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
- package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
- package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
- package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
- package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
- package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
- package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
- package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
- package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
- package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
- package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
- package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
- package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
- package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
- package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
- package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
- package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
- package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
- package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
- package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
- package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
- package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
- package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
- package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
- package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
- package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
- package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
- package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
- package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
- package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
- package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
- package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
- package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
- package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
- package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
- package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
- package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
- package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
- package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
- package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
- package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
- package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
- package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
- package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
- package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
- package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
- package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
- package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
- package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
- package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
- package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
- package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
- package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
- package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
- package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
- package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
- package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
- package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
- package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
- package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
- package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
- package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
- package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
- package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
- package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
- package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
- package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
- package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
- package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
- package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
- package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
- package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
- package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
- package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
- package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
- package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
- package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
- package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
- package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
- package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
- package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
- package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
- package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
|
@@ -0,0 +1,786 @@
|
|
|
1
|
+
# Community Platforms Engineering Reference
|
|
2
|
+
|
|
3
|
+
> **Source:** MS-010 Forum & Community Platform Engineering Research
|
|
4
|
+
> **Squad:** squad-research | **Agent:** @analyst (Scope)
|
|
5
|
+
> **Last updated:** 2026-04-10
|
|
6
|
+
> **Coverage:** 8 core systems, 9 platforms, 80+ sources
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Table of Contents
|
|
11
|
+
|
|
12
|
+
1. [Social Graph Engine](#1-social-graph-engine)
|
|
13
|
+
2. [Information Architecture](#2-information-architecture)
|
|
14
|
+
3. [Thread Engine & Ranking Algorithms](#3-thread-engine--ranking-algorithms)
|
|
15
|
+
4. [Trust, Moderation & Governance](#4-trust-moderation--governance)
|
|
16
|
+
5. [Gamification & Identity](#5-gamification--identity)
|
|
17
|
+
6. [Growth Loops & Virality](#6-growth-loops--virality)
|
|
18
|
+
7. [Monetization Stack](#7-monetization-stack)
|
|
19
|
+
8. [SEO Engine & Frontend](#8-seo-engine--frontend)
|
|
20
|
+
9. [Platform Comparative Matrix](#9-platform-comparative-matrix)
|
|
21
|
+
10. [Implementation Checklists](#10-implementation-checklists)
|
|
22
|
+
11. [Key References](#11-key-references)
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## 1. Social Graph Engine
|
|
27
|
+
|
|
28
|
+
### Barabasi-Albert Model (Scale-Free Networks)
|
|
29
|
+
|
|
30
|
+
Real social networks follow **power-law degree distributions** where a few hub nodes hold vastly more connections than most. Two mechanisms drive this:
|
|
31
|
+
|
|
32
|
+
1. **Growth** -- networks continuously add new nodes
|
|
33
|
+
2. **Preferential attachment** -- new nodes prefer connecting to well-connected nodes ("rich-get-richer")
|
|
34
|
+
|
|
35
|
+
Degree distribution: `P(k) ~ k^(-gamma)`, typically gamma between 2 and 3.
|
|
36
|
+
|
|
37
|
+
**Platform manifestation:** A few subreddits dominate Reddit traffic. A few Stack Overflow users answer most questions. A few Discord servers attract millions of members.
|
|
38
|
+
|
|
39
|
+
### Granovetter's Strength of Weak Ties (1973)
|
|
40
|
+
|
|
41
|
+
Weak ties (acquaintances) are more valuable than strong ties for **information diffusion**. Strong ties cluster in dense groups sharing the same information. Weak ties bridge clusters, enabling novel information flow.
|
|
42
|
+
|
|
43
|
+
| Mechanism | Platform Example |
|
|
44
|
+
|-----------|-----------------|
|
|
45
|
+
| Server-hopping | Discord weak ties across communities |
|
|
46
|
+
| Crossposting | Reddit bridges between subreddits |
|
|
47
|
+
| Tag overlap | Stack Overflow connects experts across domains |
|
|
48
|
+
|
|
49
|
+
### Network Effects Taxonomy
|
|
50
|
+
|
|
51
|
+
| Type | Definition | Example |
|
|
52
|
+
|------|-----------|---------|
|
|
53
|
+
| **Direct** | More users = more value for all | More Reddit users = more content |
|
|
54
|
+
| **Indirect** | More users attract complementary goods | More Discord users = more bots |
|
|
55
|
+
| **Cross-side** | Group A benefits Group B | More SO answerers = value for askers |
|
|
56
|
+
| **Same-side** | More of same group benefits that group | More Discord server members = richer chat |
|
|
57
|
+
| **Data** | More usage = better algorithms | Reddit ranking improves with more votes |
|
|
58
|
+
| **Local** | Effects within sub-clusters | Subreddit value depends on its own members |
|
|
59
|
+
|
|
60
|
+
### Mathematical Laws
|
|
61
|
+
|
|
62
|
+
| Law | Formula | Real-World Validation |
|
|
63
|
+
|-----|---------|----------------------|
|
|
64
|
+
| **Metcalfe's Law** | V = n^2 | Facebook revenue fit n-squared over a decade |
|
|
65
|
+
| **Reed's Law** | V = 2^n (theoretical upper bound) | Never fully observed; platforms enabling group formation capture more value |
|
|
66
|
+
| **Death Spiral** (Andrew Chen) | Network effects work both ways | Declining community loses value, accelerating decline |
|
|
67
|
+
|
|
68
|
+
### Graph Implementation Patterns
|
|
69
|
+
|
|
70
|
+
| Platform | Graph Model | Key Feature |
|
|
71
|
+
|----------|------------|-------------|
|
|
72
|
+
| Reddit | Bipartite (users <-> subreddits) | Subscription-based content routing |
|
|
73
|
+
| Discord | Hierarchical (servers -> categories -> channels -> threads) | Role-based access control per node |
|
|
74
|
+
| Stack Overflow | Tripartite (users <-> questions <-> tags) | Tag-based expertise clustering |
|
|
75
|
+
| Discourse | Flat with categories + trust levels | Trust-based permission expansion |
|
|
76
|
+
| Circle | Spaces with membership gates | Payment-gated subgraphs |
|
|
77
|
+
|
|
78
|
+
### Risks & Mitigations
|
|
79
|
+
|
|
80
|
+
| Risk | Mitigation |
|
|
81
|
+
|------|-----------|
|
|
82
|
+
| Hub dependency (power users leave -> fragmentation) | Distribute influence, nurture mid-tier contributors |
|
|
83
|
+
| Filter bubbles from preferential attachment | Cross-community bridging features |
|
|
84
|
+
| Cold start problem | Seed content, invite strategy, creator-led launch |
|
|
85
|
+
| Moderation concentration on hubs | Distributed moderation via reputation systems |
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 2. Information Architecture
|
|
90
|
+
|
|
91
|
+
### Taxonomy Models by Platform
|
|
92
|
+
|
|
93
|
+
| Platform | Model | Depth |
|
|
94
|
+
|----------|-------|-------|
|
|
95
|
+
| Reddit | Flat (subreddits as peers) | 1 level |
|
|
96
|
+
| Discord | Categories -> channels | Fixed 2 levels |
|
|
97
|
+
| Stack Overflow | Tag-based folksonomy + synonyms | Flat with tag wikis |
|
|
98
|
+
| Discourse | Categories -> subcategories + tags | 2 levels + tags |
|
|
99
|
+
| Circle | Space Groups -> Spaces | 2 levels |
|
|
100
|
+
|
|
101
|
+
### Tagging Approaches
|
|
102
|
+
|
|
103
|
+
| Approach | Description | Best For |
|
|
104
|
+
|----------|-------------|----------|
|
|
105
|
+
| Free folksonomy | Users create any tags | Early-stage communities |
|
|
106
|
+
| Controlled vocabulary | Moderators curate tag list | Knowledge bases (SO: 65,000+ tags) |
|
|
107
|
+
| Hierarchical tags | Parent-child relationships | Complex domains |
|
|
108
|
+
| Auto-tagging (AI) | AI suggests/applies tags | Scale + consistency |
|
|
109
|
+
| Required tags | Posts must include tags from set | Quality control |
|
|
110
|
+
|
|
111
|
+
### Search Architecture
|
|
112
|
+
|
|
113
|
+
Modern community search uses **hybrid retrieval**:
|
|
114
|
+
|
|
115
|
+
1. **BM25** (keyword matching) -- Elasticsearch, Typesense, Meilisearch
|
|
116
|
+
2. **Dense vector** (semantic) -- embeddings + RAG
|
|
117
|
+
3. **Re-ranking** by community signals: votes, author reputation, recency
|
|
118
|
+
4. **Faceted filtering** -- date, author, tags, vote count
|
|
119
|
+
5. **Duplicate detection** -- critical for Q&A platforms
|
|
120
|
+
|
|
121
|
+
### Knowledge Persistence Models
|
|
122
|
+
|
|
123
|
+
| Model | Description | Platform |
|
|
124
|
+
|-------|-------------|----------|
|
|
125
|
+
| Ephemeral | Content decays, timeline-driven | Discord chat, Reddit feed |
|
|
126
|
+
| Wiki-persistent | Community-edited canonical content | SO answers, Discourse wikis |
|
|
127
|
+
| Article-persistent | Long-form authored content | DEV.to, Indie Hackers |
|
|
128
|
+
| Hybrid | Discussions graduate to knowledge base | Discourse topic -> wiki conversion |
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 3. Thread Engine & Ranking Algorithms
|
|
133
|
+
|
|
134
|
+
### Threading Architectures
|
|
135
|
+
|
|
136
|
+
| Model | Platform | Tradeoffs |
|
|
137
|
+
|-------|----------|-----------|
|
|
138
|
+
| Flat/Chronological | Discord, Slack | Simple, real-time; loses depth |
|
|
139
|
+
| Nested/Tree | Reddit | Deep discussions; gets unwieldy at depth |
|
|
140
|
+
| Flat + Best Sort | Stack Overflow | Surfaces best answers; loses conversation flow |
|
|
141
|
+
| Threaded-in-channels | Discord threads, Slack threads | Preserves chat and depth |
|
|
142
|
+
| Topic-based sequential | Discourse | Good for deliberation; slower pace |
|
|
143
|
+
|
|
144
|
+
### Ranking Formulas
|
|
145
|
+
|
|
146
|
+
#### Reddit Hot Algorithm
|
|
147
|
+
|
|
148
|
+
```
|
|
149
|
+
hot_score = log10(max(|score|, 1)) * sign(score) + (timestamp / 45000)
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
- **score** = upvotes - downvotes
|
|
153
|
+
- **timestamp** = seconds since Reddit epoch (Dec 8, 2005)
|
|
154
|
+
|
|
155
|
+
| Property | Implication |
|
|
156
|
+
|----------|------------|
|
|
157
|
+
| Logarithmic vote scaling | 1->10 votes = same boost as 10->100 or 100->1000 |
|
|
158
|
+
| Time never decreases | Newer posts start with higher time baseline |
|
|
159
|
+
| 12.5-hour half-life | Every 12.5h of age costs equivalent of 10x vote increase |
|
|
160
|
+
| Sign handling | Negative-score posts get negative ranking |
|
|
161
|
+
|
|
162
|
+
#### Hacker News Gravity Algorithm
|
|
163
|
+
|
|
164
|
+
```
|
|
165
|
+
score = (P - 1) / (T + 2)^G
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
- **P** = points, **T** = hours since submission, **G** = gravity (default 1.8)
|
|
169
|
+
|
|
170
|
+
| Property | Implication |
|
|
171
|
+
|----------|------------|
|
|
172
|
+
| Active decay | Scores decrease over time (unlike Reddit) |
|
|
173
|
+
| Tunable gravity | Higher G = faster decay; adjustable per community |
|
|
174
|
+
| Penalty system | ~20% of front-page stories receive penalties |
|
|
175
|
+
|
|
176
|
+
#### Wilson Score Interval (Reddit Best / Stack Overflow)
|
|
177
|
+
|
|
178
|
+
```
|
|
179
|
+
lower_bound = (p + z^2/(2n) - z * sqrt((p*(1-p) + z^2/(4n)) / n)) / (1 + z^2/n)
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
- **p** = observed proportion of upvotes
|
|
183
|
+
- **n** = total votes
|
|
184
|
+
- **z** = 1.96 for 95% confidence
|
|
185
|
+
|
|
186
|
+
| Property | Implication |
|
|
187
|
+
|----------|------------|
|
|
188
|
+
| Small sample correction | 5 up / 0 down can outrank 100 up / 40 down |
|
|
189
|
+
| Confidence-based | Ranks by lower bound of true approval rate |
|
|
190
|
+
| Self-correcting | More votes -> narrower interval -> stable ranking |
|
|
191
|
+
|
|
192
|
+
Source: Evan Miller, "How Not To Sort By Average Rating" (2009)
|
|
193
|
+
|
|
194
|
+
#### Reddit Controversial
|
|
195
|
+
|
|
196
|
+
```
|
|
197
|
+
controversial = min(ups, downs) / max(ups, downs) * (ups + downs)
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Surfaces posts with high engagement AND balanced up/down ratios.
|
|
201
|
+
|
|
202
|
+
### Quality Signals Beyond Votes
|
|
203
|
+
|
|
204
|
+
| Signal | Weight | Platform |
|
|
205
|
+
|--------|--------|----------|
|
|
206
|
+
| Vote score | Primary | Reddit, SO, Discourse |
|
|
207
|
+
| Author reputation | Secondary | Stack Overflow |
|
|
208
|
+
| Time on page / read depth | Growing | Discourse |
|
|
209
|
+
| Accepted answer | Binary boost | Stack Overflow |
|
|
210
|
+
| Edit history | Trust signal | Discourse |
|
|
211
|
+
| Report/flag ratio | Negative signal | All platforms |
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## 4. Trust, Moderation & Governance
|
|
216
|
+
|
|
217
|
+
### Discourse Trust Levels (5-Tier)
|
|
218
|
+
|
|
219
|
+
| Level | Name | How Earned | Key Privileges |
|
|
220
|
+
|-------|------|-----------|----------------|
|
|
221
|
+
| TL0 | New | Default | Post in most categories; limited actions |
|
|
222
|
+
| TL1 | Basic | Read topics, spend time | Send PMs, flag posts, all core features |
|
|
223
|
+
| TL2 | Member | Active participation (weeks) | Invite users, group PMs, wiki posts |
|
|
224
|
+
| TL3 | Regular | Sustained quality (months) | Recategorize, rename, wiki-edit; flags auto-hide TL0 spam |
|
|
225
|
+
| TL4 | Leader | Manually granted by admins | Full moderation powers |
|
|
226
|
+
|
|
227
|
+
**Key design decisions:**
|
|
228
|
+
- TL3 is auto-granted AND auto-revoked (must maintain activity)
|
|
229
|
+
- Multiple TL3 flags can auto-silence spammers
|
|
230
|
+
- First 50 users in bootstrap mode get TL1 automatically
|
|
231
|
+
- Users receive congratulatory PMs on level-up
|
|
232
|
+
- 2023-2025: migrating 30+ settings from trust-level to group-based permissions
|
|
233
|
+
|
|
234
|
+
### Stack Overflow Privilege Ladder
|
|
235
|
+
|
|
236
|
+
| Reputation | Privilege | Rationale |
|
|
237
|
+
|------------|-----------|-----------|
|
|
238
|
+
| 1 | Create posts | Anyone can ask/answer |
|
|
239
|
+
| 15 | Upvote | Proven participant |
|
|
240
|
+
| 50 | Comment anywhere | Reduce noise from drive-by comments |
|
|
241
|
+
| 125 | Downvote (costs 1 rep) | Skin in the game |
|
|
242
|
+
| 500 | Review queues | Experienced curation |
|
|
243
|
+
| 2,000 | Edit any post | Trusted to improve content |
|
|
244
|
+
| 3,000 | Close/reopen votes | Shape acceptable questions |
|
|
245
|
+
| 10,000 | Moderation tools, delete votes | Analytics + cleanup |
|
|
246
|
+
| 15,000 | Protect questions | Shield popular posts |
|
|
247
|
+
| 20,000 | Delete negatively-scored answers | Final cleanup authority |
|
|
248
|
+
|
|
249
|
+
Philosophy (Jeff Atwood, 2009): "Moderators are human exception handlers -- the community handles 95%+ of moderation through distributed reputation-based actions."
|
|
250
|
+
|
|
251
|
+
### AI Content Moderation Stack (2025-2026)
|
|
252
|
+
|
|
253
|
+
| Layer | Technology | Latency | Accuracy |
|
|
254
|
+
|-------|-----------|---------|----------|
|
|
255
|
+
| Pre-publish filters | Keyword matching, regex | <10ms | High precision, low recall |
|
|
256
|
+
| Real-time AI classification | LLM toxicity detection | 50-500ms | 85-95% |
|
|
257
|
+
| Post-publish AI review | Batch flagged content | Minutes | Higher with context |
|
|
258
|
+
| Human review | Trained moderators | Hours | Highest, expensive |
|
|
259
|
+
| Community flags | User reporting + thresholds | Variable | Catches context-dependent issues |
|
|
260
|
+
|
|
261
|
+
Content moderation market: $11.63-12.48B (2025) -> projected $23.2-26.1B by 2030 (CAGR ~14.5%).
|
|
262
|
+
|
|
263
|
+
### Governance Models
|
|
264
|
+
|
|
265
|
+
| Model | Example |
|
|
266
|
+
|-------|---------|
|
|
267
|
+
| Benevolent dictatorship | Early-stage communities |
|
|
268
|
+
| Reputation-weighted democracy | Stack Overflow |
|
|
269
|
+
| Elected moderators | Reddit (some subreddits) |
|
|
270
|
+
| Automated governance | Discourse TL system |
|
|
271
|
+
| Constitution-based | Wikipedia, Discourse guidelines |
|
|
272
|
+
|
|
273
|
+
### Appeal Best Practices (UNESCO 2025)
|
|
274
|
+
|
|
275
|
+
- Transparent policies with clear examples
|
|
276
|
+
- Human-readable explanations for every moderation action
|
|
277
|
+
- Streamlined appeal processes with defined timelines
|
|
278
|
+
- Independent oversight for contested decisions
|
|
279
|
+
- Regular transparency reports
|
|
280
|
+
|
|
281
|
+
---
|
|
282
|
+
|
|
283
|
+
## 5. Gamification & Identity
|
|
284
|
+
|
|
285
|
+
### Nir Eyal's Hook Model (Applied to Communities)
|
|
286
|
+
|
|
287
|
+
| Phase | Mechanism | Examples |
|
|
288
|
+
|-------|-----------|---------|
|
|
289
|
+
| **1. Trigger** | External: notifications, digests. Internal: boredom, uncertainty, social need | "Someone replied to your post" email |
|
|
290
|
+
| **2. Action** | Behavior in anticipation of reward | Scroll feed, answer question, check messages |
|
|
291
|
+
| **3. Variable Reward** | Three types below | Unpredictable positive reinforcement |
|
|
292
|
+
| **4. Investment** | User puts something in that improves next use | Write answers, build reputation, customize profile |
|
|
293
|
+
|
|
294
|
+
**Variable reward types:**
|
|
295
|
+
|
|
296
|
+
| Type | Mechanism | Platform Example |
|
|
297
|
+
|------|-----------|-----------------|
|
|
298
|
+
| Rewards of the Tribe | Social validation | Upvotes, karma, being thanked |
|
|
299
|
+
| Rewards of the Hunt | Information seeking | Finding the answer, discovering content |
|
|
300
|
+
| Rewards of the Self | Mastery, completion | Badges, reputation milestones, streaks |
|
|
301
|
+
|
|
302
|
+
**Critical insight:** The investment phase creates stored value that makes leaving costly (switching cost).
|
|
303
|
+
|
|
304
|
+
### Amy Jo Kim's Core Loop
|
|
305
|
+
|
|
306
|
+
The repeatable, pleasurable activity driving long-term engagement:
|
|
307
|
+
|
|
308
|
+
| Platform | Core Loop |
|
|
309
|
+
|----------|-----------|
|
|
310
|
+
| Reddit | Browse -> React (vote/comment) -> Get validation -> Browse more |
|
|
311
|
+
| Stack Overflow | See question -> Answer -> Get upvotes/accepted -> Seek harder questions |
|
|
312
|
+
| Discord | Check server -> Participate -> Build relationships -> Return |
|
|
313
|
+
| Discourse | Read topic -> Reply thoughtfully -> Earn trust level -> Gain privileges -> Moderate |
|
|
314
|
+
|
|
315
|
+
> "The smartest MVP is built around your Core Learning Loop -- your Day 21 experience." -- Amy Jo Kim
|
|
316
|
+
|
|
317
|
+
### Stack Overflow Gamification Architecture
|
|
318
|
+
|
|
319
|
+
**Points (Reputation):**
|
|
320
|
+
|
|
321
|
+
| Action | Points |
|
|
322
|
+
|--------|--------|
|
|
323
|
+
| Answer upvote | +10 |
|
|
324
|
+
| Question upvote | +5 |
|
|
325
|
+
| Accepted answer | +15 |
|
|
326
|
+
| Approved edit | +2 |
|
|
327
|
+
| Downvoting an answer | -2 (costs the downvoter) |
|
|
328
|
+
| Daily cap from votes | 200 |
|
|
329
|
+
|
|
330
|
+
**Badges (95 total, 3 tiers):**
|
|
331
|
+
|
|
332
|
+
| Tier | Count | Design | Example |
|
|
333
|
+
|------|-------|--------|---------|
|
|
334
|
+
| Bronze | 30 | Easy, introduce features | "Autobiographer" (complete profile) |
|
|
335
|
+
| Silver | 35 | Sustained effort | "Civic Duty" (300 votes) |
|
|
336
|
+
| Gold | 30 | Exceptional contribution | "Legendary" (200 rep from 150+ days) |
|
|
337
|
+
|
|
338
|
+
**Design principle:** Every badge encourages behavior that helps the community. Custom badges launched Feb 2026.
|
|
339
|
+
|
|
340
|
+
### Reddit Karma System
|
|
341
|
+
|
|
342
|
+
- Post and comment karma tracked separately
|
|
343
|
+
- Karma has NO privileges (pure social signal, unlike SO)
|
|
344
|
+
- Awards relaunched Sep 2025 with gold as currency (coins removed Jul 2023, Golden Upvotes failed)
|
|
345
|
+
- Subreddit-specific karma requirements configurable per community
|
|
346
|
+
|
|
347
|
+
### Identity Signaling
|
|
348
|
+
|
|
349
|
+
| Signal | Platform | Function |
|
|
350
|
+
|--------|----------|----------|
|
|
351
|
+
| Reputation number | Stack Overflow | Competence |
|
|
352
|
+
| Karma score | Reddit | Participation |
|
|
353
|
+
| Trust level badge | Discourse | Trust |
|
|
354
|
+
| Custom roles/colors | Discord | Status/belonging |
|
|
355
|
+
| Flair | Reddit | Identity expression |
|
|
356
|
+
| Verified badges | Circle, Mighty Networks | Authenticity |
|
|
357
|
+
|
|
358
|
+
---
|
|
359
|
+
|
|
360
|
+
## 6. Growth Loops & Virality
|
|
361
|
+
|
|
362
|
+
### K-Factor (Viral Coefficient)
|
|
363
|
+
|
|
364
|
+
```
|
|
365
|
+
K = i * c
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
- **i** = invitations each user sends
|
|
369
|
+
- **c** = conversion rate per invitation
|
|
370
|
+
- **K > 1** = exponential growth
|
|
371
|
+
- **K < 1** = needs external acquisition
|
|
372
|
+
|
|
373
|
+
**Example:** 100 users, i=3, c=0.6 -> K=1.8 -> 100 -> 180 -> 324 -> 583 (exponential)
|
|
374
|
+
|
|
375
|
+
**Reality:** Pure viral growth (K > 1) is extremely rare and typically unsustainable. Combine viral loops with other channels.
|
|
376
|
+
|
|
377
|
+
### Growth Loop Types
|
|
378
|
+
|
|
379
|
+
#### 1. Content-SEO Loop (Most Powerful for Knowledge Communities)
|
|
380
|
+
|
|
381
|
+
```
|
|
382
|
+
User creates content -> Google indexes -> Search user finds content ->
|
|
383
|
+
New user joins -> Creates content -> [repeat]
|
|
384
|
+
```
|
|
385
|
+
|
|
386
|
+
- Reddit SEO visibility surged ~1,328% (Jul 2023 - Apr 2024), partially corrected early 2025
|
|
387
|
+
- Google-Reddit $60M/year data partnership for AI Overviews
|
|
388
|
+
- Stack Overflow dominates programming search via this loop
|
|
389
|
+
- Google prioritizes "first-hand perspective" from forums
|
|
390
|
+
|
|
391
|
+
#### 2. Invite/Referral Loop
|
|
392
|
+
|
|
393
|
+
```
|
|
394
|
+
User enjoys community -> Invites friends -> Friends join ->
|
|
395
|
+
Community more valuable -> [repeat]
|
|
396
|
+
```
|
|
397
|
+
|
|
398
|
+
Referral programs: 10-30% conversion (up to 50%)
|
|
399
|
+
|
|
400
|
+
#### 3. Creator-Audience Loop
|
|
401
|
+
|
|
402
|
+
```
|
|
403
|
+
Creator builds community -> Promotes to audience -> Audience joins ->
|
|
404
|
+
Members create content -> Attracts new members -> [repeat]
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
#### 4. Cross-Platform Distribution Loop
|
|
408
|
+
|
|
409
|
+
```
|
|
410
|
+
Content created -> Shared on Twitter/LinkedIn -> External users arrive ->
|
|
411
|
+
Convert to members -> Create content -> [repeat]
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
#### 5. Embed/Widget Loop
|
|
415
|
+
|
|
416
|
+
```
|
|
417
|
+
Platform provides widgets -> Sites embed community content ->
|
|
418
|
+
Users discover via embeds -> Join -> [repeat]
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
### SEO as Growth Engine
|
|
422
|
+
|
|
423
|
+
| Strategy | Description | Impact |
|
|
424
|
+
|----------|-------------|--------|
|
|
425
|
+
| Long-tail UGC | User content targets long-tail keywords | High volume, low competition |
|
|
426
|
+
| Canonical Q&A pages | SO-style question pages | High intent traffic |
|
|
427
|
+
| DiscussionForumPosting schema | Structured data markup | Rich results, +30-40% CTR |
|
|
428
|
+
| Internal linking | Related topics create crawl depth | Better indexation |
|
|
429
|
+
| Fresh content signals | Active discussions signal freshness | Ranking boost |
|
|
430
|
+
| Author authority (E-E-A-T) | Community expert signals | Quality signal |
|
|
431
|
+
|
|
432
|
+
**2025-2026 caveat:** "Forum content recalibration" underway. Generic forums losing visibility. Communities need structured, quality content. 73% of B2B websites saw significant organic traffic losses (avg 34% YoY decline).
|
|
433
|
+
|
|
434
|
+
### Retention Benchmarks
|
|
435
|
+
|
|
436
|
+
| Metric | Benchmark |
|
|
437
|
+
|--------|-----------|
|
|
438
|
+
| D1 retention | 40-60% |
|
|
439
|
+
| D7 retention | 20-35% |
|
|
440
|
+
| D30 retention | 10-20% |
|
|
441
|
+
| 90-day retention | 5-15% |
|
|
442
|
+
|
|
443
|
+
Andrew Chen: "The best way to drive viral growth is to increase retention and engagement."
|
|
444
|
+
|
|
445
|
+
---
|
|
446
|
+
|
|
447
|
+
## 7. Monetization Stack
|
|
448
|
+
|
|
449
|
+
### Creator Economy Scale
|
|
450
|
+
|
|
451
|
+
- Market size: $200-254B (2025), projected $314B (2026), $480B (2027, Goldman Sachs)
|
|
452
|
+
- 88% of creators utilize paid memberships
|
|
453
|
+
- 32.9% of communities charge $26-$50/month (sweet spot)
|
|
454
|
+
|
|
455
|
+
### Five Revenue Models (2026)
|
|
456
|
+
|
|
457
|
+
#### 1. Paid Communities / Memberships
|
|
458
|
+
|
|
459
|
+
| Platform | Pricing | Transaction Fee |
|
|
460
|
+
|----------|---------|----------------|
|
|
461
|
+
| Circle | From $89/mo (annual) | 0.5-2% |
|
|
462
|
+
| Mighty Networks | From $49/mo (annual) | 1-2% |
|
|
463
|
+
| Skool | $9/mo Hobby, $99/mo Pro | 10% (Hobby), 2.9% (Pro) |
|
|
464
|
+
| Discord (premium roles) | Free platform | None (Stripe) |
|
|
465
|
+
|
|
466
|
+
Average Mighty Networks member pays $48/month.
|
|
467
|
+
|
|
468
|
+
#### 2. Paid Challenges / Cohort Programs
|
|
469
|
+
|
|
470
|
+
- Typical pricing: $97-$497 per challenge
|
|
471
|
+
- 30-day format most common
|
|
472
|
+
- 15-30% conversion to ongoing membership
|
|
473
|
+
|
|
474
|
+
#### 3. AI Agent Monetization (Emerging)
|
|
475
|
+
|
|
476
|
+
- $9-$49/month for access
|
|
477
|
+
- Delivered via WhatsApp, Instagram, or platform-native
|
|
478
|
+
- Scalable: one creator's knowledge serves unlimited members
|
|
479
|
+
|
|
480
|
+
#### 4. Courses & Digital Products
|
|
481
|
+
|
|
482
|
+
| Platform | Course Features | Price Range |
|
|
483
|
+
|----------|----------------|-------------|
|
|
484
|
+
| Circle | Modular with video/audio/text | $49-$999 |
|
|
485
|
+
| Mighty Networks | Courses + community bundles | $39-$299 |
|
|
486
|
+
| Skool | Integrated with community | $29-$297 |
|
|
487
|
+
|
|
488
|
+
#### 5. Events & Live Experiences
|
|
489
|
+
|
|
490
|
+
- Free events for acquisition, paid for monetization
|
|
491
|
+
- Workshops, masterminds, AMAs
|
|
492
|
+
|
|
493
|
+
### Platform Revenue Models
|
|
494
|
+
|
|
495
|
+
| Platform | Primary Revenue | Scale |
|
|
496
|
+
|----------|----------------|-------|
|
|
497
|
+
| Reddit | Advertising + Premium | $2.2B FY2025 (+69% YoY) |
|
|
498
|
+
| Discord | Nitro subscriptions | Server boosts, app store |
|
|
499
|
+
| Stack Overflow | Teams (enterprise) + Ads | Job board discontinued Mar 2022 |
|
|
500
|
+
| Discourse | Hosting plans | Enterprise support |
|
|
501
|
+
| Circle | SaaS fees + transaction fees | 17,000+ creators |
|
|
502
|
+
| Mighty Networks | SaaS fees + transaction fees | Network-as-product model |
|
|
503
|
+
|
|
504
|
+
### Pricing Strategy
|
|
505
|
+
|
|
506
|
+
| Price Point | Positioning | Notes |
|
|
507
|
+
|-------------|-------------|-------|
|
|
508
|
+
| Free | Acquisition/lead gen | Highest entry, lowest engagement |
|
|
509
|
+
| $9-$25/mo | Accessible, impulse | Good for large audiences |
|
|
510
|
+
| $26-$50/mo | Sweet spot (32.9%) | Balanced value/commitment |
|
|
511
|
+
| $51-$100/mo | Premium | Requires clear premium value |
|
|
512
|
+
| $100+/mo | Professional/enterprise | B2B or high-value niche |
|
|
513
|
+
|
|
514
|
+
### Risks
|
|
515
|
+
|
|
516
|
+
- Paywalls reducing network effects
|
|
517
|
+
- Creator dependency (community collapses when creator leaves)
|
|
518
|
+
- Monthly subscription fatigue (avg churn: 5-10%/month)
|
|
519
|
+
- Platform lock-in (no data portability)
|
|
520
|
+
|
|
521
|
+
---
|
|
522
|
+
|
|
523
|
+
## 8. SEO Engine & Frontend
|
|
524
|
+
|
|
525
|
+
### Rendering Strategy Decision Matrix
|
|
526
|
+
|
|
527
|
+
| Strategy | SEO Impact | Use When | Example |
|
|
528
|
+
|----------|-----------|----------|---------|
|
|
529
|
+
| SSR | Excellent | Public pages, search-critical | Discourse, Reddit |
|
|
530
|
+
| CSR | Poor | Authenticated-only, app-like | Discord web app |
|
|
531
|
+
| ISR | Excellent | High-volume content, pre-built | DEV.to articles |
|
|
532
|
+
| Hybrid | Optimal | Mix of public and private | Stack Overflow, Circle |
|
|
533
|
+
|
|
534
|
+
**Rule:** Every public community page for search results MUST be server-rendered or pre-rendered.
|
|
535
|
+
|
|
536
|
+
### Core Web Vitals Targets
|
|
537
|
+
|
|
538
|
+
| Metric | Target | Community Challenge |
|
|
539
|
+
|--------|--------|-------------------|
|
|
540
|
+
| LCP | < 2.5s | Large thread pages with images/embeds |
|
|
541
|
+
| INP | < 200ms | Complex vote/reply interactions |
|
|
542
|
+
| CLS | < 0.1 | Dynamic content loading, lazy images, ads |
|
|
543
|
+
|
|
544
|
+
Common issues: infinite scroll CLS, late-loading avatars, rich embeds causing layout shifts, heavy JS degrading INP.
|
|
545
|
+
|
|
546
|
+
### Semantic HTML Structure
|
|
547
|
+
|
|
548
|
+
Key elements for forum pages:
|
|
549
|
+
|
|
550
|
+
| Element | Use | SEO Impact |
|
|
551
|
+
|---------|-----|-----------|
|
|
552
|
+
| `<article>` | Individual posts/threads | Content boundary signal |
|
|
553
|
+
| `<header>` | Thread metadata | Structured content signal |
|
|
554
|
+
| `<time datetime="">` | Timestamps | Freshness signal |
|
|
555
|
+
| `<nav>` | Breadcrumbs, pagination | Crawl path signal |
|
|
556
|
+
| `<section>` | Reply sections | Content grouping |
|
|
557
|
+
|
|
558
|
+
### JSON-LD Structured Data
|
|
559
|
+
|
|
560
|
+
Primary schema: **DiscussionForumPosting**
|
|
561
|
+
|
|
562
|
+
```json
|
|
563
|
+
{
|
|
564
|
+
"@context": "https://schema.org",
|
|
565
|
+
"@type": "DiscussionForumPosting",
|
|
566
|
+
"headline": "Thread Title",
|
|
567
|
+
"author": { "@type": "Person", "name": "username", "url": "..." },
|
|
568
|
+
"datePublished": "2026-04-06T10:00:00+00:00",
|
|
569
|
+
"url": "https://forum.example.com/t/topic/12345",
|
|
570
|
+
"interactionStatistic": {
|
|
571
|
+
"@type": "InteractionCounter",
|
|
572
|
+
"interactionType": "https://schema.org/CommentAction",
|
|
573
|
+
"userInteractionCount": 15
|
|
574
|
+
},
|
|
575
|
+
"comment": [
|
|
576
|
+
{
|
|
577
|
+
"@type": "Comment",
|
|
578
|
+
"author": { "@type": "Person", "name": "replier" },
|
|
579
|
+
"datePublished": "2026-04-06T11:30:00+00:00",
|
|
580
|
+
"text": "Reply content..."
|
|
581
|
+
}
|
|
582
|
+
]
|
|
583
|
+
}
|
|
584
|
+
```
|
|
585
|
+
|
|
586
|
+
**CTR impact:** Pages with Rich Snippets see +30-40% CTR vs. standard results.
|
|
587
|
+
|
|
588
|
+
### Additional Schema Types
|
|
589
|
+
|
|
590
|
+
| Schema | Use Case |
|
|
591
|
+
|--------|----------|
|
|
592
|
+
| DiscussionForumPosting | Forum threads |
|
|
593
|
+
| QAPage | Q&A pages (SO model) |
|
|
594
|
+
| Comment | Replies |
|
|
595
|
+
| ProfilePage | User profiles |
|
|
596
|
+
| BreadcrumbList | Category navigation |
|
|
597
|
+
| WebSite + SearchAction | Site search in SERPs |
|
|
598
|
+
| Course | Course-based communities |
|
|
599
|
+
|
|
600
|
+
### Accessibility (WCAG 2.1 AA)
|
|
601
|
+
|
|
602
|
+
| Feature | Implementation |
|
|
603
|
+
|---------|---------------|
|
|
604
|
+
| Keyboard navigation | Tab order for threads, replies, actions |
|
|
605
|
+
| Screen reader | ARIA labels for vote buttons, actions |
|
|
606
|
+
| Color contrast | 4.5:1 minimum for text |
|
|
607
|
+
| Focus indicators | Visible focus rings on all interactive elements |
|
|
608
|
+
| Alt text | Prompts for user-uploaded images |
|
|
609
|
+
| Live regions | aria-live for real-time updates |
|
|
610
|
+
|
|
611
|
+
---
|
|
612
|
+
|
|
613
|
+
## 9. Platform Comparative Matrix
|
|
614
|
+
|
|
615
|
+
| Feature | Reddit | Discord | Stack Overflow | Discourse | Circle | Mighty Networks | Skool |
|
|
616
|
+
|---------|--------|---------|----------------|-----------|--------|----------------|-------|
|
|
617
|
+
| Threading | Nested tree | Flat + threads | Flat best-sorted | Sequential | Flat | Flat | Flat |
|
|
618
|
+
| Ranking | Hot/Best/New | Chronological | Votes + accepted | Latest/votes | Chronological | Activity | Latest |
|
|
619
|
+
| Reputation | Karma (no perks) | Roles (manual) | Points -> privileges | Trust levels (auto) | Points | Points | Gamification |
|
|
620
|
+
| Moderation | Mods + AutoMod | Roles + bots | Rep-based + mods | Trust levels + mods | Admin | Admin | Admin |
|
|
621
|
+
| Open Source | No | No | No | Yes (GPL) | No | No | No |
|
|
622
|
+
| SEO | Excellent | Poor | Excellent | Excellent | Growing | Moderate | Moderate |
|
|
623
|
+
| Real-time | Limited | Excellent | No | Optional | Chat | Limited | No |
|
|
624
|
+
| Monetization | Ads ($2.2B) | Nitro | Teams (B2B) | Hosting | SaaS + fees | SaaS + fees | SaaS + fees |
|
|
625
|
+
|
|
626
|
+
### Best-Fit Guide
|
|
627
|
+
|
|
628
|
+
| Use Case | Best Platform |
|
|
629
|
+
|----------|--------------|
|
|
630
|
+
| Developer knowledge base | Stack Overflow / Discourse |
|
|
631
|
+
| Real-time community | Discord |
|
|
632
|
+
| Creator monetization | Circle / Mighty Networks / Skool |
|
|
633
|
+
| Open-source project | Discourse |
|
|
634
|
+
| News/content aggregation | Reddit model |
|
|
635
|
+
| Niche professional community | Circle / Discourse |
|
|
636
|
+
| Course-based community | Mighty Networks / Circle / Skool |
|
|
637
|
+
|
|
638
|
+
---
|
|
639
|
+
|
|
640
|
+
## 10. Implementation Checklists
|
|
641
|
+
|
|
642
|
+
### Social Graph Engine
|
|
643
|
+
|
|
644
|
+
- [ ] Define graph model (bipartite, tripartite, hierarchical)
|
|
645
|
+
- [ ] Implement user-to-community membership relationships
|
|
646
|
+
- [ ] Design sub-community / group creation mechanics
|
|
647
|
+
- [ ] Build recommendation engine for community discovery
|
|
648
|
+
- [ ] Implement cross-community bridging features
|
|
649
|
+
- [ ] Monitor network health (clustering coefficient, degree distribution)
|
|
650
|
+
- [ ] Design cold-start strategy
|
|
651
|
+
|
|
652
|
+
### Information Architecture
|
|
653
|
+
|
|
654
|
+
- [ ] Design taxonomy (categories, subcategories)
|
|
655
|
+
- [ ] Implement tagging system (controlled vocabulary vs. folksonomy)
|
|
656
|
+
- [ ] Build full-text search (Elasticsearch/Typesense/Meilisearch)
|
|
657
|
+
- [ ] Add semantic search (vector embeddings)
|
|
658
|
+
- [ ] Implement duplicate detection
|
|
659
|
+
- [ ] Design knowledge persistence model
|
|
660
|
+
- [ ] Create tag management interface
|
|
661
|
+
|
|
662
|
+
### Thread Engine
|
|
663
|
+
|
|
664
|
+
- [ ] Choose threading model (flat, nested, sequential)
|
|
665
|
+
- [ ] Implement Hot/Best/New/Controversial sorting
|
|
666
|
+
- [ ] Implement Wilson score for comment ranking
|
|
667
|
+
- [ ] Design vote system (upvote/downvote, reactions, or both)
|
|
668
|
+
- [ ] Build quality scoring (votes + author rep + read time)
|
|
669
|
+
- [ ] Implement configurable time-decay
|
|
670
|
+
- [ ] Add anti-manipulation measures
|
|
671
|
+
|
|
672
|
+
### Trust & Moderation
|
|
673
|
+
|
|
674
|
+
- [ ] Design trust level system (Discourse-style automated progression)
|
|
675
|
+
- [ ] Map reputation thresholds to moderation privileges
|
|
676
|
+
- [ ] Implement pre-publish content filters
|
|
677
|
+
- [ ] Integrate AI content moderation (toxicity, spam, NSFW)
|
|
678
|
+
- [ ] Build human moderation queue with priority triage
|
|
679
|
+
- [ ] Design appeal system with clear timelines
|
|
680
|
+
- [ ] Create transparent community guidelines
|
|
681
|
+
- [ ] Implement audit logging for moderation actions
|
|
682
|
+
|
|
683
|
+
### Gamification & Identity
|
|
684
|
+
|
|
685
|
+
- [ ] Design point/reputation system with clear earning rules
|
|
686
|
+
- [ ] Create badge system aligned with desired behaviors
|
|
687
|
+
- [ ] Implement time-scoped leaderboards
|
|
688
|
+
- [ ] Design identity signaling (flair, roles, badges)
|
|
689
|
+
- [ ] Build progressive privilege unlocking
|
|
690
|
+
- [ ] Add streak/consistency rewards
|
|
691
|
+
- [ ] Monitor for reputation gaming
|
|
692
|
+
|
|
693
|
+
### Growth Loops
|
|
694
|
+
|
|
695
|
+
- [ ] Implement Content-SEO loop (indexable UGC)
|
|
696
|
+
- [ ] Build invite/referral system with tracking
|
|
697
|
+
- [ ] Design onboarding for quick activation
|
|
698
|
+
- [ ] Implement email digest re-engagement
|
|
699
|
+
- [ ] Build social sharing with OG tags
|
|
700
|
+
- [ ] Monitor K-factor and retention cohorts
|
|
701
|
+
- [ ] Optimize for "aha moment" in first session
|
|
702
|
+
|
|
703
|
+
### Monetization
|
|
704
|
+
|
|
705
|
+
- [ ] Integrate payment processor (Stripe)
|
|
706
|
+
- [ ] Build subscription/membership gating
|
|
707
|
+
- [ ] Implement tiered access (free/paid/premium)
|
|
708
|
+
- [ ] Design course/content monetization
|
|
709
|
+
- [ ] Build creator payout system
|
|
710
|
+
- [ ] Implement trial/freemium conversion flow
|
|
711
|
+
- [ ] Add analytics for MRR, churn, LTV
|
|
712
|
+
|
|
713
|
+
### SEO & Frontend
|
|
714
|
+
|
|
715
|
+
- [ ] Implement SSR for all public pages
|
|
716
|
+
- [ ] Add DiscussionForumPosting JSON-LD
|
|
717
|
+
- [ ] Optimize Core Web Vitals (LCP < 2.5s, INP < 200ms, CLS < 0.1)
|
|
718
|
+
- [ ] Implement semantic HTML (article, header, time, nav)
|
|
719
|
+
- [ ] Generate XML sitemaps for public content
|
|
720
|
+
- [ ] Set canonical URLs for paginated/duplicate content
|
|
721
|
+
- [ ] Configure robots.txt (block admin/search/login)
|
|
722
|
+
- [ ] Add BreadcrumbList schema
|
|
723
|
+
- [ ] Ensure WCAG 2.1 AA compliance
|
|
724
|
+
- [ ] Add OG tags and Twitter Cards
|
|
725
|
+
- [ ] Return 410 for deleted content
|
|
726
|
+
- [ ] Test with Rich Results Test and Lighthouse
|
|
727
|
+
|
|
728
|
+
---
|
|
729
|
+
|
|
730
|
+
## 11. Key References
|
|
731
|
+
|
|
732
|
+
### Foundational Books
|
|
733
|
+
|
|
734
|
+
| Book | Author | Year | Topic |
|
|
735
|
+
|------|--------|------|-------|
|
|
736
|
+
| *Linked* | Barabasi | 2002 | Scale-free networks |
|
|
737
|
+
| *Hooked* | Nir Eyal | 2014 | Hook Model, habit formation |
|
|
738
|
+
| *The Art of Community* | Jono Bacon | 2009 | Community management |
|
|
739
|
+
| *Community Building on the Web* | Amy Jo Kim | 2000 | Social architecture |
|
|
740
|
+
| *Game Thinking* | Amy Jo Kim | 2018 | Core loops, engagement |
|
|
741
|
+
| *The Cold Start Problem* | Andrew Chen | 2021 | Network effects, growth |
|
|
742
|
+
| *The Accidental Taxonomist* | Heather Hedden | 2010 | Taxonomy design |
|
|
743
|
+
| *Buzzing Communities* | Richard Millington | 2012 | Community strategy |
|
|
744
|
+
| *Actionable Gamification* | Yu-kai Chou | 2015 | Octalysis framework |
|
|
745
|
+
|
|
746
|
+
### Seminal Papers & Articles
|
|
747
|
+
|
|
748
|
+
| Paper | Author | Year | Contribution |
|
|
749
|
+
|-------|--------|------|-------------|
|
|
750
|
+
| "The Strength of Weak Ties" | Granovetter | 1973 | Bridging social capital |
|
|
751
|
+
| "Emergence of Scaling in Random Networks" | Barabasi & Albert | 1999 | Scale-free network model |
|
|
752
|
+
| "How Not To Sort By Average Rating" | Evan Miller | 2009 | Wilson score for ranking |
|
|
753
|
+
| "A Theory of Moderation" | Jeff Atwood | 2009 | Moderation philosophy |
|
|
754
|
+
| "Deriving the Reddit Formula" | Evan Miller | 2009 | Reddit Hot algorithm analysis |
|
|
755
|
+
|
|
756
|
+
### Key People
|
|
757
|
+
|
|
758
|
+
| Person | Contribution |
|
|
759
|
+
|--------|-------------|
|
|
760
|
+
| Albert-Laszlo Barabasi | Scale-free networks, preferential attachment |
|
|
761
|
+
| Mark Granovetter | Strength of weak ties |
|
|
762
|
+
| Jeff Atwood | Stack Overflow + Discourse creator |
|
|
763
|
+
| Nir Eyal | Hook Model, habit-forming products |
|
|
764
|
+
| Amy Jo Kim | Community design, game thinking |
|
|
765
|
+
| Andrew Chen | Growth loops, network death spirals |
|
|
766
|
+
| Evan Miller | Wilson score popularization |
|
|
767
|
+
| Paul Graham | Hacker News ranking algorithm |
|
|
768
|
+
|
|
769
|
+
### Notable 2025-2026 Events
|
|
770
|
+
|
|
771
|
+
| Event | Date | Impact |
|
|
772
|
+
|-------|------|--------|
|
|
773
|
+
| Reddit deprecated r/all | Apr 2026 | Full shift to algorithmic personalized feeds |
|
|
774
|
+
| Reddit algorithm overhaul | Sep 2025 | "Engagement quality over volume" |
|
|
775
|
+
| Reddit relaunched Awards | Sep 2025 | Gold as currency (coins removed Jul 2023) |
|
|
776
|
+
| MLH acquired Forem/DEV.to | Feb 2026 | Forem mission continues under MLH |
|
|
777
|
+
| Google-Reddit $60M/year deal | 2024+ | Reddit data in AI Overviews, preferential SERPs |
|
|
778
|
+
| Google E-E-A-T correction | Early 2025 | Reddit lost 350 SISTRIX points; UGC recalibrated |
|
|
779
|
+
| Stack Overflow custom badges | Feb 2026 | Community-created challenge badges |
|
|
780
|
+
| Skool Hobby Plan | 2025 | $9/mo entry point with 10% fee |
|
|
781
|
+
|
|
782
|
+
---
|
|
783
|
+
|
|
784
|
+
> **Reference complete.** 8 core systems of community platform engineering covering network science,
|
|
785
|
+
> ranking algorithms, trust frameworks, gamification, growth mechanics, monetization,
|
|
786
|
+
> and technical SEO -- with mathematical formulas, platform comparisons, and implementation checklists.
|