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.
Files changed (192) hide show
  1. package/.claude/CLAUDE.md +56 -343
  2. package/.claude/rules/agent-authority.md +6 -0
  3. package/.claude/rules/agent-handoff.md +5 -0
  4. package/.claude/rules/cross-squad-routing.md +5 -0
  5. package/.claude/rules/hook-governance.md +6 -0
  6. package/.claude/rules/mcp-usage.md +3 -1
  7. package/.claude/rules/safe-collaboration.md +10 -0
  8. package/.claude/rules/security-data-protection.md +9 -0
  9. package/.claude/rules/squad-awareness.md +3 -1
  10. package/.claude/rules/tool-examples.md +6 -0
  11. package/.claude/rules/workflow-execution.md +7 -0
  12. package/.codex/agents/analyst.md +253 -72
  13. package/.codex/agents/architect.md +455 -68
  14. package/.codex/agents/data-engineer.md +492 -106
  15. package/.codex/agents/developer.md +560 -0
  16. package/.codex/agents/devops.md +518 -69
  17. package/.codex/agents/product-lead.md +335 -0
  18. package/.codex/agents/project-lead.md +377 -0
  19. package/.codex/agents/quality-gate.md +449 -0
  20. package/.codex/agents/sinapse-orqx.md +9 -7
  21. package/.codex/agents/sprint-lead.md +287 -0
  22. package/.codex/agents/squad-creator.md +344 -0
  23. package/.codex/agents/ux-design-expert.md +495 -0
  24. package/.codex/delegation-matrix.json +756 -44
  25. package/.codex/handoff-packet.schema.json +30 -6
  26. package/.sinapse-ai/data/entity-registry.yaml +175 -363
  27. package/.sinapse-ai/data/registry-update-log.jsonl +16 -0
  28. package/.sinapse-ai/development/agents/analyst.md +90 -0
  29. package/.sinapse-ai/development/agents/architect.md +73 -0
  30. package/.sinapse-ai/development/agents/developer.md +69 -0
  31. package/.sinapse-ai/development/agents/devops.md +117 -0
  32. package/.sinapse-ai/development/agents/quality-gate.md +85 -0
  33. package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
  34. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
  35. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  36. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
  37. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
  38. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  39. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  40. package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
  41. package/.sinapse-ai/development/skills/debug.md +57 -0
  42. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  43. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  44. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  45. package/.sinapse-ai/development/skills/verify.md +53 -0
  46. package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
  47. package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
  48. package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
  49. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
  50. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  51. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  52. package/.sinapse-ai/install-manifest.yaml +71 -35
  53. package/docs/codex-integration-process.md +22 -0
  54. package/docs/codex-parity-program.md +27 -0
  55. package/docs/ide-integration.md +36 -0
  56. package/package.json +1 -1
  57. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  58. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  59. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  60. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  61. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  62. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  63. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  64. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  65. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  66. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  67. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  68. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  69. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  70. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  71. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  72. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  73. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  74. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  75. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  76. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  77. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  78. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  79. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  80. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  81. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  82. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  83. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  84. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  85. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  86. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  87. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  88. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  89. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  90. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  91. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  92. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  93. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  94. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  95. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  96. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  97. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  98. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  99. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  100. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  101. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  102. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  103. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  104. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  105. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  106. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  107. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  108. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  109. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  110. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  111. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  112. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  113. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  114. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  115. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  116. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  117. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  118. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  119. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  120. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  121. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  122. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  123. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  124. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  125. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  126. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  127. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  128. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  129. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  130. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  131. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  132. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  133. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  134. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  135. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
  136. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  137. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  138. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  139. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  140. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  141. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  142. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  143. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  144. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  145. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  146. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  147. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  148. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  149. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  150. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  151. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  152. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  153. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  154. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  155. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  156. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  157. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  158. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  159. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  160. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  161. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  162. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  163. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  164. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  165. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  166. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  167. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  168. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  169. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  170. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  171. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  172. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  173. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  174. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  175. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  176. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  177. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  178. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  179. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  180. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  181. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  182. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  183. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  184. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  185. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  186. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  187. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  188. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  189. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  190. package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
  191. package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
  192. package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
