sinapse-ai 9.3.0 → 9.5.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.
Files changed (432) hide show
  1. package/.claude/CLAUDE.md +60 -341
  2. package/.claude/hooks/enforce-architecture-first.py +197 -197
  3. package/.claude/hooks/enforce-git-push-authority.sh +25 -4
  4. package/.claude/hooks/mind-clone-governance.py +193 -193
  5. package/.claude/hooks/read-protection.py +152 -152
  6. package/.claude/hooks/sql-governance.py +183 -183
  7. package/.claude/hooks/verify-packages.cjs +83 -0
  8. package/.claude/hooks/write-path-validation.py +195 -195
  9. package/.claude/rules/agent-authority.md +6 -0
  10. package/.claude/rules/agent-handoff.md +5 -0
  11. package/.claude/rules/cross-squad-routing.md +5 -0
  12. package/.claude/rules/hook-governance.md +7 -0
  13. package/.claude/rules/mandatory-delegation.md +24 -0
  14. package/.claude/rules/mcp-usage.md +3 -1
  15. package/.claude/rules/project-intelligence.md +63 -0
  16. package/.claude/rules/response-format.md +4 -0
  17. package/.claude/rules/safe-collaboration.md +14 -2
  18. package/.claude/rules/security-data-protection.md +27 -0
  19. package/.claude/rules/squad-awareness.md +96 -68
  20. package/.claude/rules/token-economy.md +148 -0
  21. package/.claude/rules/tool-examples.md +6 -0
  22. package/.claude/rules/workflow-execution.md +7 -0
  23. package/.codex/agents/analyst.md +342 -71
  24. package/.codex/agents/architect.md +533 -68
  25. package/.codex/agents/data-engineer.md +530 -106
  26. package/.codex/agents/developer.md +657 -0
  27. package/.codex/agents/devops.md +639 -69
  28. package/.codex/agents/product-lead.md +362 -0
  29. package/.codex/agents/project-lead.md +405 -0
  30. package/.codex/agents/quality-gate.md +538 -0
  31. package/.codex/agents/sinapse-orqx.md +9 -7
  32. package/.codex/agents/sprint-lead.md +315 -0
  33. package/.codex/agents/squad-creator.md +402 -0
  34. package/.codex/agents/ux-design-expert.md +523 -0
  35. package/.codex/delegation-matrix.json +756 -44
  36. package/.codex/handoff-packet.schema.json +30 -6
  37. package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
  38. package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
  39. package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
  40. package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
  41. package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
  42. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
  43. package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
  44. package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
  45. package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
  46. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
  47. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
  48. package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
  49. package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
  50. package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
  51. package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
  52. package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
  53. package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
  54. package/.sinapse-ai/core/doctor/index.js +157 -50
  55. package/.sinapse-ai/core/ids/registry-updater.js +6 -1
  56. package/.sinapse-ai/core/logger/index.js +319 -0
  57. package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
  58. package/.sinapse-ai/core/telemetry/index.js +247 -0
  59. package/.sinapse-ai/data/entity-registry.yaml +1060 -808
  60. package/.sinapse-ai/development/agents/analyst.md +90 -0
  61. package/.sinapse-ai/development/agents/architect.md +78 -0
  62. package/.sinapse-ai/development/agents/data-engineer.md +38 -0
  63. package/.sinapse-ai/development/agents/developer.md +97 -0
  64. package/.sinapse-ai/development/agents/devops.md +121 -0
  65. package/.sinapse-ai/development/agents/product-lead.md +27 -0
  66. package/.sinapse-ai/development/agents/project-lead.md +28 -0
  67. package/.sinapse-ai/development/agents/quality-gate.md +89 -0
  68. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
  69. package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
  70. package/.sinapse-ai/development/agents/squad-creator.md +58 -0
  71. package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
  72. package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
  73. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
  74. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  75. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
  76. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
  77. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  78. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  79. package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
  80. package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
  81. package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
  82. package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
  83. package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
  84. package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
  85. package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
  86. package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
  87. package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
  88. package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
  89. package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
  90. package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
  91. package/.sinapse-ai/development/skills/debug.md +57 -0
  92. package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
  93. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  94. package/.sinapse-ai/development/skills/model-router.md +92 -0
  95. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  96. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  97. package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
  98. package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
  99. package/.sinapse-ai/development/skills/verify.md +53 -0
  100. package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
  101. package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
  102. package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
  103. package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
  104. package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
  105. package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
  106. package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
  107. package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
  108. package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
  109. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  110. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  111. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  112. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  113. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  114. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  115. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  116. package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
  117. package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
  118. package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
  119. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
  120. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  121. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  122. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
  123. package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
  124. package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
  125. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
  126. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
  127. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
  128. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
  129. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
  130. package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
  131. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
  132. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  133. package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
  134. package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
  135. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  136. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
  137. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
  138. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
  139. package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
  140. package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
  141. package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
  142. package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
  143. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  144. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  145. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  146. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  147. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  148. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  149. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  150. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  151. package/.sinapse-ai/install-manifest.yaml +333 -162
  152. package/.sinapse-ai/local-config.yaml.template +65 -65
  153. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
  154. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
  155. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
  156. package/.sinapse-ai/monitor/hooks/notification.py +30 -30
  157. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
  158. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
  159. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
  160. package/.sinapse-ai/monitor/hooks/stop.py +30 -30
  161. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
  162. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
  163. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  164. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  165. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  166. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  167. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  168. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  169. package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
  170. package/.sinapse-ai/product/templates/story.hbs +264 -264
  171. package/.sinapse-ai/product/templates/task.hbs +171 -171
  172. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  173. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  174. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  175. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  176. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  177. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  178. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  179. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  180. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  181. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  182. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  183. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  184. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  185. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  186. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  187. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
  188. package/LICENSE +34 -34
  189. package/README.en.md +167 -20
  190. package/README.md +190 -22
  191. package/bin/cli.js +510 -196
  192. package/bin/postinstall.js +564 -0
  193. package/bin/sinapse-cli +283 -283
  194. package/bin/sinapse-graph.js +9 -0
  195. package/bin/sinapse-init.js +36 -4
  196. package/bin/sinapse-minimal.js +20 -9
  197. package/bin/sinapse.js +202 -122
  198. package/bin/utils/deprecation-warning.js +46 -0
  199. package/bin/utils/pre-push-safety.js +14 -0
  200. package/docs/TELEMETRY.md +131 -0
  201. package/docs/chrome-brain-upgrade-plan.md +624 -0
  202. package/docs/codex-integration-process.md +22 -0
  203. package/docs/codex-parity-program.md +27 -0
  204. package/docs/framework/orqx-plan.md +1 -1
  205. package/docs/ide-integration.md +36 -0
  206. package/docs/installation/chrome-brain.md +17 -7
  207. package/docs/mega-upgrade-orchestration-plan.md +71 -0
  208. package/docs/pt/contributing.md +20 -0
  209. package/docs/research-synthesis-for-upgrade.md +511 -0
  210. package/docs/security-audit-report.md +306 -0
  211. package/package.json +20 -8
  212. package/packages/installer/src/config/configure-environment.js +19 -44
  213. package/packages/installer/src/detection/detect-project-type.js +181 -63
  214. package/packages/installer/src/installer/manifest-signature.js +32 -17
  215. package/packages/installer/src/wizard/i18n.js +12 -0
  216. package/packages/installer/src/wizard/ide-config-generator.js +8 -39
  217. package/packages/installer/src/wizard/index.js +119 -14
  218. package/packages/installer/src/wizard/questions.js +2 -3
  219. package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
  220. package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
  221. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
  222. package/packages/sinapse-install/bin/edmcp.js +0 -0
  223. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  224. package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
  225. package/scripts/check-markdown-links.py +353 -353
  226. package/scripts/coverage-report-summary.js +169 -0
  227. package/scripts/generate-install-manifest.js +6 -2
  228. package/scripts/release-readiness.js +169 -0
  229. package/scripts/test-install-matrix-local.sh +153 -0
  230. package/scripts/validate-install-docs.js +394 -0
  231. package/scripts/validate-no-external-refs.js +376 -0
  232. package/scripts/validate-squad-orqx.js +302 -0
  233. package/scripts/validate-story-meta.js +263 -0
  234. package/squads/claude-code-mastery/CHANGELOG.md +1 -1
  235. package/squads/claude-code-mastery/README.md +2 -2
  236. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  237. package/squads/claude-code-mastery/squad.yaml +1 -1
  238. package/squads/squad-artdir/README.md +90 -0
  239. package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
  240. package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
  241. package/squads/squad-artdir/agents/color-psychologist.md +166 -0
  242. package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
  243. package/squads/squad-artdir/agents/design-system-architect.md +100 -0
  244. package/squads/squad-artdir/agents/ia-architect.md +169 -0
  245. package/squads/squad-artdir/agents/interaction-designer.md +162 -0
  246. package/squads/squad-artdir/agents/layout-engineer.md +163 -0
  247. package/squads/squad-artdir/agents/motion-architect.md +185 -0
  248. package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
  249. package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
  250. package/squads/squad-artdir/agents/product-surface-director.md +86 -0
  251. package/squads/squad-artdir/agents/type-systemist.md +138 -0
  252. package/squads/squad-artdir/agents/visual-strategist.md +127 -0
  253. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
  254. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
  255. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
  256. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
  257. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
  258. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
  259. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
  260. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
  261. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
  262. package/squads/squad-artdir/package.json +20 -0
  263. package/squads/squad-artdir/squad.yaml +271 -0
  264. package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
  265. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
  266. package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
  267. package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
  268. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
  269. package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
  270. package/squads/squad-artdir/tasks/design-color-system.md +81 -0
  271. package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
  272. package/squads/squad-artdir/tasks/design-token-system.md +58 -0
  273. package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
  274. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
  275. package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
  276. package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
  277. package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
  278. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
  279. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
  280. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
  281. package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
  282. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  283. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  284. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  285. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  286. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  287. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  288. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  289. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  290. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  291. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  292. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  293. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  294. package/squads/squad-brand/squad.yaml +20 -6
  295. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  296. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  297. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  298. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  299. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  300. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  301. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  302. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  303. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  304. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  305. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  306. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  307. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  308. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  309. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  310. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  311. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  312. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  313. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  314. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  315. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  316. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  317. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  318. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  319. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  320. package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
  321. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  322. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  323. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  324. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  325. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  326. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  327. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  328. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  329. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  330. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  331. package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
  332. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  333. package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
  334. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  335. package/squads/squad-content/squad.yaml +187 -27
  336. package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
  337. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  338. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  339. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  340. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  341. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  342. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  343. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  344. package/squads/squad-copy/squad.yaml +19 -4
  345. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  346. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  347. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  348. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  349. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  350. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  351. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  352. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  353. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  354. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  355. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  356. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  357. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  358. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  359. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  360. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  361. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  362. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  363. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  364. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  365. package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
  366. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  367. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
  368. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  369. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  370. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  371. package/squads/squad-design/squad.yaml +19 -4
  372. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  373. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  374. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  375. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  376. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  377. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  378. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  379. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  380. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  381. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  382. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  383. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  384. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  385. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  386. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  387. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  388. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  389. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  390. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  391. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  392. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  393. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  394. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  395. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  396. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  397. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  398. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  399. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  400. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  401. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  402. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  403. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  404. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  405. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  406. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  407. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  408. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  409. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  410. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  411. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  412. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  413. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  414. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  415. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  416. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  417. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  418. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  419. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  420. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  421. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  422. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  423. package/.sinapse-ai/core/registry/service-registry.json +0 -6346
  424. package/.sinapse-ai/data/registry-update-log.jsonl +0 -1307
  425. package/.sinapse-ai/manifests/agents.csv +0 -29
  426. package/.sinapse-ai/manifests/tasks.csv +0 -204
  427. package/.sinapse-ai/manifests/workers.csv +0 -196
  428. package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
  429. package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
  430. package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
  431. package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
  432. package/squads/squad-paidmedia/tasks/calculate-sample-size.md +0 -57
