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
@@ -1,5 +1,5 @@
1
1
  name: squad-copy
2
- version: "1.0.0"
2
+ version: "2.0.0"
3
3
  slashPrefix: SINAPSE
4
4
  author: Caio Imori
5
5
  license: UNLICENSED
@@ -10,17 +10,32 @@ description: >
10
10
 
11
11
  metadata:
12
12
  created: "2026-03-12"
13
+ last_updated: "2026-04-12"
13
14
  author: "Sinapse"
14
15
  tier: 1
15
- total_files: 113
16
- agents: 12
16
+ total_files: 135
17
+ agents: 14
17
18
  tasks: 81
18
19
  workflows: 6
19
- knowledge_bases: 14
20
+ knowledge_bases: 24
20
21
  checklists: 3
21
22
  templates: 7
22
23
  preferences: 1
23
24
 
25
+ changelog:
26
+ - version: "2.0.0"
27
+ date: "2026-04-12"
28
+ story: fw-v2.5
29
+ epic: EPIC-framework-upgrade-v2
30
+ highlights:
31
+ - "Shipped ai-copy-human-loop-canon.md KB — 4-gate decision framework (Trust/Light/Heavy/Scrap) for when AI drafts ship vs when humans intervene. Covers signals per gate, AI prompt library (12 templates mapped to owner agents), production hygiene, integration with existing KBs, anti-patterns."
32
+ - "Raises ai-copy-production.md from capability reference to canonical decision framework."
33
+ - "Reconciled yaml counts to disk reality (agents 12->14, knowledge_bases 14->24, total_files 113->135). Prior drift accumulated over multiple minor releases."
34
+ breaking_changes: []
35
+ deferred_to_follow_up:
36
+ - "AC2 — cross-lingual-conversion-copy.md KB (pt-BR <-> en-US adaptation patterns). Scoped out to ship ai-copy-human-loop-canon at canon quality rather than dilute two KBs."
37
+ - "AC3 — rsa-ads-copy-guide.md standalone stub (RSA character limits, pinning strategy). Lower priority, can ship as follow-up."
38
+
24
39
  quality_standards:
25
40
  reference_authors:
26
41
  - David Ogilvy (advertising fundamentals, Ogilvy on Advertising)