@@ -0,0 +1,194 @@
1
+ # Community Research Methods
2
+
3
+ > Extraído e sintetizado de MS-010 Forum & Community Platform Engineering (2026) — análise de Reddit, Discord, Stack Overflow, Discourse e outras plataformas com dados de 2025-2026.
4
+
5
+ ## Fundamentos Teóricos
6
+
7
+ ### Barabási-Albert Model (Redes Scale-Free)
8
+ Redes sociais reais não são aleatórias — seguem power-law degree distributions onde poucos nós (hubs) têm vastamente mais conexões que a maioria.
9
+
10
+ **Dois mecanismos:**
11
+ 1. **Growth:** Redes adicionam continuamente novos nós
12
+ 2. **Preferential attachment:** Novos nós preferem conectar a nós já bem conectados ("rich-get-richer")
13
+
14
+ **Distribuição:** P(k) ~ k^(-gamma), tipicamente gamma entre 2 e 3.
15
+
16
+ **Aplicação em research:** Identifique os hubs de uma comunidade/mercado — eles movem informação e opinião de forma desproporcional. Em análise competitiva, os "subreddits hub" são pontes entre clusters de usuários.
17
+
18
+ ### Granovetter: Força dos Laços Fracos (1973)
19
+ Paradoxo fundamental: **laços fracos (conhecidos) são mais valiosos que laços fortes (amigos íntimos)** para difusão de informação.
20
+
21
+ **Por quê:** Laços fortes clusters dentro de grupos densos onde todos compartilham a mesma informação. Laços fracos fazem ponte entre clusters, permitindo que informação nova flua.
22
+
23
+ **Duas hipóteses centrais:**
24
+ 1. Laços fortes se concentram em grupos densamente conectados
25
+ 2. Grupos são conectados por laços fracos esparsos — vitais para difusão
26
+
27
+ **Aplicação em research:** Para entender como uma ideia/tendência se propaga, mapeie os laços fracos (bridges entre comunidades), não apenas os laços fortes (influenciadores dentro de uma comunidade).
28
+
29
+ ## Network Effects: Taxonomia para Pesquisa
30
+
31
+ | Tipo | Definição | Exemplo para Pesquisa |
32
+ |------|-----------|----------------------|
33
+ | **Direct** | Mais usuários = mais valor para todos | Mais usuários de uma plataforma = mais dados para análise |
34
+ | **Indirect** | Mais usuários atraem bens complementares | Mais usuários = mais criadores de conteúdo a monitorar |
35
+ | **Cross-side** | Grupo A beneficia Grupo B | Mais compradores = mais vendedores a estudar |
36
+ | **Same-side** | Grupo beneficia a si mesmo | Mais respondentes = pesquisa mais representativa |
37
+ | **Data** | Mais uso = algoritmos melhores | Mais buscas = melhores insights de intenção |
38
+ | **Local** | Network effects dentro de sub-clusters | Comunidade de nicho tem mais relevância que plataforma geral |
39
+
40
+ ## Leis Matemáticas de Redes
41
+
42
+ ### Metcalfe's Law
43
+ **V = n²** (onde V = valor da rede, n = usuários)
44
+
45
+ - Facebook: revenue ao longo de uma década seguiu curva n-squared
46
+ - Implicação para research: uma plataforma com 2x os usuários tem potencialmente 4x o valor como fonte de dados/insights
47
+ - **Limitação:** Assume todas as conexões igualmente valiosas — raramente verdade
48
+
49
+ ### Reed's Law
50
+ **V = 2^n** (redes que formam grupos)
51
+
52
+ - Plataformas que suportam grupos (Discord servers, Facebook Groups, Slack) capturam mais valor
53
+ - Função como limite teórico superior — nunca observado completamente na prática
54
+ - **Implicação para research:** Plataformas com sub-comunidades têm mais pontos de pesquisa que plataformas com conexões apenas diáticas
55
+
56
+ ### Andrew Chen's Death Spiral
57
+ Network effects funcionam em ambas as direções. Se usuários saem, a rede perde valor → mais usuários saem → aceleração do declínio.
58
+
59
+ **Implicação para research:** Monitorar saúde de comunidades é crítico. Métricas de saída antecipam declínio antes que seja evidente nos dados de crescimento.
60
+
61
+ ## Social Graph Analysis em Prática
62
+
63
+ ### Modelos de Grafo por Plataforma
64
+
65
+ | Plataforma | Modelo de Grafo | Característica-Chave |
66
+ |------------|----------------|---------------------|
67
+ | Reddit | Bipartite (usuários ↔ subreddits) | Routing de conteúdo por assinatura |
68
+ | Discord | Hierárquico (servers → categories → channels) | Controle de acesso por role |
69
+ | Stack Overflow | Tripartite (usuários ↔ perguntas ↔ tags) | Clustering de expertise por tag |
70
+ | LinkedIn | Degrees of connection (1st, 2nd, 3rd) | Alcance profissional por grau |
71
+ | Twitter/X | Directed (follow) + Undirected (mentions) | Influência assimétrica |
72
+
73
+ ### Algoritmos de Detecção de Comunidade
74
+ - **Louvain Method:** Detecta clusters por maximização de modularidade — bom para comunidades grandes
75
+ - **Label Propagation:** Rápido e escalável — cada nó adota label mais comum de seus vizinhos
76
+ - **Girvan-Newman:** Remove arestas de maior betweenness progressivamente — revela hierarquia de comunidades
77
+
78
+ ### Métricas de Grafo para Research
79
+
80
+ | Métrica | O Que Indica | Uso em Research |
81
+ |---------|-------------|-----------------|
82
+ | **Degree Centrality** | Quantas conexões diretas um nó tem | Identificar influenciadores/hubs |
83
+ | **Betweenness Centrality** | Quantas vezes um nó está no caminho entre outros | Identificar brokers de informação |
84
+ | **Closeness Centrality** | Distância média para todos os outros nós | Identificar nós com acesso rápido à rede |
85
+ | **PageRank** | Importância considerando quem aponta para o nó | Ranquear influência em redes direcionadas |
86
+ | **Clustering Coefficient** | Quão conectados estão os vizinhos de um nó | Detectar echo chambers |
87
+
88
+ ## Algoritmos de Ranking de Conteúdo em Comunidades
89
+
90
+ ### Reddit Hot Algorithm
91
+ ```
92
+ hot_score = log10(max(|score|, 1)) * sign(score) + (timestamp / 45000)
93
+ ```
94
+ - Score = upvotes - downvotes
95
+ - **Propriedades:** Scaling logarítmico de votos; tempo nunca decresce; half-life de 12.5 horas
96
+ - **Para research:** Os primeiros votos têm impacto desproporcional — posts virais não são necessariamente os melhores
97
+
98
+ ### Hacker News Gravity Algorithm
99
+ ```
100
+ score = (P - 1) / (T + 2)^G
101
+ ```
102
+ - P = pontos, T = horas desde submissão, G = gravity (default 1.8)
103
+ - **Propriedades:** Decaimento ativo ao longo do tempo; tunable gravity
104
+ - **Para research:** Conteúdo técnico/nicho tem vida mais longa que HN do que em Reddit
105
+
106
+ ### Wilson Score Interval (Stack Overflow Best Sort)
107
+ Ranqueia pelo limite inferior do intervalo de confiança para aprovação real:
108
+ - Corrige para amostras pequenas: 5 upvotes/0 downvotes pode superar 100 upvotes/40 downvotes
109
+ - **Para research:** Melhor proxy de "qualidade real" que simples contagem de votos
110
+
111
+ ## Métodos de Pesquisa de Comunidade
112
+
113
+ ### Digital Ethnography
114
+ Observação sistemática de comunidades online:
115
+ 1. **Lurking phase:** 2-4 semanas observando sem intervir — entender normas, gírias, hierarquias
116
+ 2. **Mapping phase:** Identificar key contributors, hubs, tipos de conteúdo, horários de pico
117
+ 3. **Analysis phase:** Classificar interações, tensões, padrões emergentes
118
+ 4. **Validation phase:** Confirmar interpretações com membros da comunidade (se aplicável)
119
+
120
+ ### Netnografia (Kozinets 2002, atualizado 2020)
121
+ Adaptação da etnografia para ambientes digitais:
122
+ - Imersão cultural (participar genuinamente)
123
+ - Coleta de dados naturais (não interferir no comportamento)
124
+ - Interpretação cultural (entender significado, não apenas frequência)
125
+ - **Diferencial:** Captura como comunidades criam significado, não apenas o que dizem
126
+
127
+ ### Community Health Monitoring
128
+ Métricas para monitorar saúde de uma comunidade ao longo do tempo:
129
+
130
+ | Métrica | Sinal Saudável | Sinal de Alerta |
131
+ |---------|---------------|-----------------|
132
+ | DAU/MAU ratio | >15% | <5% |
133
+ | D1 retention | >40% | <20% |
134
+ | D7 retention | >25% | <10% |
135
+ | Post/member ratio | Crescendo | Declinando 3+ semanas |
136
+ | Response rate | >60% de posts respondidos | <30% |
137
+ | Moderator actions | Estável | Crescente aceleradamente |
138
+
139
+ ## Trust e Reputação em Comunidades
140
+
141
+ ### Discourse Trust Levels (Gold Standard)
142
+
143
+ | Level | Nome | Como Ganho | Privilégios-Chave |
144
+ |-------|------|-----------|-------------------|
145
+ | TL0 | New | Default | Ações básicas |
146
+ | TL1 | Basic | Ler tópicos, tempo no site | PMs, flags |
147
+ | TL2 | Member | Participação ativa (semanas) | Convites, wiki posts |
148
+ | TL3 | Regular | Participação sustentada (meses) | Recategorizar, mover tópicos; auto-revogado se cair |
149
+ | TL4 | Leader | Concedido por admins | Poderes totais de moderação |
150
+
151
+ **Insight para research:** Trust levels são o melhor proxy para qualidade de contributor. Análise de TL3+ revela comunidade "real" de especialistas.
152
+
153
+ ### Stack Overflow Reputation-Privilege Model
154
+ - +10 por upvote em resposta; +15 por accepted answer
155
+ - Cap de 200 rep/dia (previne grinding)
156
+ - Privilégios progressivos: 15 rep → upvote; 125 rep → downvote; 2,000 → editar qualquer post
157
+
158
+ **Insight para research:** Reputação de 1,000+ indica expertise genuína. Padrões de upvote revelam consenso técnico da comunidade.
159
+
160
+ ## Fontes de Dados para Community Research
161
+
162
+ ### APIs Oficiais
163
+ - **Reddit API:** Free tier limitado (100 req/min); dados históricos via Pushshift (parcialmente disponível)
164
+ - **Stack Exchange API:** API pública, 10,000 req/dia sem auth
165
+ - **Discord:** Apenas próprios servers via bot
166
+ - **GitHub API:** Issues, discussions, contribution graphs
167
+
168
+ ### Ferramentas de Análise
169
+ | Ferramenta | Foco | Gratuito? |
170
+ |-----------|------|-----------|
171
+ | Brandwatch | Social listening enterprise | Não |
172
+ | Pulsar | Audience intelligence | Não |
173
+ | SparkToro | Audience research (onde passam tempo) | Parcialmente |
174
+ | Followerwonk | Twitter/X análise | Parcialmente |
175
+ | Social Blade | YouTube/Twitch stats | Sim |
176
+
177
+ ### Dados Estruturados Públicos
178
+ - **Reddit:** Subreddit stats via third-party (Subreddit Stats, Redditmetis)
179
+ - **Stack Overflow:** Data Explorer (SEDE) — queries SQL completas em dados públicos
180
+ - **GitHub:** Trending repositories, dependency graphs públicos
181
+
182
+ ## Armadilhas em Community Research
183
+
184
+ | Armadilha | Descrição | Mitigação |
185
+ |-----------|-----------|-----------|
186
+ | Vocal minority | 1% cria conteúdo, 9% reage, 90% lurka | Complementar com surveys representativos |
187
+ | Platform sample bias | Comunidade Reddit ≠ mercado geral | Triangular com dados offline/outros canais |
188
+ | Survivorship | Só vê comunidades ativas, não as que morreram | Incluir análise de comunidades fracassadas |
189
+ | Gaming detection | Bots, coordenação artificial, astroturfing | Verificar padrões de criação de conta, timing de posts |
190
+ | Temporal drift | Normas de comunidades mudam rapidamente | Análise longitudinal, não snapshots únicos |
191
+
192
+ ---
193
+
194
+ *Knowledge base da squad-research | Fonte: MS-010 Forum & Community Platform Engineering*
@@ -0,0 +1,168 @@
1
+ # Mixed Methods Research Design
2
+
3
+ > Framework para combinar métodos qualitativos e quantitativos em pesquisas integradas. Maximiza validade e riqueza de insights.
4
+
5
+ ## Por Que Mixed Methods
6
+
7
+ Nenhum método é superior — são complementares:
8
+
9
+ | Qualitativo | Quantitativo |
10
+ |-------------|--------------|
11
+ | Responde "por que?" e "como?" | Responde "quantos?" e "com que frequência?" |
12
+ | Profundidade de compreensão | Generalização para população |
13
+ | Hipóteses emergentes | Teste de hipóteses |
14
+ | Significado e contexto | Prevalência e magnitude |
15
+ | N pequeno, riqueza alta | N grande, profundidade limitada |
16
+
17
+ **Mixed Methods:** Usa ambos de forma integrada, com design que maximiza a contribuição de cada um.
18
+
19
+ ## Os 4 Designs Principais
20
+
21
+ ### Design 1: Exploratório Sequencial (QUAL → QUAN)
22
+
23
+ ```
24
+ Pesquisa Qualitativa
25
+ → Gerar hipóteses e dimensões
26
+ → Construir survey/instrumento quantitativo
27
+ → Validar em escala
28
+ → Quantificar e generalizar
29
+ ```
30
+
31
+ **Quando usar:** Campo pouco estudado, não há framework ou instrumento validado.
32
+
33
+ **Exemplo:** Entrevistas com 15 early adopters → identificar 5 dimensões de valor → survey com 500 usuários para medir importância de cada dimensão.
34
+
35
+ **Timing:** Qualitativo antes de decidir o que medir quantitativamente.
36
+
37
+ ### Design 2: Explanatório Sequencial (QUAN → QUAL)
38
+
39
+ ```
40
+ Pesquisa Quantitativa (survey, analytics)
41
+ → Identificar padrões, segmentos ou outliers
42
+ → Pesquisa Qualitativa com casos específicos
43
+ → Explicar os mecanismos por trás dos números
44
+ ```
45
+
46
+ **Quando usar:** Dados quantitativos geraram resultado surpreendente ou segmento interessante que precisa de explicação.
47
+
48
+ **Exemplo:** Análise de cohort identifica que usuários de segunda-feira retêm 40% mais → entrevistas com usuários de segunda-feira para entender por quê.
49
+
50
+ **Timing:** Quantitativo guia a amostragem qualitativa.
51
+
52
+ ### Design 3: Convergente (Paralelo)
53
+
54
+ ```
55
+ Pesquisa Qualitativa + Pesquisa Quantitativa
56
+ (simultâneas, independentes)
57
+ ↓ ↓
58
+ Resultados Resultados
59
+
60
+ Triangulação
61
+
62
+ Integração e Interpretação
63
+ ```
64
+
65
+ **Quando usar:** Quer comparar perspectivas de profundidade com dados de escala.
66
+
67
+ **Exemplo:** Entrevistas com 20 clientes + survey com 400 clientes executados em paralelo → comparar temas emergentes vs. métricas de satisfação.
68
+
69
+ **Força:** Achados que convergem = maior confiança. Divergências = campo fértil para investigação.
70
+
71
+ ### Design 4: Transformativo/Embedded
72
+
73
+ ```
74
+ Pesquisa Principal (QUAN ou QUAL)
75
+ Embutida: pesquisa secundária do outro tipo em fase específica
76
+ ```
77
+
78
+ **Quando usar:** Uma abordagem é claramente dominante mas precisa de complementação em fase específica.
79
+
80
+ **Exemplo:** RCT (principal quantitativo) com entrevistas qualitativas embutidas na fase de análise de processo.
81
+
82
+ ## Triangulação: Como Executar
83
+
84
+ Triangulação é o processo de convergir múltiplas fontes de evidência para validar achados.
85
+
86
+ ### Tipos de Triangulação
87
+
88
+ | Tipo | O Que É | Exemplo |
89
+ |------|---------|---------|
90
+ | **Metodológica** | Mesmo fenômeno, métodos diferentes | Entrevista + survey + analytics |
91
+ | **Fontes** | Mesma metodologia, fontes diferentes | Clientes + não-clientes + churned |
92
+ | **Analista** | Mesmo material, analistas diferentes | 2 pessoas codificam as mesmas entrevistas |
93
+ | **Teórica** | Interpretar dados com frameworks diferentes | Grounded theory + JTBD + HMW |
94
+
95
+ ### Protocolo de Triangulação
96
+
97
+ 1. Completar análise de cada fonte/método **independentemente**
98
+ 2. Documentar achados de cada fonte **antes** de comparar
99
+ 3. Mapear: Onde convergem? Onde divergem?
100
+ 4. Interpretação:
101
+ - **Convergência:** Alta confiança — múltiplas janelas para mesma realidade
102
+ - **Divergência:** Investigar — pode indicar facetas diferentes ou viés em uma fonte
103
+ - **Complementaridade:** Fontes diferentes iluminam aspectos diferentes — integrar
104
+
105
+ ## Integration Points: Onde Conectar Qual-Quan
106
+
107
+ | Momento | Decisão de Integração | Exemplo |
108
+ |---------|----------------------|---------|
109
+ | **Design** | Como o qualitativo informa o instrumento quantitativo? | Dimensões de entrevista → perguntas de survey |
110
+ | **Amostragem** | Como o quantitativo seleciona casos para qualitativo? | Segmentos extremos para deep-dive |
111
+ | **Análise** | Como dados são analisados em conjunto? | Joint Display tables |
112
+ | **Interpretação** | Como os achados são discutidos integradamente? | Quando convergem/divergem: o que isso significa? |
113
+
114
+ ## Joint Display: Ferramenta de Integração Visual
115
+
116
+ Matriz que coloca achados qualitativos e quantitativos lado a lado para comparação:
117
+
118
+ | Tema/Segmento | Achado Qualitativo | Achado Quantitativo | Convergência? |
119
+ |--------------|-------------------|--------------------:|:-------------:|
120
+ | Friction no onboarding | "Não entendi o primeiro passo" (8/15 participantes) | Taxa de completion: 34% | Convergente |
121
+ | Valor percebido | "Economizo 3h por semana" (maioria) | NPS: 72 | Convergente |
122
+ | Feature X | "Nunca usei, não sei para quê serve" (6/15) | Usage: 8% dos usuários | Convergente |
123
+ | Suporte | "Atendimento excelente" (4/15) | CSAT suporte: 58 | Divergente → investigar |
124
+
125
+ ## Research Design Matrix: Selecionando o Design
126
+
127
+ | Pergunta de Research | Design Recomendado | Razão |
128
+ |---------------------|-------------------|-------|
129
+ | "Por que churnam?" | Explanatório seq. (QUAN→QUAL) | Dados de churn guiam entrevistas |
130
+ | "O que valorizamos em produto novo?" | Exploratório seq. (QUAL→QUAN) | Não há dimensões pré-definidas |
131
+ | "Nossas personas refletem realidade?" | Convergente | Validar modelo existente |
132
+ | "Qual mensagem funciona melhor?" | QUAN principal (A/B) + QUAL embutido | A/B mede resultado, qual explica mecanismo |
133
+ | "Como usuários experienciam X?" | QUAL dominante | Questão de significado, não de frequência |
134
+ | "Qual o tamanho do problema Y?" | QUAN dominante | Questão de prevalência |
135
+
136
+ ## Rigor em Mixed Methods
137
+
138
+ ### Qualidade Específica do Design Misto
139
+
140
+ | Critério | Definição | Como Demonstrar |
141
+ |----------|-----------|-----------------|
142
+ | **Legitimação** | Os insights integrados são mais robustos que cada método isolado? | Mostrar convergência/complementaridade explícita |
143
+ | **Completude** | A integração aborda a questão de research melhor que um método único? | Documentar o que cada método contribuiu |
144
+ | **Fidelidade** | Cada método foi executado com rigor próprio? | Critérios de cada método respeitados |
145
+ | **Transformação** | A combinação gerou insights que nenhum método geraria sozinho? | Destacar insights que emergiram só da integração |
146
+
147
+ ## Template de Report Mixed Methods
148
+
149
+ ```
150
+ ## Métodos
151
+ ### Design: [Tipo de mixed methods design]
152
+ ### Fase 1 ([Qual/Quan]): [Descrição breve, n, ferramentas]
153
+ ### Fase 2 ([Qual/Quan]): [Descrição breve, n, ferramentas]
154
+ ### Integração: [Como os resultados foram combinados]
155
+
156
+ ## Resultados
157
+ ### Achados [Qual/Quan]: [Resultados de cada fase separadamente]
158
+ ### Integração: [Joint Display ou narrativa integrando os dois]
159
+
160
+ ## Interpretação Integrada
161
+ ### Convergências: [O que ambos os métodos confirmam]
162
+ ### Divergências: [Onde diferem e o que isso indica]
163
+ ### Insights emergentes da integração: [O que só foi possível ver ao combinar]
164
+ ```
165
+
166
+ ---
167
+
168
+ *Knowledge base da squad-research*
@@ -0,0 +1,192 @@
1
+ # Network Effects Analysis
2
+
3
+ > Extraído e sintetizado de MS-010 Forum & Community Platform Engineering (2026). Cobre Metcalfe's Law, Reed's Law, Chen's Death Spiral e frameworks aplicados para pesquisa de mercado e análise competitiva.
4
+
5
+ ## Por Que Network Effects Importam para Research
6
+
7
+ Network effects são o moat primário de plataformas comunitárias e muitos mercados digitais. Uma plataforma com network effects cria dinâmicas de winner-take-all que são quase impossíveis de superar uma vez estabelecidas. Entender e medir network effects é essencial para:
8
+
9
+ - **Análise competitiva:** Identificar se um competidor tem moat de network effects
10
+ - **Market sizing:** Estimar potencial de crescimento não-linear
11
+ - **Risco de entrada:** Avaliar viabilidade de entrar em mercado com forte network effects
12
+ - **Pesquisa de crescimento:** Identificar onde uma plataforma está no ciclo
13
+
14
+ ## As Três Leis Fundamentais
15
+
16
+ ### Metcalfe's Law
17
+ **V = n²**
18
+
19
+ O valor de uma rede é proporcional ao quadrado do número de usuários conectados.
20
+
21
+ **Base empírica:** Facebook's revenue ao longo de uma década seguiu closely a curva n-squared — enquanto a base de usuários dobrava, o revenue quadruplicava.
22
+
23
+ **Quando usar:**
24
+ - Avaliar valor potencial de plataformas de comunicação (ex: WhatsApp, Slack)
25
+ - Comparar redes de tamanho diferente
26
+ - Modelar potencial de crescimento de marketplaces bilaterais
27
+
28
+ **Limitação crítica:** Assume que TODA conexão é igualmente valiosa — raramente verdade. Usuários inativos ou irrelevantes não adicionam valor real.
29
+
30
+ **Versão corrigida (Briscoe et al.):** V = n × log(n) — mais realista, ainda supralinear mas não quadrática.
31
+
32
+ ### Reed's Law
33
+ **V = 2^n**
34
+
35
+ O valor de redes que formam grupos cresce exponencialmente porque o número de subgrupos possíveis escala como 2^n.
36
+
37
+ **Aplicação:** Plataformas que suportam sub-comunidades e grupos (Discord servers, Facebook Groups, Slack workspaces) capturam mais valor que plataformas limitadas a conexões diáticas.
38
+
39
+ **Caveats importantes:**
40
+ - Reed's Law nunca foi observado completamente em dados reais de mercado
41
+ - Funciona como limite teórico superior
42
+ - Na prática, grupos têm qualidade muito heterogênea
43
+
44
+ **Implicação para research:** "Plataformas que habilitam formação de grupos capturam mais valor que plataformas limitadas a conexões individuais" — esta versão qualitativa é suportada empiricamente mesmo que a fórmula exata não seja.
45
+
46
+ ### Andrew Chen's Death Spiral
47
+ O inverso de network effects: se usuários saem, a rede perde valor → mais usuários saem → declínio acelera.
48
+
49
+ ```
50
+ Saída de usuários
51
+ → Rede menos valiosa
52
+ → Mais saídas
53
+ → Aceleração do declínio
54
+ → Colapso (se não interrompido)
55
+ ```
56
+
57
+ **Contexto empírico:** MySpace, Google+, Vine — todos sofreram Death Spiral uma vez que a saída começou.
58
+
59
+ **Early warning signals:**
60
+ - DAU/MAU ratio em declínio por 3+ semanas consecutivas
61
+ - Post rate por usuário ativo diminuindo
62
+ - Proportion de usuários que apenas lurking (sem criação) aumentando
63
+ - Moderador volume de ações aumentando (sinal de deterioração de qualidade)
64
+
65
+ ## Tipos de Network Effects: Taxonomia Aplicada
66
+
67
+ | Tipo | Definição | Como Medir | Exemplos |
68
+ |------|-----------|-----------|---------|
69
+ | **Direct (same-side)** | Mais usuários = mais valor para usuários existentes | DAU × engajamento por usuário | WhatsApp, Telegram |
70
+ | **Indirect (cross-side)** | Mais do Grupo A beneficia Grupo B | Correlação supply×demand, match rate | Uber (drivers↔riders), Airbnb |
71
+ | **Data effects** | Mais uso = algoritmos melhores | Accuracy improvement vs data volume | Spotify (recomendações), Netflix |
72
+ | **Local** | Efeitos dentro de sub-clusters, não toda rede | Engajamento por subreddit/grupo | Reddit (por subreddit), Discord |
73
+ | **Compatibility** | Valor de interoperabilidade com outras redes | Adoção de standards | USB, Bluetooth |
74
+
75
+ ## K-Factor: Coeficiente Viral
76
+
77
+ ```
78
+ K = i × c
79
+ ```
80
+ - **i** = número de convites que cada usuário envia
81
+ - **c** = taxa de conversão de cada convite
82
+
83
+ | K | Dinâmica | Interpretação |
84
+ |---|----------|---------------|
85
+ | K > 1 | Crescimento exponencial | Cada usuário traz mais de 1 novo usuário |
86
+ | K = 1 | Crescimento linear | Cada usuário traz exatamente 1 |
87
+ | K < 1 | Crescimento sub-linear | Requer aquisição externa para sustentar |
88
+
89
+ **Realidade:** K > 1 puro é extremamente raro e geralmente insustentável. A maioria dos produtos de sucesso tem K entre 0.2-0.8 e combina virality com outros canais.
90
+
91
+ **Exemplo calculado:** 100 usuários × 3 convites × 60% conversão = K=1.8 → 180 novos usuários → 324 → 583... (exponencial)
92
+
93
+ ## Growth Loops: Tipos e Mecânicas
94
+
95
+ ### 1. Content-SEO Loop (mais sustentável)
96
+ ```
97
+ Usuário cria conteúdo → Google indexa → Busca encontra → Novo usuário converte
98
+ → Novo usuário cria conteúdo → [repete]
99
+ ```
100
+ - Stack Overflow domina busca de programação por este loop
101
+ - **Dados 2023-2024:** Reddit cresceu +1,328% em visibilidade SEO após updates do Google
102
+ - **Atenção 2025:** E-E-A-T updates corrigiram parcialmente. Qualidade > volume.
103
+
104
+ ### 2. Invite/Referral Loop
105
+ ```
106
+ Usuário desfruta → Convida amigos → Amigos entram → Comunidade mais valiosa → [repete]
107
+ ```
108
+ - Referral programs: 10-30% conversão, às vezes >50%
109
+ - Melhor combinado com virality orgânica
110
+
111
+ ### 3. Creator-Audience Loop
112
+ ```
113
+ Criador constrói comunidade → Promove para audiência → Audiência entra
114
+ → Membros criam conteúdo → Conteúdo atrai novos → [repete]
115
+ ```
116
+ - Modelo Circle/Mighty Networks: 88% criadores usando memberships pagas
117
+
118
+ ### 4. Data Loop
119
+ ```
120
+ Uso gera dados → Dados melhoram produto → Produto atrai mais uso → [repete]
121
+ ```
122
+ - Típico de plataformas de ML/IA e search engines
123
+
124
+ ## Retenção como Fundação do Growth
125
+
126
+ **Andrew Chen:** "O melhor jeito de impulsionar crescimento viral é aumentar retenção e engajamento." Crescimento viral sem retenção é um balde furado.
127
+
128
+ ### Benchmarks de Retenção
129
+
130
+ | Métrica | Benchmark Saudável | Benchmark Problema |
131
+ |---------|-------------------|--------------------|
132
+ | D1 retention | 40-60% | <20% |
133
+ | D7 retention | 20-35% | <10% |
134
+ | D30 retention | 10-20% | <5% |
135
+ | 90-day retention | 5-15% | <2% |
136
+
137
+ ## Framework de Análise Competitiva de Network Effects
138
+
139
+ ### Para cada competidor, avaliar:
140
+
141
+ 1. **Tipo de network effect presente?**
142
+ - Direct / Indirect / Data / Local / None
143
+
144
+ 2. **Intensidade do moat?** (1-5)
145
+ - 1 = Fácil de substituir | 5 = Lock-in extremo
146
+
147
+ 3. **Ponto do ciclo?**
148
+ - Early traction → Network density → Critical mass → Dominant → Declining
149
+
150
+ 4. **Switching costs combinados?**
151
+ - Network effects + switching costs = moat duplo (muito difícil de superar)
152
+
153
+ 5. **Vulnerabilidades?**
154
+ - Subrede específica atacável? (ex: entrar em nicho antes de escalar)
155
+ - Death spiral iniciando? (métricas de saúde deteriorando?)
156
+
157
+ ### Template de Análise
158
+
159
+ ```
160
+ Empresa: [Nome]
161
+ Network Effect Type: [Direct / Indirect / Data / Local / Multi-sided]
162
+ Moat Strength: [1-5]
163
+ Evidence: [Dados que suportam avaliação]
164
+ Cycle Position: [Early / Growing / Dominant / Declining]
165
+ Vulnerability: [Como atacar este network effect?]
166
+ Death Spiral Risk: [LOW / MEDIUM / HIGH — com evidências]
167
+ ```
168
+
169
+ ## Medindo Network Effects em Pesquisa
170
+
171
+ ### Proxy Metrics
172
+
173
+ | Métrica | O Que Mede | Como Calcular |
174
+ |---------|-----------|---------------|
175
+ | Engagement Elasticity | Engajamento aumenta com tamanho da rede? | Correlação usuários × atividade por usuário |
176
+ | Connection Value | Valor médio de uma conexão adicional | ARPU vs. density de rede |
177
+ | Churn Decay | Usuários com mais conexões churnam menos? | Churn rate por degree centrality |
178
+ | Content Velocity | Mais usuários = mais conteúdo por usuário? | Conteúdo gerado per capita vs. MAU |
179
+
180
+ ### Fontes de Dados para Análise de Network Effects
181
+
182
+ | Fonte | Dados Disponíveis | Acesso |
183
+ |-------|------------------|--------|
184
+ | SEC Filings (empresas US) | MAU, DAU/MAU, cohort retention | Público |
185
+ | App store analytics | Downloads, ratings trends | Público (limitado) |
186
+ | SimilarWeb | Traffic, engagement metrics | Freemium |
187
+ | App Annie/data.ai | Mobile engagement data | Pago |
188
+ | Semrush | SEO visibility + traffic | Freemium |
189
+
190
+ ---
191
+
192
+ *Knowledge base da squad-research | Fonte: MS-010 Forum & Community Platform Engineering*