@@ -0,0 +1,1007 @@
1
+ # Social Algorithms Master Reference
2
+
3
+ > **Source:** MS-007 Research (Social Algorithms & Content Distribution)
4
+ > **Date:** 2026-04-07 | **Sources:** 42+ consulted
5
+ > **Scope:** Instagram, TikTok, YouTube, LinkedIn, Twitter/X, Facebook algorithms, recommendation systems theory, cross-platform strategy, engagement mechanics, creator economy, Brazilian context
6
+
7
+ ---
8
+
9
+ ## Table of Contents
10
+
11
+ 1. [Panorama & Evolution](#1-panorama--evolution)
12
+ 2. [Instagram Algorithm](#2-instagram-algorithm)
13
+ 3. [TikTok Algorithm](#3-tiktok-algorithm)
14
+ 4. [YouTube Algorithm](#4-youtube-algorithm)
15
+ 5. [LinkedIn Algorithm](#5-linkedin-algorithm)
16
+ 6. [Twitter/X Algorithm](#6-twitterx-algorithm)
17
+ 7. [Facebook Algorithm](#7-facebook-algorithm)
18
+ 8. [Emerging Platforms](#8-emerging-platforms)
19
+ 9. [Recommendation Systems Theory](#9-recommendation-systems-theory)
20
+ 10. [Cross-Platform Content Strategy](#10-cross-platform-content-strategy)
21
+ 11. [Engagement Mechanics](#11-engagement-mechanics)
22
+ 12. [Creator Economy & Monetization](#12-creator-economy--monetization)
23
+ 13. [Social Commerce](#13-social-commerce)
24
+ 14. [AI & Social Media](#14-ai--social-media)
25
+ 15. [Brazilian Context](#15-brazilian-context)
26
+ 16. [Key People & References](#16-key-people--references)
27
+ 17. [Actionable Checklists](#17-actionable-checklists)
28
+
29
+ ---
30
+
31
+ ## 1. Panorama & Evolution
32
+
33
+ ### 1.1 Three Eras of Social Feeds
34
+
35
+ | Era | Period | Model | Key Characteristic |
36
+ |-----|--------|-------|-------------------|
37
+ | **1. Chronological** | 2004-2012 | Posts in time order | Simple but inefficient at scale |
38
+ | **2. Algorithmic Social** | 2012-2020 | Content from followed accounts, ranked | Social graph as primary filter |
39
+ | **3. Interest-Based Recommendation** | 2020-present | Content based on interests, not follows | TikTok proved interest graph > social graph |
40
+
41
+ Facebook introduced EdgeRank in 2009 (affinity x weight x time decay). Instagram abandoned chronological in 2016. TikTok's FYP doesn't depend on who you follow -- it depends on what you watch.
42
+
43
+ Adam Mosseri (2023): "Recommendations are the future of Instagram."
44
+
45
+ ### 1.2 The Attention Economy
46
+
47
+ Herbert Simon (1971): "A wealth of information creates a poverty of attention."
48
+
49
+ **Key numbers (2025):**
50
+ - Average global social media time: 2h24min/day
51
+ - Brazil average: **3h49min/day** -- highest in the world (DataReportal 2025)
52
+ - Average Instagram feed: 500+ new posts/day from followed accounts
53
+ - Only ~30% of available content is actually shown to users
54
+ - Algorithms optimize for: session time, return frequency (DAU/MAU), and ultimately ad revenue
55
+
56
+ ### 1.3 Discovery Surfaces Taxonomy
57
+
58
+ | Surface | Function | Examples |
59
+ |---------|----------|----------|
60
+ | **Main Feed** | Followed + recommended content | Instagram Feed, Twitter For You |
61
+ | **Discover/Explore** | New content discovery | Instagram Explore, TikTok FYP |
62
+ | **Short-form Video** | Algorithmic short video | Reels, Shorts, TikTok |
63
+ | **Search** | Intentional search | YouTube Search, Instagram Search |
64
+ | **Stories** | Ephemeral ranked content | Instagram/Facebook Stories |
65
+ | **Messaging/DM** | Private sharing (strong signal) | WhatsApp forwards, Instagram DM shares |
66
+ | **Notifications** | Re-engagement | Push notifications, email digests |
67
+
68
+ All surfaces share fundamental signals: engagement signals, content signals, user signals, and context signals.
69
+
70
+ ### 1.4 Platform vs Creator vs User Tension
71
+
72
+ - **Platforms** want to maximize: time on platform, ad impressions, DAU/MAU, revenue
73
+ - **Creators** want to maximize: reach, followers, engagement, monetization
74
+ - **Users** want: relevant content, social connection, entertainment, information
75
+
76
+ What users say they want and what their behavior reveals are often divergent -- YouTube calls this "nutritious content vs junk food content."
77
+
78
+ ---
79
+
80
+ ## 2. Instagram Algorithm
81
+
82
+ ### 2.1 Multiple Algorithms
83
+
84
+ Instagram does NOT have one algorithm. Feed, Explore, Reels, and Stories each use different algorithms. Infrastructure: PyTorch-based ML at billions of predictions/second for 2B+ MAU.
85
+
86
+ ### 2.2 Feed Ranking Signals (by weight)
87
+
88
+ 1. **Interest:** Probability of user interacting, based on past behavior. Model predicts likelihood of 5 actions: like, comment, save, share, view time
89
+ 2. **Relationship:** How close the user is to the author. Signals: mutual interactions, DMs, tags, profile searches
90
+ 3. **Timeliness:** Temporal decay -- 30-min-old post > 3-day-old post. Viral content with high engagement can resurface
91
+ 4. **Usage Frequency:** Users who open multiple times/day see more chronological feed; once/day users see "best of"
92
+ 5. **Diversity:** Prevents too many consecutive posts from same author or same content type
93
+
94
+ **Feed composition (2024):** ~15-20% recommended content from non-followed accounts, growing.
95
+
96
+ ### 2.3 Reels Algorithm (Key Differences from Feed)
97
+
98
+ Over 50% of Reels content comes from accounts the user does NOT follow. This is a discovery surface.
99
+
100
+ **Signal hierarchy:**
101
+
102
+ | Signal | Weight | Details |
103
+ |--------|--------|---------|
104
+ | **Watch Time / Completion Rate** | Highest | Reel watched to end or rewatched = massive boost. "Retention curve" -- early drop-off penalized |
105
+ | **Shares (DM)** | Very High | Mosseri: "Sends are the most important signal for Reels ranking" |
106
+ | **Saves** | High | Indicates lasting value (reference content) |
107
+ | **Engagement Velocity** | High | First 30-60 minutes determine algorithmic fate |
108
+ | **Trending Audio** | Medium | Reels using trending audio get boost |
109
+ | **Originality** | Medium | Penalizes TikTok watermarks, reposted content, aggregators |
110
+
111
+ **Known penalties:**
112
+ - TikTok watermark: significant distribution reduction
113
+ - Low resolution (<720p): penalized
114
+ - Text covering >20% of screen: may reduce reach
115
+ - Recycled content without added value: penalized
116
+ - Community guideline violations: shadow restriction
117
+
118
+ ### 2.4 Stories Ranking
119
+
120
+ Primarily by relationship proximity:
121
+ - **View history:** Consistently watched accounts appear first
122
+ - **Story interactions:** DM replies, emoji reactions, poll votes are strong signals
123
+ - **Timeliness:** More recent Stories appear first
124
+ - **Content type:** Algorithm learns format preference (video vs photo)
125
+
126
+ **Strategic insight:** Stories with interactive elements (polls, quizzes, sliders, questions) generate 2-3x more engagement and train the algorithm to prioritize your profile.
127
+
128
+ ### 2.5 Explore -- Discovery
129
+
130
+ Exclusively non-followed content. Process:
131
+
132
+ 1. **Candidate Generation:** Find accounts similar to recently engaged accounts (co-engagement)
133
+ 2. **Two-Tower Model:** User tower + content tower generate embeddings; proximity determines relevance
134
+ 3. **Ranking:** By engagement probability (like > save > share > comment for Explore)
135
+ 4. **Filtering:** Guideline violations, low quality filtered out
136
+ 5. **Diversity Injection:** Topical diversity to avoid excessive bubbles
137
+
138
+ ### 2.6 Shadowban Mechanics
139
+
140
+ Instagram denies "shadowban" but acknowledges "distribution reductions":
141
+ - **Community Guidelines violations:** Immediate reduction even without removal
142
+ - **Recommendation Guidelines:** "Borderline" content removed from Explore/Reels but not from Feed
143
+ - **Repeated violations:** Systemic reduction
144
+ - **Engagement bait:** Excessive "like, comment, share" requests may be penalized
145
+
146
+ **What does NOT cause reduction:** Account type (personal vs business/creator), posting frequency (within reason), links in bio, editing captions after posting.
147
+
148
+ ### 2.7 Algorithm Changes 2025-2026
149
+
150
+ | Change | Impact |
151
+ |--------|--------|
152
+ | **"Your Algorithm" tool** (Dec 2025) | Users can see/control topics shaping Reels recommendations |
153
+ | **Carousels dominant** | 10% avg engagement rate (vs 7% images, 6% Reels). 1.4x more reach, 3.1x more engagement vs single photos |
154
+ | **Aggregator penalty** | Accounts with 10+ reposts in 30 days excluded from recommendations. Original creators saw 40-60% reach increase |
155
+ | **Watch time as #1 signal** (Jan 2025) | First 3 seconds critical for initial distribution. Likes per reach and DM shares = 2nd and 3rd signals |
156
+ | **DM/Comments/Stories weight** (Mar 2026) | Even greater weight to accounts with frequent DM, comment, and Story interactions |
157
+ | **AI categorization** (2026) | Visual elements, text in images, video clips analyzed beyond hashtags -- hashtags less relevant |
158
+ | **AI translation for Reels** (late 2025) | Auto-translation of text and audio (Hindi, Portuguese, English, Spanish) |
159
+
160
+ ### 2.8 Engagement Velocity -- The Critical Window
161
+
162
+ 1. Post shown to ~10% of followers
163
+ 2. Algorithm measures: engagement rate, view time, saves, shares
164
+ 3. If performance exceeds creator's baseline: shown to more followers
165
+ 4. Exceptional performance: enters Explore and Reels (for Reels)
166
+ 5. Each distribution round exponentially expands audience
167
+
168
+ **Practical implication:** Post when followers are online (check Instagram Insights) to maximize engagement velocity.
169
+
170
+ ---
171
+
172
+ ## 3. TikTok Algorithm
173
+
174
+ ### 3.1 The For You Page Revolution
175
+
176
+ **Regulatory context (2025-2026):** TikTok USDS Joint Venture LLC established Jan 22, 2026. ByteDance retained minority stake <20%. Oracle, Silver Lake, MGX each hold ~15%. US algorithm trained exclusively on Oracle-hosted servers.
177
+
178
+ TikTok inverted the social media model: any video from any account can go viral regardless of follower count. FYP is based on **interest graph** (what you watch) not **social graph** (who you follow).
179
+
180
+ ### 3.2 Algorithm Signals
181
+
182
+ **Tier 1 -- Content Signals (highest weight):**
183
+
184
+ | Signal | Details |
185
+ |--------|---------|
186
+ | **Completion Rate** | Most powerful signal. 100% completion = max boost. Rewatched = additional boost |
187
+ | **Watch Time Total** | Absolute time matters. 60s video watched 55s can beat 15s video at 100% |
188
+ | **Shares** | Via DM or copied link = extremely strong. Valued above likes |
189
+ | **Comments** | Long, detailed comments weigh more than emojis |
190
+ | **Profile Visits** | Visiting creator profile after watching = strong interest signal |
191
+
192
+ **Tier 2 -- User Signals:** Interaction history, created content types, followed accounts (less weight than Instagram), "Not Interested" marks (strong negative signal)
193
+
194
+ **Tier 3 -- Device/Account Signals:** Language preference, country/location, device type (used as purchasing power proxy per leaked ByteDance docs), usage timing patterns
195
+
196
+ ### 3.3 Batch Testing (Pool System)
197
+
198
+ | Pool | Views | What Happens |
199
+ |------|-------|-------------|
200
+ | **Pool 1** | ~200-500 | Shown to small diverse group. Measures completion rate, engagement, shares. Needs ~50% completion + above-baseline engagement to advance |
201
+ | **Pool 2** | ~1,000-5,000 | Shown to users with similar interests. Metrics must maintain or improve |
202
+ | **Pool 3** | ~10,000-100,000 | Broad distribution, geographic diversity. "Viral potential" |
203
+ | **Pool 4+** | 100K-millions | Massive cross-geographic distribution. Algorithm saturates until engagement decays |
204
+
205
+ **Critical insight:** A video can "die" in Pool 1 and "resurrect" days or weeks later. TikTok periodically retests old content.
206
+
207
+ ### 3.4 Interest Graph vs Social Graph
208
+
209
+ | Aspect | Social Graph (Instagram/Facebook) | Interest Graph (TikTok) |
210
+ |--------|-----------------------------------|------------------------|
211
+ | **Base** | Who you follow | What you watch |
212
+ | **New creator** | Must build followers | Can go viral on 1st video |
213
+ | **Diversity** | Limited to social graph | High -- diverse FYP |
214
+ | **Cold start** | Slow (depends on network) | Fast (5-10 watched videos create profile) |
215
+ | **Lock-in** | High (followers are "property") | Low (algorithm can defavor anytime) |
216
+
217
+ Eugene Wei, "TikTok and the Sorting Hat" (2020): TikTok functions like Harry Potter's Sorting Hat -- rapidly categorizes users by interest without requiring them to declare preferences.
218
+
219
+ ### 3.5 Content Diversity & Optimization
220
+
221
+ **Diversity mechanisms:**
222
+ - Category cap: limits consecutive videos of same topic
223
+ - Creator diversity: avoids multiple videos from same creator in sequence
224
+ - New content injection: videos from new creators periodically injected
225
+ - Exploration allocation: ~10-20% of impressions for exploration outside user's interest profile
226
+
227
+ **Optimization tips:**
228
+ - **First 2-3 seconds:** Hook is everything. High skip rate = suppression
229
+ - **Duration:** No universal "ideal." What matters is completion rate vs total time
230
+ - **Trending audio:** One of most consistent boosts
231
+ - **On-screen text:** TikTok indexes overlay text for categorization (works as "implicit hashtags")
232
+ - **Hashtags:** Primarily for categorization, not discovery. #fyp/#foryou are irrelevant
233
+
234
+ ### 3.6 Monolith Architecture (ByteDance, 2022)
235
+
236
+ Key innovations from the published paper:
237
+ - **Real-time training:** Model trained continuously (not in daily batches)
238
+ - **Collisionless embedding:** Improved feature representation accuracy
239
+ - **Feature eviction:** Old irrelevant features automatically discarded
240
+ - **Scale:** Billions of interactions processed daily in real-time
241
+
242
+ ---
243
+
244
+ ## 4. YouTube Algorithm
245
+
246
+ ### 4.1 The Core Formula: CTR x AVD
247
+
248
+ **CTR (Click-Through Rate):** % of people who see thumbnail/title and click. Average: 2-10%. 8%+ is excellent.
249
+ **AVD (Average View Duration):** Average time watching. YouTube values absolute retention (minutes) AND relative (%).
250
+
251
+ - High CTR + low AVD = clickbait
252
+ - High AVD + low CTR = good content, weak packaging
253
+ - YouTube wants BOTH
254
+
255
+ ### 4.2 Discovery Surfaces
256
+
257
+ | Surface | Traffic Share | Key Signals |
258
+ |---------|-------------|-------------|
259
+ | **Browse (Homepage)** | ~40-60% | Viewing history, subscriptions, trends. Highly personalized. Favors "novelty" |
260
+ | **Suggested (Watch Next)** | ~30-40% | Topic correlation ("who watched X also watched Y"). Strongest signal: topical match |
261
+ | **Search** | Varies | Title/description/tag relevance, watch time history, engagement, channel authority |
262
+ | **Shorts** | Separate ecosystem | Completion/loop rate dominant. Cross-pollination with long-form limited |
263
+
264
+ ### 4.3 Satisfaction Surveys
265
+
266
+ Unique YouTube innovation: in-app surveys asking "How would you rate this video?" (1-5 stars) or "Was this video worth your time?"
267
+
268
+ This led to "responsible recommendation" -- balancing engagement with declared satisfaction. Junk food content (sensational, clickbait) may generate high watch time but low satisfaction.
269
+
270
+ ### 4.4 Thumbnail A/B Testing (2024+)
271
+
272
+ - Creator uploads 2-3 thumbnails per video
273
+ - YouTube shows each to equal audience portions
274
+ - Winner determined by **watch time generated** (not just CTR, to avoid rewarding clickbait)
275
+ - Automatically selected after 24-48h
276
+
277
+ Mr. Beast: tests dozens of thumbnails before publishing. Thumbnails are the most controllable factor for CTR.
278
+
279
+ ### 4.5 Session Time & Ecosystem
280
+
281
+ YouTube optimizes for the entire session, not just individual videos. A **session starter** (first video watched when opening YouTube) receives Browse boost. This favors regular, predictable publishing.
282
+
283
+ **Subscriber bell:** Only ~10-20% of subscribers activate "All" notifications. If subscribers don't watch, it's a negative signal.
284
+
285
+ ### 4.6 YouTube Shorts Updates 2025-2026
286
+
287
+ | Update | Details |
288
+ |--------|---------|
289
+ | **Extended duration** (2025) | Shorts can now be up to 3 minutes (was 60 seconds) |
290
+ | **New view counting** (Mar 2025) | Any Short that starts playing or loops counts as view. Each loop = additional view |
291
+ | **Algorithm separation** (late 2025) | Shorts recommendation engine fully separated from long-form |
292
+ | **Search filter** (Jan 2026) | Dedicated "Shorts" filter in search type menu |
293
+ | **Browse Feed change** (Dec 2025) | Homepage reduced long-form recommendations (~12 to ~2), prioritizing Shorts |
294
+ | **Satisfaction > watch time** (2026) | Satisfaction surveys and post-viewing behavior now surpass raw watch time |
295
+
296
+ ### 4.7 YouTube Recommendations Paper (Covington et al., 2016)
297
+
298
+ Two-stage architecture:
299
+ 1. **Candidate Generation:** Millions of videos reduced to hundreds using collaborative filtering with deep learning
300
+ 2. **Ranking:** Candidates ranked with complex model (watch time, engagement, freshness, upload frequency)
301
+
302
+ Objective function: watch time (not clicks). "Example Age" feature: video age as feature to learn natural relevance decay.
303
+
304
+ ---
305
+
306
+ ## 5. LinkedIn Algorithm
307
+
308
+ ### 5.1 B2B Context
309
+
310
+ ~1B members (2025), but only ~3-5% publish content actively. Favorable supply/demand for creators.
311
+
312
+ ### 5.2 Signal Hierarchy
313
+
314
+ | Signal | Weight | Details |
315
+ |--------|--------|---------|
316
+ | **Dwell Time** | Highest | Time spent reading, even without interaction. "Qualified dwell time" (actually read) vs "passive" (tab inactive). 30+ seconds = high quality |
317
+ | **Meaningful Comments** | Very High | 50+ character comments: high weight. Short emoji comments: low weight. Thread replies: medium-high. 1st-degree connections' comments: extra weight |
318
+ | **Shares/Reposts** | High | Shares with substantive comment >> simple reposts |
319
+ | **Network Relevance** | Medium | 1st and 2nd degree connections prioritized. Strangers only if exceptional performance |
320
+
321
+ LinkedIn explicitly reduces distribution of "engagement bait" ("comment YES if you agree", "repost if you've lived this").
322
+
323
+ ### 5.3 SSI (Social Selling Index)
324
+
325
+ Score 0-100 across 4 dimensions:
326
+ 1. Establishing Your Professional Brand
327
+ 2. Finding the Right People
328
+ 3. Engaging with Insights
329
+ 4. Building Relationships
330
+
331
+ Higher SSI correlates with greater organic reach (functions as implicit "creator score").
332
+
333
+ ### 5.4 Content Performance by Format
334
+
335
+ | Format | Average Reach | Engagement | Best For |
336
+ |--------|-------------|------------|----------|
337
+ | **Document/Carousel** | High | High | Educational, frameworks, lists |
338
+ | **Long text** | Medium-High | Medium | Storytelling, opinion, experience |
339
+ | **Image + text** | Medium | Medium | News, celebrations |
340
+ | **Video** | Medium | Medium-Low | Interviews, behind-the-scenes |
341
+ | **External link** | Low | Low | LinkedIn penalizes external links |
342
+ | **Newsletter** | Very High (via email) | High | Long recurring content |
343
+ | **Poll** | High (declining) | High | Market research |
344
+
345
+ **Critical insight:** LinkedIn penalizes posts with external links. Best practice: create native content. Putting link in first comment is also being penalized (2024+).
346
+
347
+ ### 5.5 LinkedIn Newsletters
348
+
349
+ Best organic performance feature:
350
+ - Subscribers get email AND push notification for each edition
351
+ - Open rates 20-50% (vs ~2-5% organic reach for posts)
352
+ - Each edition distributed as both post and email
353
+
354
+ ### 5.6 Employee Advocacy
355
+
356
+ Employee posts have **561% more reach** than company page posts (MSLGroup). Personal profiles have 3-5x greater organic reach than company pages.
357
+
358
+ ### 5.7 Changes 2025-2026
359
+
360
+ - **Saves and Sends** added to analytics (signals valued by algorithm)
361
+ - **Anti-automation filter:** Excessive comments or automation tools can limit visibility
362
+ - **Quality over quantity:** Limit to 1-3 highly relevant tags. Expert-led content prioritized
363
+ - Algorithm functions increasingly as "trust filter"
364
+
365
+ ---
366
+
367
+ ## 6. Twitter/X Algorithm
368
+
369
+ ### 6.1 Open-Source Revealed Weights (March 2023)
370
+
371
+ | Signal | Approximate Weight |
372
+ |--------|-------------------|
373
+ | **Reply** | 1x (baseline) |
374
+ | **Like** | 0.5x |
375
+ | **Retweet/Repost** | 1x |
376
+ | **Quote Tweet** | 1x |
377
+ | **Bookmark** | Confirmed signal (weight undisclosed) |
378
+ | **Reading time** | Growing weight |
379
+ | **Profile click** | Strong signal |
380
+ | **Link click** | Medium signal |
381
+
382
+ **Boost factors:**
383
+ - Images: ~2x boost over plain text
384
+ - Video: ~2x boost
385
+ - External links: **penalized** (X wants users on platform)
386
+ - Long threads: boosted by accumulated engagement
387
+ - Premium subscribers: ~4x boost in For You ranking (pay-to-play)
388
+
389
+ ### 6.2 For You vs Following
390
+
391
+ - **For You (default):** ~50% followed + ~50% recommended. "Heavy Ranker" ML model
392
+ - **Following:** Strictly chronological, no recommendations
393
+
394
+ ### 6.3 Community Notes
395
+
396
+ Decentralized fact-checking. Posts with Community Notes may have reduced distribution. Uses "bridging" algorithm -- notes only published if evaluators from different political perspectives agree.
397
+
398
+ ### 6.4 Grok AI Integration
399
+
400
+ Grok (xAI) integrated directly into platform. Can summarize threads, answer questions about trending topics, analyze images. Evolving constantly.
401
+
402
+ ---
403
+
404
+ ## 7. Facebook Algorithm
405
+
406
+ ### 7.1 Evolution: EdgeRank to MSI
407
+
408
+ - **EdgeRank (2009-2011):** Affinity x Weight x Decay
409
+ - **ML Era (2011-2018):** Thousands of features, optimized for engagement (inadvertently favored sensational content)
410
+ - **MSI - Meaningful Social Interactions (2018+):** Posts from friends/family prioritized over Pages. Content generating "meaningful conversations" (long comments, replies) prioritized. Publishers saw 40-60% organic reach drop
411
+
412
+ ### 7.2 Current State (2025)
413
+
414
+ - ~30-40% of feed is recommended content from non-followed accounts (response to TikTok)
415
+ - **Reels:** Maximum distribution priority on Facebook
416
+ - **Groups:** Prioritized, especially active communities
417
+ - **Link penalty:** Links receive lower distribution than native content (photos, videos, text)
418
+ - Company Pages organic reach: frequently <2% of followers (lowest among all platforms)
419
+
420
+ ### 7.3 Facebook Reels vs Long-Form
421
+
422
+ - **Reels:** Largest organic distribution of any Facebook format. Algorithm similar to Instagram Reels
423
+ - **Long-form video:** Drastically deprioritized in timeline (2017 video pivot partially reversed)
424
+ - **Facebook Live:** Still boosted during broadcast, but less impactful than 2018-2020
425
+
426
+ ---
427
+
428
+ ## 8. Emerging Platforms
429
+
430
+ ### 8.1 Threads (Meta)
431
+
432
+ - 100M users in 5 days (fastest app launch ever, July 2023)
433
+ - 400M MAU (Aug 2025), 450M MAU (early 2026)
434
+ - Surpassed X in mobile DAU (141.5M vs 125M) in January 2026
435
+ - Algorithm: Interest-based (similar to TikTok), not just follows
436
+ - Instagram data influences recommendations
437
+ - Replies and reposts are strongest signals
438
+ - External links NOT penalized as strongly as on X
439
+
440
+ ### 8.2 Bluesky (AT Protocol)
441
+
442
+ **Key innovation: Custom Feeds (Algorithmic Choice)**
443
+ - Users choose between multiple algorithms or create their own
444
+ - Chronological feed (default) + "Discover" + community-created feeds
445
+ - **AT Protocol:** Data portability -- users can theoretically migrate account, followers, content to another provider
446
+ - **Composable Moderation:** Users choose "labelers" and filter preferences
447
+
448
+ ### 8.3 WhatsApp Channels
449
+
450
+ - One-way broadcast updates. Content disappears after 30 days
451
+ - Ranking signals: recency, engagement (reactions), regional popularity
452
+ - In Brazil, especially relevant given 99% WhatsApp penetration
453
+ - Open rates significantly higher than email or traditional social media
454
+
455
+ ### 8.4 Pinterest
456
+
457
+ - Visual search engine more than social network
458
+ - Algorithm based on **intent** (discovery: decor, recipes, fashion)
459
+ - Pins have extremely long lifespan (months to years of traffic)
460
+ - SEO is fundamental (keywords in descriptions, board names)
461
+ - Pinterest has highest purchase intent (83% use it to plan purchases)
462
+
463
+ ### 8.5 Reddit
464
+
465
+ - Karma system (upvotes/downvotes determine visibility)
466
+ - Subreddit governance with unique micro-cultures
467
+ - "Hot" algorithm: karma + recency
468
+ - Google partnership (2024): Reddit extensively indexed. Powerful indirect SEO platform
469
+
470
+ ---
471
+
472
+ ## 9. Recommendation Systems Theory
473
+
474
+ ### 9.1 Collaborative Filtering
475
+
476
+ | Method | How It Works | Scale |
477
+ |--------|-------------|-------|
478
+ | **User-based** | "Users similar to you liked X" | Scales poorly (O(n^2)) |
479
+ | **Item-based** | "Items frequently consumed together are similar" | More scalable (Amazon's "also bought") |
480
+ | **Matrix Factorization** | Decomposes user-item matrix into latent factors. Dot product predicts interaction | Won Netflix Prize ($1M, 2009) |
481
+
482
+ ### 9.2 Content-Based Filtering
483
+
484
+ Analyzes content properties instead of user behavior:
485
+ - NLP for text (topics, sentiment, entities)
486
+ - Computer Vision for images/video (objects, scenes, faces)
487
+ - Audio analysis (genre, BPM, sentiment)
488
+ - Metadata (tags, categories, hashtags, duration)
489
+
490
+ Solves cold start for new items. Limitation: doesn't capture implicit/subtle preferences.
491
+
492
+ ### 9.3 Two-Tower Models (Dominant Architecture)
493
+
494
+ ```
495
+ User Tower: Content Tower:
496
+ [history] [content type]
497
+ [demographics] --> [visual features] --> Similarity Score
498
+ [interactions] Embedding [text features] Embedding
499
+ [device] [engagement stats]
500
+ ```
501
+
502
+ Used by Instagram Explore, YouTube, TikTok. Pre-computed embeddings enable efficient approximate nearest neighbor (ANN) search.
503
+
504
+ ### 9.4 Exploration vs Exploitation (Multi-Armed Bandits)
505
+
506
+ - **Exploitation:** Show content the algorithm knows user likes (high engagement probability)
507
+ - **Exploration:** Show new/different content to discover new interests (lower immediate probability, higher discovery potential)
508
+
509
+ | Method | Approach |
510
+ |--------|---------|
511
+ | **Epsilon-Greedy** | With probability epsilon (~5-20%), show random content |
512
+ | **Thompson Sampling** | Bayesian -- maintains probability distribution per item |
513
+ | **Upper Confidence Bound** | Favors items with high uncertainty + high potential |
514
+
515
+ TikTok: ~15-20% of FYP is exploratory content.
516
+
517
+ ### 9.5 Cold Start Problem
518
+
519
+ | Type | Solutions |
520
+ |------|----------|
521
+ | **New User** | Onboarding quiz (TikTok asks interests), popular/trending as default, demographics as proxy, cross-platform data transfer (Meta shares between Instagram/Facebook/Threads) |
522
+ | **New Content** | Content-based features, creator history, batch testing (TikTok's approach), NLP/CV topic matching |
523
+
524
+ ### 9.6 Embedding Spaces
525
+
526
+ - Each user: vector of ~100-500 dimensions
527
+ - Each content piece: similar vector
528
+ - Distance (cosine similarity, dot product) = relevance
529
+ - Transformers (BERT, GPT) revolutionized embedding quality with semantic understanding
530
+ - Platforms use CLIP/ViT for image embeddings, SentenceTransformers for text
531
+
532
+ ---
533
+
534
+ ## 10. Cross-Platform Content Strategy
535
+
536
+ ### 10.1 Format Optimization by Platform
537
+
538
+ | Platform | Favored Format | Penalized Format |
539
+ |----------|---------------|-----------------|
540
+ | **Instagram** | Reels, Carousels | External links, plain text |
541
+ | **TikTok** | Vertical video (9:16), trending audio | Content with watermarks |
542
+ | **YouTube** | Long-form (8-20 min), Shorts | Short videos (<4 min) in long-form |
543
+ | **LinkedIn** | Documents/Carousels, long text | External links, corporate posts |
544
+ | **X/Twitter** | Threads, images, short video | External links (penalized) |
545
+ | **Facebook** | Reels, Group posts | Links, Page posts |
546
+ | **Pinterest** | Vertical pins (2:3), infographics | Content without keywords |
547
+
548
+ ### 10.2 Cross-Posting vs Native vs Repurposing
549
+
550
+ - **Cross-posting (same piece everywhere):** Efficient but 30-50% lower performance than native
551
+ - **Native per platform:** Ideal but impractical for solo creators
552
+ - **Repurposing (recommended):** Create "master" piece, extract clips, transform insights per platform
553
+
554
+ ### 10.3 Hook Patterns (First 2-3 Seconds)
555
+
556
+ | Pattern | Example |
557
+ |---------|---------|
558
+ | **Curiosity Gap** | "Most people don't know that..." |
559
+ | **Contrarian** | "Stop doing X (everyone does it wrong)" |
560
+ | **Result-First** | "I made R$50K in 30 days. Here's how." |
561
+ | **Story Hook** | "3 months ago, I was broke..." |
562
+ | **Direct Challenge** | "If you're a [persona], you NEED to know this" |
563
+ | **Pattern Interrupt** | Unexpected visual, scene change, quick cut |
564
+ | **Social Proof** | "10 million views. Here's the secret." |
565
+
566
+ ### 10.4 Storytelling Structures for Social
567
+
568
+ | Framework | Structure |
569
+ |-----------|----------|
570
+ | **PAS** | Problem > Agitate consequences > Solution |
571
+ | **AIDA** | Attention (hook) > Interest (facts) > Desire (benefits) > Action (CTA) |
572
+ | **BAB** | Before (pain) > After (pleasure) > Bridge (your solution) |
573
+ | **Hero's Journey** | Normal life > Challenge > Search for solution > Transformation > New reality |
574
+
575
+ ### 10.5 Optimal Posting Times (Brazil, BRT)
576
+
577
+ | Platform | Best Times | Best Days |
578
+ |----------|-----------|-----------|
579
+ | **Instagram** | 11h-13h, 19h-21h | Tue, Wed, Thu |
580
+ | **TikTok** | 12h-14h, 19h-22h | Tue-Fri |
581
+ | **YouTube** | 14h-17h (upload) | Thu, Fri, Sat |
582
+ | **LinkedIn** | 7h-9h, 12h | Tue, Wed, Thu |
583
+ | **X/Twitter** | 9h-12h | Mon-Fri |
584
+ | **Facebook** | 9h-11h, 13h-15h | Wed, Thu |
585
+
586
+ **Caveat:** These are averages. Best time for any creator is determined by their own analytics.
587
+
588
+ ---
589
+
590
+ ## 11. Engagement Mechanics
591
+
592
+ ### 11.1 Engagement Rate Formulas
593
+
594
+ **Instagram:**
595
+ ```
596
+ ER (Post) = (Likes + Comments + Saves + Shares) / Followers x 100
597
+ ER (Reach-based) = (Likes + Comments + Saves + Shares) / Reach x 100 [more accurate]
598
+ ```
599
+
600
+ **Benchmarks Instagram (2025):**
601
+ | Tier | Followers | ER |
602
+ |------|----------|-----|
603
+ | Nano | 1-10K | 3-5% |
604
+ | Micro | 10-100K | 1.5-3% |
605
+ | Mid | 100K-500K | 1-2% |
606
+ | Macro | 500K-1M | 0.8-1.5% |
607
+ | Mega | 1M+ | 0.5-1% |
608
+
609
+ **TikTok:** `ER = (Likes + Comments + Shares) / Views x 100` -- 3-9% normal, >10% excellent
610
+ **YouTube:** `ER = (Likes + Comments) / Views x 100` -- 3-7% good
611
+ **LinkedIn:** `ER = (Reactions + Comments + Reposts) / Impressions x 100` -- 2-5% good, >5% excellent
612
+
613
+ ### 11.2 Vanity vs Actionable Metrics
614
+
615
+ | Vanity (look good, don't indicate value) | Actionable (indicate real value) |
616
+ |------------------------------------------|----------------------------------|
617
+ | Total followers (without quality) | **Saves** (reference content) |
618
+ | Total likes (easily inflated) | **Shares/DM sends** (genuine recommendation) |
619
+ | Impressions (don't indicate interest) | **Quality comments** (emotional/intellectual connection) |
620
+ | Reach without engagement context | **Profile visits** after content view |
621
+ | | **Follower-to-lead ratio** (B2B) |
622
+ | | **Revenue per follower** |
623
+
624
+ ### 11.3 Saves & Shares as Quality Signals
625
+
626
+ Both Instagram and TikTok confirmed (2024-2025) that saves and shares outweigh likes.
627
+
628
+ - **Like:** Low effort, quasi-reflexive, casual
629
+ - **Comment:** Medium effort, can be superficial
630
+ - **Save:** User wants to access again = lasting practical/emotional value
631
+ - **Share (DM):** User recommending to someone specific = strongest genuine value signal
632
+
633
+ **Implication:** Create "saveable" (tutorials, lists, frameworks, infographics) and "shareable" (relatable, surprising, useful to others) content rather than just "likeable" (beautiful but substanceless).
634
+
635
+ ### 11.4 Community Building Strategies
636
+
637
+ 1. Respond to comments systematically (especially first hours)
638
+ 2. Create participatory content (questions, challenges, polls)
639
+ 3. Name the community (give identity to follower group)
640
+ 4. Consistency creates expectation and habit
641
+ 5. "Insider" content (inside jokes, recurring references)
642
+ 6. DM engagement (respond genuinely -- strong algorithmic weight)
643
+
644
+ ### 11.5 DM Strategies
645
+
646
+ DMs are the strongest relationship signal for most algorithms:
647
+ - Instagram: frequent DM exchanges = content prioritized in feed
648
+ - TikTok: DM shares = strongest signal for Reels
649
+ - LinkedIn: InMail/DM interactions influence content ranking
650
+
651
+ **Tactics:**
652
+ - Respond to every genuine DM
653
+ - Send exclusive content via DM (Instagram broadcast channels)
654
+ - Use Stories to encourage DM replies
655
+ - Create "close friends" lists with most engaged followers
656
+
657
+ ---
658
+
659
+ ## 12. Creator Economy & Monetization
660
+
661
+ ### 12.1 Market Overview
662
+
663
+ Creator economy: ~$250B globally (2024, Goldman Sachs), projected $480B by 2027. Brazil influencer marketing: R$2.18B (2024).
664
+
665
+ **Income distribution (extremely unequal):**
666
+ - Top 1% earn ~80% of total revenue
667
+ - ~2M creators earn >$100K/year globally
668
+ - ~46M creators are "amateur" (<$1K/year)
669
+ - Median full-time creator income: ~$50K/year
670
+
671
+ ### 12.2 Platform Monetization Programs
672
+
673
+ | Platform | Program | Requirements | Revenue Model |
674
+ |----------|---------|-------------|---------------|
675
+ | **YouTube** | YPP | 1K subs + 4K hours (or 10M Shorts views/90 days) | 55% revenue share (long-form), 45% Shorts. CPM $2-30 |
676
+ | **Instagram/Facebook** | Subscriptions, Badges, Reels Bonus | Varies | Subscriptions for exclusive content. Meta less generous in direct share |
677
+ | **TikTok** | Creativity Program Beta | Videos >1 min | Pays per qualified views. RPM historically low ($0.02-0.05/1K views old Creator Fund) |
678
+ | **LinkedIn** | None (direct) | N/A | Indirect: leads, clients, consulting |
679
+ | **X/Twitter** | Ads Revenue Sharing | Premium + 5M impressions/3 months | Subscriptions, Tips |
680
+
681
+ ### 12.3 Brand Deals -- Brazilian Benchmarks (2025)
682
+
683
+ | Tier | Followers | Average Price per Post (Instagram) |
684
+ |------|----------|-----------------------------------|
685
+ | Nano | 1-10K | R$200-1,000 |
686
+ | Micro | 10-100K | R$1,000-5,000 |
687
+ | Mid | 100K-500K | R$5,000-20,000 |
688
+ | Macro | 500K-1M | R$20,000-80,000 |
689
+ | Mega | 1M+ | R$80,000-500,000+ |
690
+
691
+ ### 12.4 Creator Tools Ecosystem
692
+
693
+ | Category | Tools |
694
+ |----------|-------|
695
+ | **Video editing** | CapCut (dominant), Premiere Pro, DaVinci Resolve |
696
+ | **Design** | Canva (dominant in Brazil), Figma |
697
+ | **Scheduling** | Later, Buffer, Hootsuite, Metricool |
698
+ | **Analytics** | Iconosquare, Sprout Social, Metricool |
699
+ | **Link in Bio** | Linktree, Stan Store, Beacons |
700
+ | **Monetization** | Hotmart, Eduzz, Patreon, Ko-fi |
701
+ | **AI Content** | ChatGPT, Claude, Opus Clip (repurposing) |
702
+ | **CRM/Influencer** | Squid (Brazil), Influency.me, CreatorIQ |
703
+
704
+ ---
705
+
706
+ ## 13. Social Commerce
707
+
708
+ ### 13.1 Market Overview
709
+
710
+ Global social commerce: $1.2T (2024), projected $2.9T by 2026 (Accenture). China: >15% of total e-commerce. Brazil: regional leader in Latin America.
711
+
712
+ ### 13.2 Platform Shopping Features
713
+
714
+ | Platform | Features | Notes |
715
+ |----------|----------|-------|
716
+ | **Instagram Shopping** | Product tags in posts/Stories/Reels, Shop tab, Collections | Algorithm prioritizes tagged content in shopping surfaces |
717
+ | **TikTok Shop** | Product integration in videos/lives, affiliate marketplace, native checkout | Launched in Brazil 2024. ByteDance invested billions |
718
+ | **Pinterest Shopping** | Product Pins with prices, visual search, Shopping ads | 83% of users plan purchases on Pinterest |
719
+ | **WhatsApp Business** | Product catalog + WhatsApp Pay (Pix) | Brazil "last mile" of conversion |
720
+
721
+ ### 13.3 Live Commerce
722
+
723
+ Growing format. In China: $500B in sales (2023). In Brazil, accelerating:
724
+ - Shopee Live: largest Brazilian live commerce operation
725
+ - Instagram Lives with product tags
726
+ - TikTok Lives (growing rapidly)
727
+ - Mercado Livre Lives (launched 2024)
728
+
729
+ **Success factors:** Urgency (limited offers), interactivity (real-time Q&A), practical demonstration, trust in presenter, exclusive discounts.
730
+
731
+ ---
732
+
733
+ ## 14. AI & Social Media
734
+
735
+ ### 14.1 AI Content Generation Tools
736
+
737
+ | Type | Tools |
738
+ |------|-------|
739
+ | **Text** | ChatGPT, Claude, Gemini, Jasper, Copy.ai, native platform AI (Instagram captions, LinkedIn assistant) |
740
+ | **Image** | Midjourney, DALL-E 3, Stable Diffusion, Canva Magic Design, Adobe Firefly |
741
+ | **Video** | Runway ML, Pika, Opus Clip/Vidyo.ai (repurposing), Synthesia/HeyGen (AI avatars) |
742
+ | **Audio** | ElevenLabs (voice cloning), Suno/Udio (music generation), Podcastle (AI editing) |
743
+
744
+ ### 14.2 AI-Powered Analytics
745
+
746
+ - **Metricool AI:** Suggests optimal times based on history
747
+ - **Lately AI:** Analyzes long content and generates social posts
748
+ - **Sprout Social AI:** Sentiment analysis and trend detection
749
+ - **Exploding Topics:** Identifies exponentially growing topics
750
+
751
+ ### 14.3 Deepfakes & Synthetic Media
752
+
753
+ - Platforms invest in detection models (Meta's Video Authenticity, Google's SynthID)
754
+ - Meta, YouTube, TikTok require AI-generated content labeling
755
+ - EU AI Act and Brazilian AI Bill regulating deepfakes
756
+ - Electoral deepfakes a growing risk, especially in Brazil
757
+
758
+ ### 14.4 AI Moderation
759
+
760
+ - >95% of violating content removed by AI before human reports (Meta)
761
+ - Limitations: difficulty with sarcasm, cultural context, and Brazilian Portuguese regional slang nuances
762
+ - "Borderline" content can have reduced distribution without removal (shadowban)
763
+
764
+ ---
765
+
766
+ ## 15. Brazilian Context
767
+
768
+ ### 15.1 Social Media Landscape (2025)
769
+
770
+ | Metric | Value |
771
+ |--------|-------|
772
+ | Population | ~216M |
773
+ | Internet users | ~183M (86.2%) |
774
+ | Social media identities | ~144M (67.8%) |
775
+ | Daily social media time | 3h49min (world's highest) |
776
+ | Gender split | 55.8% female, 44.2% male |
777
+
778
+ **Platform MAU in Brazil:**
779
+
780
+ | Platform | MAU (Brazil) | Notes |
781
+ |----------|-------------|-------|
782
+ | WhatsApp | ~169M | 99% of smartphones |
783
+ | YouTube | ~142M | |
784
+ | Instagram | ~141M | #1 content platform |
785
+ | TikTok | ~131M | From 83M (2023) to 131M (2025) |
786
+ | Facebook | ~109M | |
787
+ | LinkedIn | ~75M | |
788
+ | Telegram | ~75M | Grew post-X blocks (2024) |
789
+ | Pinterest | ~38M | |
790
+ | Threads | ~34M (est.) | |
791
+ | X/Twitter | ~22M | Dropped after judicial block (2024) |
792
+
793
+ ### 15.2 WhatsApp Dominance
794
+
795
+ 99% smartphone penetration. Used for: personal communication, business, customer service, sales, payments (Pix via WhatsApp), news. 5M+ small businesses use WhatsApp Business.
796
+
797
+ **Marketing implication:** In Brazil, WhatsApp is frequently the "last mile" of conversion. Journeys start on Instagram/TikTok and end with "chama no zap." Strategies ignoring WhatsApp are incomplete.
798
+
799
+ ### 15.3 Creator Economy Brasileira
800
+
801
+ Brazil has the 3rd largest creator economy (after US and China):
802
+ - 500K+ professional content creators
803
+ - R$2.18B influencer marketing market (2024)
804
+ - Management platforms: Squid (acquired by Locaweb), Influency.me, Airfluencers
805
+ - Multi-platform presence is the norm (Instagram + TikTok + YouTube)
806
+ - Strong humor and Brazilian cultural references
807
+ - Creator events: VidCon Sao Paulo, Influencer Conference
808
+
809
+ ### 15.4 CONAR & #publi Regulation
810
+
811
+ - CONAR requires clearly identified advertising (#publi, #ad, #patrocinado)
812
+ - Article 36 Consumer Defense Code prohibits hidden/misleading advertising
813
+ - Identification must be "immediate and conspicuous" (not buried in hashtags)
814
+ - Stories/Lives need identification per slide/verbal+visual
815
+ - Fines: CONAR up to R$250,000; Procon additional fines for misleading advertising
816
+ - LGPD applies to follower data collection
817
+
818
+ ### 15.5 Brazilian Benchmarks
819
+
820
+ **CPM (Cost Per Thousand Impressions) -- Ads:**
821
+
822
+ | Platform | Average CPM (Brazil) |
823
+ |----------|---------------------|
824
+ | Instagram Feed | R$15-35 |
825
+ | Instagram Stories | R$10-25 |
826
+ | Instagram Reels | R$8-20 |
827
+ | TikTok In-Feed | R$5-15 |
828
+ | YouTube Pre-Roll | R$20-50 |
829
+ | Facebook Feed | R$8-20 |
830
+ | LinkedIn | R$40-100 |
831
+
832
+ **Organic Engagement Rate:**
833
+
834
+ | Platform | Brazil ER | Global ER |
835
+ |----------|----------|-----------|
836
+ | Instagram | 1.5-3% | 1-2% |
837
+ | TikTok | 5-9% | 4-8% |
838
+ | LinkedIn | 2-4% | 1.5-3% |
839
+ | YouTube | 3-5% | 2-4% |
840
+ | Facebook | 0.5-1% | 0.3-0.8% |
841
+
842
+ Brazil consistently shows above-global-average engagement rates, reflecting highly social and participative user behavior.
843
+
844
+ ### 15.6 PT-BR Content Nuances
845
+
846
+ - **Regional slang:** Algorithm NLP may not capture regional nuances. Use colloquial but nationally accessible Portuguese
847
+ - **Emojis:** Brazilians use extensively. Posts without emojis may seem "cold"
848
+ - **Tone:** Formal on LinkedIn, casual/authentic on Instagram and TikTok
849
+ - **Hashtags:** PT-BR hashtags reach Brazilian audience; English reaches global. Hybrid strategy recommended
850
+ - **Brazilian humor:** Memes, self-deprecation, comic exaggeration culturally strong and high-engagement
851
+ - **Brazilian music:** Trending Brazilian songs on TikTok/Reels can generate local boost
852
+ - **Key dates:** Carnaval, Festa Junina, Black Friday (extremely strong in Brazil), Dia das Maes
853
+
854
+ ---
855
+
856
+ ## 16. Key People & References
857
+
858
+ ### 16.1 Essential Thinkers
859
+
860
+ | Person | Contribution | Key Work |
861
+ |--------|-------------|----------|
862
+ | **Eli Pariser** | Coined "filter bubble" | "The Filter Bubble" (2011) |
863
+ | **Tristan Harris** | "Race to the bottom of the brainstem" | "The Social Dilemma" (Netflix, 2020) |
864
+ | **Eugene Wei** | "Status as a Service", "TikTok and the Sorting Hat" | Essays (2019, 2020) |
865
+ | **Nir Eyal** | Hook model (Trigger > Action > Variable Reward > Investment) | "Hooked" (2014) |
866
+ | **Jonah Berger** | STEPPS framework for virality | "Contagious" (2013) |
867
+ | **Gary Vaynerchuk** | "Jab Jab Jab Right Hook" framework | "Jab, Jab, Jab, Right Hook" (2013) |
868
+ | **Li Jin** | "100 True Fans" (update of Kevin Kelly's 1,000) | "The Passion Economy" (2020) |
869
+ | **Chris Dixon** | "Read Write Own" -- Web evolution framework | "Read Write Own" (2024) |
870
+ | **Jaron Lanier** | Critique of ad-based social media model | "Ten Arguments..." (2018) |
871
+ | **Casey Newton** | Leading journalist on platform decisions | Platformer newsletter |
872
+
873
+ ### 16.2 Essential Books
874
+
875
+ | Book | Author | Year | Core Topic |
876
+ |------|--------|------|-----------|
877
+ | "The Filter Bubble" | Eli Pariser | 2011 | Algorithmic personalization critique |
878
+ | "Hooked" | Nir Eyal | 2014 | Habit-forming products / social engagement |
879
+ | "Contagious" | Jonah Berger | 2013 | Science behind virality (STEPPS) |
880
+ | "Jab Jab Jab Right Hook" | Vaynerchuk | 2013 | Platform-specific content strategy |
881
+ | "No Filter" | Sarah Frier | 2020 | Internal Instagram history |
882
+ | "The Age of Surveillance Capitalism" | Shoshana Zuboff | 2019 | Data economy and platform surveillance |
883
+ | "Read Write Own" | Chris Dixon | 2024 | Decentralized future of platforms |
884
+ | "Influence" | Robert Cialdini | 2006 | 6 persuasion principles applied to social |
885
+
886
+ ### 16.3 Essential Academic Papers
887
+
888
+ | Paper | Authors | Year | Contribution |
889
+ |-------|---------|------|-------------|
890
+ | Deep Neural Networks for YouTube Recommendations | Covington et al. (Google) | 2016 | YouTube two-stage recommendation architecture |
891
+ | Monolith: Real Time Recommendation System | Liu et al. (ByteDance) | 2022 | TikTok recommendation architecture |
892
+ | Instagram Explore Recommender System | Medvedev et al. (Meta) | 2019 | Two-tower model for Explore |
893
+ | Attention Is All You Need | Vaswani et al. (Google) | 2017 | Transformer architecture -- base for modern recommendation |
894
+ | The Spread of True and False News Online | Vosoughi et al. (MIT) | 2018 | Fake news spreads 6x faster than truth on social media |
895
+ | Algorithmic Amplification of Politics on Twitter | Huszar et al. (Twitter) | 2021 | Internal study on political content amplification |
896
+
897
+ ---
898
+
899
+ ## 17. Actionable Checklists
900
+
901
+ ### Platform-Specific Content Optimization
902
+
903
+ **Instagram:**
904
+ ```
905
+ [ ] Reels: Hook in first 3 seconds (visual + text)
906
+ [ ] Reels: Optimize for watch-through (keep viewers to end)
907
+ [ ] Carousels: 5-10 slides with actionable content (save-worthy)
908
+ [ ] Stories: Use interactive elements (polls, quizzes, questions)
909
+ [ ] Post when followers are online (check Insights)
910
+ [ ] Respond to DMs to strengthen relationship signal
911
+ [ ] No TikTok watermarks on Reels
912
+ [ ] Create original content (avoid pure reposting)
913
+ ```
914
+
915
+ **TikTok:**
916
+ ```
917
+ [ ] Hook in first 2 seconds (high skip rate = suppression)
918
+ [ ] Optimize for completion rate + total watch time
919
+ [ ] Use trending audio when relevant
920
+ [ ] Add on-screen text (indexed for categorization)
921
+ [ ] Skip #fyp/#foryou hashtags (irrelevant)
922
+ [ ] Use niche hashtags for initial categorization
923
+ [ ] Create for shares (DM shares = strongest signal)
924
+ ```
925
+
926
+ **YouTube:**
927
+ ```
928
+ [ ] Thumbnail: High contrast, expressive face, short text
929
+ [ ] Title: Keyword at start, < 60 chars, curiosity element
930
+ [ ] Description: 200+ words, keyword in first 100 chars, timestamps
931
+ [ ] Optimize for both CTR AND watch time (avoid clickbait)
932
+ [ ] First 30 seconds must retain viewers
933
+ [ ] Cards and end screens to extend session time
934
+ [ ] Consider thumbnail A/B testing
935
+ ```
936
+
937
+ **LinkedIn:**
938
+ ```
939
+ [ ] Write long-form text that rewards reading time (dwell time is #1 signal)
940
+ [ ] Use document carousels for educational content
941
+ [ ] Avoid external links in post (native content only)
942
+ [ ] Engage meaningfully in comments (50+ characters)
943
+ [ ] Limit to 1-3 highly relevant hashtags
944
+ [ ] Leverage newsletter feature for maximum organic reach
945
+ [ ] Post during business hours (7-9h, 12h BRT)
946
+ ```
947
+
948
+ ### Engagement Quality Assessment
949
+
950
+ ```
951
+ [ ] Are saves/shares growing (not just likes)?
952
+ [ ] Are comments substantive (not just emojis)?
953
+ [ ] Are profile visits increasing after content view?
954
+ [ ] Is follower-to-lead ratio improving (B2B)?
955
+ [ ] Are DM conversations increasing?
956
+ [ ] Is engagement velocity strong in first 30-60 minutes?
957
+ [ ] Is content being referenced/cited by others?
958
+ ```
959
+
960
+ ### Cross-Platform Repurposing Workflow
961
+
962
+ ```
963
+ 1. Create master content piece (long video, podcast, or article)
964
+ 2. [ ] Extract 5-10 clips for Reels/TikTok/Shorts (add native captions)
965
+ 3. [ ] Transform key insights into Instagram/LinkedIn carousels
966
+ 4. [ ] Create text threads for X/Twitter
967
+ 5. [ ] Write newsletter edition from key takeaways
968
+ 6. [ ] Design 5-10 quote cards for Stories
969
+ 7. [ ] Adapt tone/format for each platform culture
970
+ 8. [ ] Schedule across platforms at optimal times per analytics
971
+ ```
972
+
973
+ ### Brazilian Market Checklist
974
+
975
+ ```
976
+ [ ] Content in Brazilian Portuguese (not Portugal Portuguese)
977
+ [ ] WhatsApp strategy integrated (last mile of conversion)
978
+ [ ] #publi disclosure on ALL sponsored content
979
+ [ ] LGPD compliance for data capture
980
+ [ ] Cultural calendar planned (Carnaval, Black Friday, Dia das Maes)
981
+ [ ] Emojis used appropriately for Brazilian audience expectations
982
+ [ ] Brazilian trending audio/music considered for Reels/TikTok
983
+ [ ] Regional nuances tested (humor style, slang level)
984
+ [ ] PIX integration for micro-transactions if applicable
985
+ ```
986
+
987
+ ### Algorithm Health Monitoring
988
+
989
+ ```
990
+ Monthly:
991
+ [ ] Review reach trends per content type
992
+ [ ] Compare engagement rate vs platform benchmarks
993
+ [ ] Check for distribution anomalies (possible restriction)
994
+ [ ] Audit content against known penalties (watermarks, engagement bait)
995
+ [ ] Review posting times vs follower activity patterns
996
+
997
+ Quarterly:
998
+ [ ] Check for algorithm updates from official platform sources
999
+ [ ] Review format performance shifts (carousels vs Reels vs static)
1000
+ [ ] Assess signal weight changes (saves vs likes vs shares)
1001
+ [ ] Update content strategy based on platform direction
1002
+ ```
1003
+
1004
+ ---
1005
+
1006
+ > **Source research:** MS-007 Social Algorithms Master System | 42 sources | April 2026
1007
+ > **Compiled for:** squad-content knowledge-base | SINAPSE AI