@@ -0,0 +1,193 @@
1
+ # Brand Strategy Models
2
+
3
+ ## Purpose
4
+ Frameworks para construcao, gestao e posicionamento de marca. Da identidade ao valor de marca. Aplicavel tanto a marcas pessoais (Naval's "Productize Yourself", Sinek's "Start With Why") quanto a marcas corporativas.
5
+
6
+ ---
7
+
8
+ ## PART 1: FRAMEWORKS FUNDAMENTAIS DE MARCA
9
+
10
+ ### 1. Golden Circle (Simon Sinek, 2009)
11
+ - **Originator**: Simon Sinek ("Start With Why", TED Talk 2009 — 3rd most watched)
12
+ - **When to Use**: Articular proposito de marca; desenvolver comunicacao; liderar com inspiracao; onboarding de equipe
13
+ - **How to Apply**:
14
+ **Estrutura concentrica** (de dentro para fora):
15
+ - **WHY** (centro): Por que a empresa existe? Qual a crenca? O que a motiva alem do lucro?
16
+ - **HOW** (meio): Como a empresa realiza seu WHY? Valores, diferenciais, processos
17
+ - **WHAT** (exterior): O que a empresa produz? Produtos, servicos, resultados
18
+
19
+ **Lei**: "People don't buy what you do, they buy why you do it"
20
+
21
+ **Processo para descobrir o WHY**:
22
+ 1. Colete 10-15 historias de momentos em que voce se orgulhou mais da empresa/produto
23
+ 2. Identifique os temas recorrentes (contribuicao + impacto)
24
+ 3. Formule: "Para [contribuicao], de forma que [impacto]"
25
+ 4. Teste: ressoa internamente com os fundadores? Explica por que voces existem?
26
+
27
+ **Exemplos**:
28
+ - Apple WHY: "Challengar o status quo e pensar diferente"
29
+ - Patagonia WHY: "Usar o negocio para proteger o planeta"
30
+ - TED WHY: "Ideias que mudam o mundo merecem ser compartilhadas"
31
+ - **Example Application**: SaaS de RH: WHAT = software de gestao de pessoas. HOW = interface simples, suporte humanizado, dados em tempo real. WHY = "Acreditar que todo profissional merece ser visto e desenvolvido, nao apenas gerenciado." Comunicacao centrada no WHY gera identificacao emocional que produto centrado no WHAT nao consegue.
32
+ - **Key Metrics**: Brand awareness vs. brand affinity; NPS (quando WHY ressoa, NPS sobe organicamente); recrutamento (candidatos ideais procuram a empresa proativamente)
33
+ - **Cross-References**: Just Cause (Sinek), Responsible Company (Chouinard), Purpose-Profit Alignment
34
+
35
+ ---
36
+
37
+ ### 2. Kapferer Brand Identity Prism (Jean-Noel Kapferer, 1986)
38
+ - **Originator**: Jean-Noel Kapferer (HEC Paris)
39
+ - **When to Use**: Diagnosticar inconsistencias de marca; alinhar equipes em torno de identidade comum; redesign de marca
40
+ - **How to Apply**:
41
+ **6 facetas do prisma**:
42
+ - **Physique** (emissor-externo): Caracteristicas fisicas e simbolos icônicos (logo, cores, forma)
43
+ - **Personality** (emissor-interno): Carater, tom de voz, como a marca "fala"
44
+ - **Culture** (emissor-interno): Valores, principios, origem da marca
45
+ - **Relationship** (receptor-externo): Tipo de relacao que a marca estabelece com o cliente
46
+ - **Reflection** (receptor-externo): Imagem do cliente-tipo refletida pela marca
47
+ - **Self-Image** (receptor-interno): Como o cliente se sente ao usar a marca
48
+
49
+ **Processo**:
50
+ 1. Preencha cada faceta do estado atual (percepção real)
51
+ 2. Preencha cada faceta do estado desejado (aspiracional)
52
+ 3. Identifique os gaps (onde a marca nao entrega o que promete)
53
+ 4. Priorize as facetas mais desalinhadas para correcao
54
+ - **Example Application**: Nike: Physique (swoosh, "Just Do It", cores). Personality (provocadora, competitiva, inspiradora). Culture (atletismo americano, superacao). Relationship (mentor/coach que desafia). Reflection (atleta dedicado). Self-Image (eu sou capaz, eu posso mais). Todo touchpoint de marca deve reforcar todas as 6 facetas.
55
+ - **Key Metrics**: Brand consistency score (pesquisa de percepcao vs. desejado); brand tracking por faceta
56
+ - **Cross-References**: Golden Circle, Aaker Brand Equity, Brand Positioning Matrix
57
+
58
+ ---
59
+
60
+ ### 3. Aaker Brand Equity Model (David Aaker, 1991)
61
+ - **Originator**: David Aaker (UC Berkeley Haas; "Managing Brand Equity", 1991)
62
+ - **When to Use**: Medir e gerenciar o valor da marca; justificar investimento em marca para o board; M&A brand valuation
63
+ - **How to Apply**:
64
+ **5 dimensoes do Brand Equity**:
65
+ 1. **Brand Loyalty**: Quantos clientes voltam por fidelidade a marca (nao por preco)?
66
+ 2. **Brand Awareness**: Qual a consciencia da marca? (Top of mind, aided recall, brand recognition)
67
+ 3. **Perceived Quality**: Como a qualidade percebida se compara a concorrentes?
68
+ 4. **Brand Associations**: Quais associacoes os clientes fazem? (Positivas? Diferenciadoras?)
69
+ 5. **Other Brand Assets**: Patentes, relacionamentos de canal, propriedade intelectual
70
+
71
+ **Brand Equity Score**:
72
+ Score ponderado = (Loyalty × 30%) + (Awareness × 20%) + (Quality × 25%) + (Associations × 15%) + (Assets × 10%)
73
+
74
+ **Drivers de valor financeiro**:
75
+ - Alta brand equity = pricing power (preco premium vs. genericos)
76
+ - Alta brand equity = CAC menor (aquisicao mais facil)
77
+ - Alta brand equity = LTV maior (menor churn, mais upgrades)
78
+ - **Example Application**: Amazon: Loyalty (Prime = 200M membros pagantes). Awareness (quase 100% nos mercados em que opera). Quality (melhor logistica, mais selecao). Associations (conveniencia, confianca, variedade). Brand equity construido ao longo de 25 anos — impossivel de replicar rapidamente.
79
+ - **Key Metrics**: NPS como proxy de loyalty; unaided brand recall; pricing premium vs. categoria; CAC tendencia ao longo do tempo
80
+ - **Cross-References**: Kapferer Prism, Golden Circle, Moat Analysis (Munger — brand e um tipo de moat)
81
+
82
+ ---
83
+
84
+ ### 4. Brand Positioning Matrix / STP Framework
85
+ - **Originator**: Philip Kotler (STP: Segmentation-Targeting-Positioning); Geoffrey Moore (posicionamento de tech)
86
+ - **When to Use**: Definir ou revisar posicionamento; entrar em novos mercados; reposicionar marca existente
87
+ - **How to Apply**:
88
+ **STP Framework**:
89
+ 1. **Segmentation**: Divida o mercado em grupos com necessidades homogeneas
90
+ - Demografico (idade, renda, genero)
91
+ - Psicografico (valores, lifestyle, personalidade)
92
+ - Comportamental (uso, lealdade, beneficio buscado)
93
+ - Geografico
94
+ 2. **Targeting**: Avalie atratividade de cada segmento (tamanho, crescimento, concorrencia, alinhamento)
95
+ - Escolha 1-3 segmentos para focar
96
+ 3. **Positioning**: Defina como quer ser percebido no segmento escolhido
97
+ - Formula de posicionamento: "Para [target], [marca] e o [frame of reference] que [ponto de diferenca] porque [reason to believe]"
98
+
99
+ **Positioning Statement example**:
100
+ "Para profissionais criativos que precisam de producao visual rapida, Canva e a plataforma de design que democratiza a criatividade visual profissional porque tem 500K+ templates, colaboracao em tempo real, e zero curva de aprendizado."
101
+ - **Example Application**: Nespresso: Segmentos: consumidores de cafe premium em casa + profissionais ocupados. Target: afluentes, 30-55, valorizam qualidade e conveniencia. Positioning: "cafe de alta qualidade como no melhor café, na comodidade de casa, em 30 segundos." Frame: coffee ritual. Diferenca: quality + convenience. RTB: tecnologia de capsula patentada + colaboracao com George Clooney (lifestyle aspiration).
102
+ - **Key Metrics**: Aderencia ao posicionamento (pesquisa de percepcao); Share of Voice no segmento; premium de preco vs. categoria
103
+ - **Cross-References**: Golden Circle, TAM/SAM/SOM, Competitive Moats, Blue Ocean
104
+
105
+ ---
106
+
107
+ ## PART 2: BRAND ARCHITECTURE & SCALING
108
+
109
+ ### 5. Brand Architecture Frameworks
110
+ - **Originator**: Conceito acadêmico; sistematizado por David Aaker e Kevin Keller
111
+ - **When to Use**: Ao lançar sub-marcas ou produtos; ao fazer M&A; ao expandir para novos mercados
112
+ - **How to Apply**:
113
+ **3 Modelos principais**:
114
+
115
+ 1. **Branded House** (ex: Google, Apple, FedEx): Uma marca mestre, todos os produtos sob ela
116
+ - Pro: transferencia de brand equity entre produtos; eficiencia de marketing
117
+ - Contra: risco de contaminacao se um produto falha
118
+
119
+ 2. **House of Brands** (ex: P&G, Unilever, Yum Brands): Cada produto tem sua propria marca
120
+ - Pro: segmentacao precisa; falha de uma marca nao contamina as outras
121
+ - Contra: caro manter multiplas marcas; sem transferencia de equity
122
+
123
+ 3. **Endorsed Brands** (ex: Marriott, Nestle): Marca mae + marcas individuais
124
+ - Pro: flexibilidade + credibilidade da mae
125
+ - Ex: "Marriott Bonvoy" + "Ritz-Carlton by Marriott"
126
+
127
+ **Decision Framework**:
128
+ - Nova oferta e adjacente e complementar? → Branded House (sub-brand)
129
+ - Nova oferta e para segmento completamente diferente? → House of Brands
130
+ - Nova oferta precisa de credibilidade da mae mas tem identidade propria? → Endorsed Brand
131
+ - **Key Metrics**: Brand awareness transfer rate; cross-sell rate entre produtos da casa
132
+ - **Cross-References**: Aaker Brand Equity, Kapferer Prism, Market Segmentation
133
+
134
+ ---
135
+
136
+ ### 6. The 5 Brand Eras Framework (SINAPSE / contexto digital)
137
+ - **Originator**: Sintetizado de evolucao historica do marketing e branding
138
+ - **When to Use**: Diagnosticar em qual era a marca esta operando; definir estrategia digital de marca
139
+ - **How to Apply**:
140
+ **Era 1: Product Era** (1900-1950): A marca = qualidade do produto. "Our soap is 99.9% pure"
141
+ **Era 2: Image Era** (1950-1980): A marca = promessa de estilo de vida. "Marlboro Man"
142
+ **Era 3: Positioning Era** (1980-2000): A marca = territorio mental. "The Challenger Brand vs. Goliath"
143
+ **Era 4: Social Era** (2000-2015): A marca = comunidade e conversacao. User-generated content
144
+ **Era 5: Creator/Trust Era** (2015-hoje): A marca = conteudo autentico + criadores + valores reais
145
+
146
+ **Implicacoes para marca digital hoje**:
147
+ - Autenticidade > perfeicao
148
+ - Criadores > campanhas de massa
149
+ - Comunidade > audience
150
+ - Valores comprovados > valores declarados
151
+ - Dark Social (WhatsApp, DMs) > midia paga
152
+ - **Key Metrics**: Share of Voice em Dark Social; UGC rate; creator partnership ROI; brand search volume organico
153
+ - **Cross-References**: Content Strategy, Purpose-Driven Growth (Chouinard), Golden Circle
154
+
155
+ ---
156
+
157
+ ## PART 3: BRAND EQUITY PESSOAL (Naval / Sinek)
158
+
159
+ ### 7. Personal Brand Framework (Naval Ravikant + Sinek)
160
+ - **Originator**: Naval Ravikant ("Productize Yourself"); James Clear; Gary Vaynerchuk
161
+ - **When to Use**: Construir autoridade e credibilidade profissional; monetizar expertise; criar leverage via reputacao
162
+ - **How to Apply**:
163
+ **Equacao de Naval**: Specific Knowledge × Accountability × Leverage = Personal Brand com Wealth
164
+
165
+ 1. **Specific Knowledge**: Identifique o que so voce pode ensinar — na intersecao de suas experiencias unicas, paixoes, e habilidades que o mundo precisa
166
+ 2. **Public Accountability**: Coloque seu nome em algo de forma publica. Assuma responsabilidade pelos seus pensamentos e outputs
167
+ 3. **Leverage**: Distribua atraves de codigo (produto), media (conteudo), capital (investimento), ou rede
168
+
169
+ **Pilares de construcao**:
170
+ - **Point of View claro**: Qual e sua posicao sobre topicos chave do seu campo? Seja especifico, seja controverso quando necessario
171
+ - **Consistencia**: Publique regularmente. A frequencia construi confianca. "If you're not visible, you're not viable"
172
+ - **Generosidade**: Entregue mais valor do que cobra. A reciprocidade vira ao longo do tempo
173
+ - **Network Effect**: Conecte pessoas de forma generosa — voce se torna o hub de conexoes
174
+
175
+ **Ferramentas**: LinkedIn (B2B), Twitter/X (tech/thought leadership), YouTube (profundidade), Substack/Newsletter (ownership), Podcast (intimidade)
176
+ - **Example Application**: Caio Imori (contexto Astro Brand Studio): Specific Knowledge = intersection de IA + branding + storytelling. Public: publicar casos de uso, frameworks proprios, resultados dos clientes. Leverage: SINAPSE como produto que escala o conhecimento.
177
+ - **Key Metrics**: Inbound leads via personal brand; speaking invites; colaboracoes inbound; preco hora premium vs. mercado
178
+ - **Cross-References**: Productize Yourself (Naval), Golden Circle (Sinek), Specific Knowledge Audit
179
+
180
+ ---
181
+
182
+ ## Quick Reference: Brand Problem → Framework
183
+
184
+ | Problema | Framework Primario | Advisor |
185
+ |----------|--------------------|---------|
186
+ | "Nao sei articular o proposito da marca" | Golden Circle | @simon-sinek |
187
+ | "A marca esta inconsistente entre touchpoints" | Kapferer Prism | Brand audit |
188
+ | "Queremos saber o valor da nossa marca" | Aaker Brand Equity | @charlie-munger |
189
+ | "Precisamos de um posicionamento claro" | STP + Positioning Statement | @peter-thiel |
190
+ | "Lancando sub-marca ou produto" | Brand Architecture | @charlie-munger |
191
+ | "Construindo marca pessoal" | Naval's Personal Brand | @naval-ravikant |
192
+ | "Estamos comoditizando" | Blue Ocean + Kapferer | @peter-thiel |
193
+ | "A marca nao converte" | Brand-to-Performance bridge | @ray-dalio |
@@ -0,0 +1,267 @@
1
+ # Growth Strategy Models
2
+
3
+ ## Purpose
4
+ Frameworks de crescimento para diagnosticar, desenhar e escalar estrategias de aquisicao, retencao e monetizacao. Do MVP ao IPO. Compilado das melhores praticas de growth hacking, product-led growth, e venture-backed scaling.
5
+
6
+ ---
7
+
8
+ ## PART 1: FRAMEWORKS FUNDAMENTAIS DE GROWTH
9
+
10
+ ### 1. Growth Loops Framework (Reforge / Brian Balfour)
11
+ - **Originator**: Brian Balfour (Reforge); articulado em oposicao ao funil tradicional
12
+ - **When to Use**: Diagnosticar como o produto cresce de forma composta; identificar o loop primario do negocio
13
+ - **How to Apply**:
14
+ 1. Identifique os inputs do loop (usuarios, conteudo, dados, capital)
15
+ 2. Mapeie as acoes que transformam inputs em outputs
16
+ 3. Identifique como os outputs alimentam novos inputs (fechamento do loop)
17
+ 4. Meça a "loop velocity" (velocidade de rotacao) e "loop magnitude" (escala)
18
+ 5. Otimize o gargalo do loop, nao as extremidades
19
+
20
+ **Tipos de Growth Loops**:
21
+ - **Viral Loop**: Usuario usa produto → invita outros → novos usuarios usam produto
22
+ - **Content Loop**: Cria conteudo → SEO → novos usuarios → criam mais conteudo
23
+ - **Paid Loop**: Receita → anuncios → novos usuarios pagantes → mais receita
24
+ - **Product Loop**: Usuarios geram dados → produto melhora → mais usuarios
25
+ - **Sales Loop**: Leads → vendas → case studies → mais leads
26
+ - **Example Application**: Dropbox: Upload arquivo (input) → compartilha link com nao-usuario → nao-usuario precisa criar conta → novo usuario → compartilha mais arquivos (viral loop). Identificar que o loop era "share file" (nao "sign up page") direcionou toda a otimizacao para a feature de compartilhamento.
27
+ - **Key Metrics**: Loop cycle time; virality coefficient (K-factor); loop conversion rate
28
+ - **Cross-References**: Network Effects, North Star Metric, AARRR, PLG
29
+
30
+ ---
31
+
32
+ ### 2. North Star Metric Framework (Sean Ellis / Amplitude)
33
+ - **Originator**: Sean Ellis (cunhou "growth hacking"); formalizado por Amplitude
34
+ - **When to Use**: Alinhar toda a empresa em torno de uma unica metrica de valor; priorizar experimentos de growth
35
+ - **How to Apply**:
36
+ 1. Defina o NSM: a metrica que melhor captura o valor que o produto entrega aos usuarios
37
+ 2. Criterios de uma boa NSM:
38
+ - Representa valor real para o usuario (nao vanity metric)
39
+ - Correlaciona com receita no longo prazo
40
+ - Todos na empresa entendem e podem influenciar
41
+ - Lideravel (pode ser melhorada em 30-90 dias)
42
+ 3. Decomponha a NSM em inputs: quais drivers a movem?
43
+ 4. Crie arvore de metricas: NSM → inputs de primeiro nivel → sub-drivers
44
+ 5. Toda equipe de produto/growth tem pelo menos um input que e o seu KPI
45
+
46
+ **Exemplos de NSM por modelo**:
47
+ - Spotify: Tempo ouvindo musica por dia
48
+ - Airbnb: Noites reservadas
49
+ - Facebook: DAU (Daily Active Users)
50
+ - Slack: Mensagens enviadas por organizacao/dia
51
+ - Uber: Viagens por semana
52
+ - HubSpot: Weekly Active Users engajando com pelo menos 3 features
53
+ - **Example Application**: SaaS B2B de automacao: NSM = "Automacoes executadas com sucesso por conta/semana". Inputs: contas ativas, automacoes criadas/conta, taxa de sucesso de execucao. Cada squad tem um input: Onboarding Squad → contas ativas; Product Squad → automacoes criadas; Infra Squad → taxa de sucesso.
54
+ - **Key Metrics**: NSM absoluto; NSM por cohort; NSM growth rate MoM
55
+ - **Cross-References**: OKRs, Growth Loops, AARRR/RARRA, Unit Economics
56
+
57
+ ---
58
+
59
+ ### 3. AARRR / Pirate Metrics (Dave McClure, 500 Startups, 2007)
60
+ - **Originator**: Dave McClure (500 Startups)
61
+ - **When to Use**: Diagnosticar onde o funil esta vazando; priorizar iniciativas de growth
62
+ - **How to Apply**:
63
+ **AARRR Framework**:
64
+ - **Acquisition**: Como usuarios te encontram? (SEO, pago, viral, etc.)
65
+ - **Activation**: Quando tem o "aha moment"? (first value experience)
66
+ - **Retention**: Voltam? (DAU/WAU/MAU, cohort retention curves)
67
+ - **Referral**: Recomendam? (NPS, K-factor, viral coefficient)
68
+ - **Revenue**: Pagam? (conversion, ARPU, LTV)
69
+
70
+ **Processo de diagnostico**:
71
+ 1. Meça cada etapa com conversao clara
72
+ 2. Identifique o maior gap entre etapas
73
+ 3. Essa etapa e seu maior alavanca — foque 80% dos recursos aqui
74
+ 4. Nao otimize Acquisition se Retention esta quebrada
75
+
76
+ **RARRA** (para produtos com retencao como base):
77
+ Retention → Activation → Referral → Revenue → Acquisition
78
+ (Andrew Chen recomenda para SaaS moderno)
79
+ - **Example Application**: App com 10K downloads/mes, 3K ativacoes, 900 retidos em D7, 270 referiram amigos, 135 pagantes. Conversoes: 30% Acquisition→Activation, 30% Activation→Retention. Gap maior: Activation (70% drop). Foco: melhorar onboarding e primeiro valor percebido.
80
+ - **Key Metrics**: Cada etapa do funil; conversao entre etapas; benchmark por canal de aquisicao
81
+ - **Cross-References**: North Star Metric, Growth Loops, Hook Model
82
+
83
+ ---
84
+
85
+ ### 4. Product-Led Growth — PLG (OpenView Partners, 2019)
86
+ - **Originator**: Blake Bartlett (OpenView Venture Partners); livro de Wes Bush (2019)
87
+ - **When to Use**: Quando o produto pode demonstrar valor antes do pagamento; mercados com longa curva de vendas; escalar sem crescer linearmente o time de vendas
88
+ - **How to Apply**:
89
+ **Principios do PLG**:
90
+ 1. **End User Focus**: Venda para o usuario individual, nao apenas para o decisor de compra
91
+ 2. **Value Before Payment**: Freemium, trial, ou tiers gratuitos funcionais
92
+ 3. **Product as Distribution**: O produto se espalha via uso (Slack, Notion, Figma)
93
+ 4. **Bottom-Up Monetization**: Individual paga → empresa adota → enterprise contract
94
+
95
+ **PLG Motion**:
96
+ - Free tier com valor real (nao "feature incompleta")
97
+ - Viral dentro das organizacoes (compartilhar arquivos, convidar membros)
98
+ - PQL (Product Qualified Lead): usuario com sinais de intencao de upgrade
99
+ - Land and Expand: comeca pequeno, cresce o contrato
100
+
101
+ **Quando PLG funciona**: produto com valor imediato e obvio, viralidade natural, mercado amplo (muitos decisores)
102
+ **Quando PLG nao funciona**: produtos complexos com longa implantacao, vendas enterprise-only, sem viralidade natural
103
+ - **Example Application**: Notion: usuario individual cria workspace (free) → compartilha com colegas → equipe toda usa Notion → TI ve o valor → contrato enterprise. O CAC do enterprise foi praticamente zero — o produto vendeu.
104
+ - **Key Metrics**: PQL → Paid conversion; Product Viral Coefficient; Time to Value; Expansion Revenue
105
+ - **Cross-References**: Growth Loops, AARRR, Unit Economics (PLG deve ter LTV/CAC >5x)
106
+
107
+ ---
108
+
109
+ ### 5. Hook Model (Nir Eyal, 2014)
110
+ - **Originator**: Nir Eyal ("Hooked: How to Build Habit-Forming Products")
111
+ - **When to Use**: Desenhar produtos que criam habito; aumentar retencao organica; reduzir churn
112
+ - **How to Apply**:
113
+ **4 fases do Hook**:
114
+ 1. **Trigger**: Externo (notificacao, email, anuncio) → Interno (emocao, pensamento automatico)
115
+ 2. **Action**: A acao mais simples possivel em antecipacao da recompensa (scroll, click, busca)
116
+ 3. **Variable Reward**: Recompensa imprevisivel (feed de noticias, likes, novos matches) — variabilidade cria compulsao
117
+ 4. **Investment**: Usuario investe tempo, dados, ou reputacao — aumenta valor do produto para ele e probabilidade do proximo trigger
118
+
119
+ **Progressao**: Triggers externos funcionam no inicio. O objetivo e criar triggers internos (uso automatico sem estimulo externo).
120
+
121
+ **Teste etico**: O produto melhora a vida do usuario? Voce usaria o produto voce mesmo? Se nao: reconsidere o design do hook.
122
+ - **Example Application**: Twitter: Trigger externo (notificacao de reply) → interno (tedio, ansiedade social). Action: abrir app, scroll infinito. Variable Reward: novo tweet interessante, novo like, novo follower. Investment: escrever tweets (que geram notificacoes para outros).
123
+ - **Key Metrics**: Habitual users rate (% usuarios que voltam sem trigger externo); D1/D7/D30 retention; Trigger→Action conversion
124
+ - **Cross-References**: Retention (AARRR), Feedback Loops (Mental Models), Behavioral Economics
125
+
126
+ ---
127
+
128
+ ## PART 2: FRAMEWORKS DE PRIORIZAÇÃO
129
+
130
+ ### 6. ICE Score (Sean Ellis)
131
+ - **Originator**: Sean Ellis (GrowthHackers)
132
+ - **When to Use**: Priorizar backlog de experimentos de growth rapidamente
133
+ - **How to Apply**:
134
+ ICE Score = Impact × Confidence × Ease (cada um de 1-10)
135
+ - **Impact**: Se funcionar, qual o impacto na North Star Metric? (1=marginal, 10=transformador)
136
+ - **Confidence**: Qual a confianca de que vai funcionar? (1=palpite, 10=validado empiricamente)
137
+ - **Ease**: Qual a facilidade de implementacao? (1=6+ meses, 10=1 dia)
138
+
139
+ **Como usar**:
140
+ 1. Liste todos os experimentos candidatos
141
+ 2. Score cada um (individualmente, depois media do time)
142
+ 3. Ordene por ICE score decrescente
143
+ 4. Execute os top 3 desta semana
144
+ 5. Revise scores mensalmente com novos dados
145
+ - **Example Application**: Experimento A (novo onboarding flow): Impact 8, Confidence 5, Ease 3 = ICE 120. Experimento B (email de reativacao): Impact 5, Confidence 8, Ease 9 = ICE 360. Prioridade: B primeiro — rapido, confiante, impacto decente.
146
+ - **Key Metrics**: Win rate de experimentos (ICE alto deve ter win rate maior); velocidade de experimentos/semana
147
+ - **Cross-References**: RICE Score (alternativa), North Star Metric, AARRR
148
+
149
+ ---
150
+
151
+ ### 7. RICE Score (Intercom, 2016)
152
+ - **Originator**: Sean McBride (Intercom)
153
+ - **When to Use**: Priorizar features e projetos de produto (mais robusto que ICE para product management)
154
+ - **How to Apply**:
155
+ RICE = (Reach × Impact × Confidence) / Effort
156
+ - **Reach**: Quantos usuarios serao afetados em um periodo (ex: por quarter)?
157
+ - **Impact**: Impacto por usuario (0.25=minimo, 0.5=baixo, 1=medio, 2=alto, 3=massivo)
158
+ - **Confidence**: % de confianca na estimativa (100%=total, 80%=alta, 50%=media, 20%=baixa)
159
+ - **Effort**: Person-months de trabalho
160
+ - **Example Application**: Feature A: Reach 2000 usuarios, Impact 3, Confidence 80%, Effort 2 person-months. RICE = (2000×3×0.8)/2 = 2400. Feature B: Reach 500, Impact 2, Confidence 90%, Effort 0.5. RICE = (500×2×0.9)/0.5 = 1800. Feature A vence por RICE mesmo sendo mais trabalhosa.
161
+ - **Key Metrics**: RICE score por feature; velocidade de entrega; impacto realizado vs. estimado (calibracao)
162
+ - **Cross-References**: ICE Score, North Star Metric, OKRs
163
+
164
+ ---
165
+
166
+ ## PART 3: MODELOS DE CRESCIMENTO
167
+
168
+ ### 8. Crossing the Chasm (Geoffrey Moore, 1991)
169
+ - **Originator**: Geoffrey Moore ("Crossing the Chasm", 1991)
170
+ - **When to Use**: Ao sair do mercado early adopter para mainstream; ao diagnosticar stagnacao de crescimento
171
+ - **How to Apply**:
172
+ **Technology Adoption Lifecycle**:
173
+ Innovators (2.5%) → Early Adopters (13.5%) → Early Majority (34%) → Late Majority (34%) → Laggards (16%)
174
+
175
+ **O Chasm**: Gap entre Early Adopters e Early Majority. Early Adopters toleram imperfeicoes; Early Majority nao. Diferentes necessidades, referencias, e linguagem.
176
+
177
+ **Estrategia de Crossing**:
178
+ 1. Escolha um segmento especifico da Early Majority (bowling pin)
179
+ 2. Domine completamente este segmento (nao fragmente)
180
+ 3. Use o segmento dominado como referencia para o proximo
181
+ 4. Repita — como bolas de boliche caindo
182
+
183
+ **Sinais de que voce esta no Chasm**:
184
+ - Crescimento estagnou apos fase inicial
185
+ - Clientes early adoram, mas mainstream nao entende
186
+ - Necessidade de "evangelismo" para cada nova venda
187
+ - **Example Application**: Salesforce (2000): cruzou o chasm focando em SMB (nao enterprise enorme) com modelo SaaS simples. Dominou SMB → usou como prova para Mid-Market → depois Enterprise.
188
+ - **Key Metrics**: Cohort retention por segmento de adocao; CAC por segmento; % do mercado endereçavel capturado
189
+ - **Cross-References**: TAM/SAM/SOM, Technology Adoption Lifecycle, Zero to One (Thiel — domine antes de expandir)
190
+
191
+ ---
192
+
193
+ ### 9. Jobs-to-be-Done — JTBD (Clayton Christensen, ~1990s)
194
+ - **Originator**: Clayton Christensen (Harvard Business School); formalizado por Tony Ulwick (Outcome-Driven Innovation)
195
+ - **When to Use**: Descobrir o real motivo pelo qual clientes "contratam" seu produto; redesenhar posicionamento e features
196
+ - **How to Apply**:
197
+ **Framework**: "Customers don't buy products; they hire them to do a job"
198
+
199
+ 1. Identifique o job: "Quando [situacao], quero [motivacao] para [resultado esperado]"
200
+ 2. Distinga jobs funcionais (o que precisa ser feito) de jobs emocionais (como quer se sentir) e sociais (como quer ser percebido)
201
+ 3. Mapeie a "job story" completa: contexto → job → resultado
202
+ 4. Identifique o "progress" que o cliente busca — nao a solucao especifica
203
+ 5. Valide: quais alternativas (incluindo nao-consumo) o cliente usa hoje para fazer esse job?
204
+
205
+ **Switch Interview**: Entreviste clientes que mudaram para ou de seu produto. Pergunte sobre o momento do switch (qual foi o "gatilho"?), o que estava errado com a solucao anterior, o que buscaram antes de encontrar voce.
206
+ - **Example Application**: Milkshake de McDonald's: contratado de manha por commuters para tornar o trajeto menos chato e mante-los saciados ate o almoco (job funcional + emocional). Insight: fazer o milkshake mais grosso (duracao mais longa no trajeto) e adicionar frutas (variabilidade). Nao foi insight de "sabor" — foi de "job".
207
+ - **Key Metrics**: Job clarity score (0-10 quanto bem o produto faz o job); customer interview insights; feature usage alinhado ao job
208
+ - **Cross-References**: First Principles (Thiel/Naval), Product-Market Fit, Crossing the Chasm
209
+
210
+ ---
211
+
212
+ ### 10. Viral Coefficient & Virality Models (David Skok)
213
+ - **Originator**: Conceito de matematica epidemiologica (R0); aplicado a produtos por David Skok
214
+ - **When to Use**: Avaliar potencial de crescimento viral; projetar crecimento organico; decidir investimento em paid vs. viral
215
+ - **How to Apply**:
216
+ **Viral Coefficient (K)** = Convites enviados por usuario × Taxa de conversao dos convites
217
+ - K > 1: crescimento viral exponencial (cada usuario traz mais de 1 novo)
218
+ - K = 1: crescimento linear
219
+ - K < 1: crescimento dependente de aquisicao externa
220
+
221
+ **Viral Cycle Time**: Tempo medio entre um usuario se juntar e seu usuario convidado se juntar
222
+ (K = 0.7 com ciclo de 1 dia cresce mais rapido que K = 0.7 com ciclo de 30 dias)
223
+
224
+ **Growth por canal**:
225
+ - Paid: cresce enquanto voce paga (linear)
226
+ - SEO/Content: cresce lentamente, depois compostos
227
+ - Viral: cresce exponencialmente se K > 1
228
+ - Sales: cresce linear com equipe de vendas
229
+
230
+ Objetivo: mix de canais com pelo menos um com crescimento composto
231
+ - **Example Application**: WhatsApp: K proximo a 2 nos primeiros anos (cada usuario convidava em media 2 amigos que ficavam). Resultado: 0 → 450M usuarios em 5 anos com quase zero marketing. O produto E o marketing.
232
+ - **Key Metrics**: K-factor; Viral cycle time; % novos usuarios via referral
233
+ - **Cross-References**: Growth Loops, Network Effects, PLG, Blitzscaling
234
+
235
+ ---
236
+
237
+ ## PART 4: CRESCIMENTO RESPONSAVEL
238
+
239
+ ### 11. Sustainable Growth Rate (SGR)
240
+ - **Originator**: Conceito financeiro classico; aplicado a growth por Ben Horowitz (a16z)
241
+ - **When to Use**: Decidir velocidade de crescimento sustentavel sem destruir cultura ou cash; equilibrar burn vs. growth
242
+ - **How to Apply**:
243
+ SGR financeiro = ROE × (1 - Payout Ratio)
244
+
245
+ **Para startups (perspectiva operacional)**:
246
+ 1. Identifique o gargalo de crescimento (contratacao, infra, qualidade de produto)
247
+ 2. Defina: qual crescimento pode ser absorvido sem degradar o produto/cultura?
248
+ 3. Blitzscaling: viola este principio conscientemente (ver Hoffman) quando vantagem de ser first-mover supera o custo da ineficiencia
249
+ 4. Crescimento saudavel: voce pode manter cultura, qualidade de produto, e unit economics ao mesmo ritmo de crescimento?
250
+ - **Key Metrics**: NPS durante crescimento (nao deve cair mais de 10 pontos); Churn durante crescimento (nao deve subir >2%); Glassdoor rating
251
+ - **Cross-References**: Blitzscaling (quando violar), Chouinard's Responsible Growth, Rule of 40
252
+
253
+ ---
254
+
255
+ ## Quick Reference: Growth Model Selector
256
+
257
+ | Cenario | Framework Primario | Framework Secundario |
258
+ |---------|-------------------|---------------------|
259
+ | Produto novo, early adopters | Jobs-to-be-Done | Crossing the Chasm |
260
+ | Definir a metrica chave | North Star Metric | AARRR |
261
+ | Funil vazando, nao sei onde | AARRR diagnostic | ICE Score |
262
+ | Quer virality | Viral Coefficient | Growth Loops |
263
+ | Quer PLG | Product-Led Growth | Hook Model |
264
+ | Priorizar backlog grande | RICE Score | ICE Score |
265
+ | Crescer para mainstream | Crossing the Chasm | TAM/SAM/SOM |
266
+ | Decidir velocidade | Sustainable Growth Rate | Blitzscaling |
267
+ | Criar habito no produto | Hook Model | AARRR Retention |