sinapse-ai 9.3.0 → 9.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/.claude/CLAUDE.md +60 -341
  2. package/.claude/hooks/enforce-architecture-first.py +197 -197
  3. package/.claude/hooks/enforce-git-push-authority.sh +25 -4
  4. package/.claude/hooks/mind-clone-governance.py +193 -193
  5. package/.claude/hooks/read-protection.py +152 -152
  6. package/.claude/hooks/sql-governance.py +183 -183
  7. package/.claude/hooks/verify-packages.cjs +83 -0
  8. package/.claude/hooks/write-path-validation.py +195 -195
  9. package/.claude/rules/agent-authority.md +6 -0
  10. package/.claude/rules/agent-handoff.md +5 -0
  11. package/.claude/rules/cross-squad-routing.md +5 -0
  12. package/.claude/rules/hook-governance.md +7 -0
  13. package/.claude/rules/mandatory-delegation.md +24 -0
  14. package/.claude/rules/mcp-usage.md +3 -1
  15. package/.claude/rules/project-intelligence.md +63 -0
  16. package/.claude/rules/response-format.md +4 -0
  17. package/.claude/rules/safe-collaboration.md +14 -2
  18. package/.claude/rules/security-data-protection.md +27 -0
  19. package/.claude/rules/squad-awareness.md +96 -68
  20. package/.claude/rules/token-economy.md +148 -0
  21. package/.claude/rules/tool-examples.md +6 -0
  22. package/.claude/rules/workflow-execution.md +7 -0
  23. package/.codex/agents/analyst.md +342 -71
  24. package/.codex/agents/architect.md +533 -68
  25. package/.codex/agents/data-engineer.md +530 -106
  26. package/.codex/agents/developer.md +657 -0
  27. package/.codex/agents/devops.md +639 -69
  28. package/.codex/agents/product-lead.md +362 -0
  29. package/.codex/agents/project-lead.md +405 -0
  30. package/.codex/agents/quality-gate.md +538 -0
  31. package/.codex/agents/sinapse-orqx.md +9 -7
  32. package/.codex/agents/sprint-lead.md +315 -0
  33. package/.codex/agents/squad-creator.md +402 -0
  34. package/.codex/agents/ux-design-expert.md +523 -0
  35. package/.codex/delegation-matrix.json +756 -44
  36. package/.codex/handoff-packet.schema.json +30 -6
  37. package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
  38. package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
  39. package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
  40. package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
  41. package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
  42. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
  43. package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
  44. package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
  45. package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
  46. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
  47. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
  48. package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
  49. package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
  50. package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
  51. package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
  52. package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
  53. package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
  54. package/.sinapse-ai/core/doctor/index.js +157 -50
  55. package/.sinapse-ai/core/ids/registry-updater.js +6 -1
  56. package/.sinapse-ai/core/logger/index.js +319 -0
  57. package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
  58. package/.sinapse-ai/core/telemetry/index.js +247 -0
  59. package/.sinapse-ai/data/entity-registry.yaml +1060 -808
  60. package/.sinapse-ai/development/agents/analyst.md +90 -0
  61. package/.sinapse-ai/development/agents/architect.md +78 -0
  62. package/.sinapse-ai/development/agents/data-engineer.md +38 -0
  63. package/.sinapse-ai/development/agents/developer.md +97 -0
  64. package/.sinapse-ai/development/agents/devops.md +121 -0
  65. package/.sinapse-ai/development/agents/product-lead.md +27 -0
  66. package/.sinapse-ai/development/agents/project-lead.md +28 -0
  67. package/.sinapse-ai/development/agents/quality-gate.md +89 -0
  68. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
  69. package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
  70. package/.sinapse-ai/development/agents/squad-creator.md +58 -0
  71. package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
  72. package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
  73. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
  74. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  75. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
  76. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
  77. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  78. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  79. package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
  80. package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
  81. package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
  82. package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
  83. package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
  84. package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
  85. package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
  86. package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
  87. package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
  88. package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
  89. package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
  90. package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
  91. package/.sinapse-ai/development/skills/debug.md +57 -0
  92. package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
  93. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  94. package/.sinapse-ai/development/skills/model-router.md +92 -0
  95. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  96. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  97. package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
  98. package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
  99. package/.sinapse-ai/development/skills/verify.md +53 -0
  100. package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
  101. package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
  102. package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
  103. package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
  104. package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
  105. package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
  106. package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
  107. package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
  108. package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
  109. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  110. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  111. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  112. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  113. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  114. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  115. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  116. package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
  117. package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
  118. package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
  119. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
  120. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  121. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  122. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
  123. package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
  124. package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
  125. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
  126. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
  127. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
  128. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
  129. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
  130. package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
  131. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
  132. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  133. package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
  134. package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
  135. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  136. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
  137. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
  138. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
  139. package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
  140. package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
  141. package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
  142. package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
  143. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  144. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  145. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  146. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  147. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  148. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  149. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  150. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  151. package/.sinapse-ai/install-manifest.yaml +333 -162
  152. package/.sinapse-ai/local-config.yaml.template +65 -65
  153. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
  154. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
  155. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
  156. package/.sinapse-ai/monitor/hooks/notification.py +30 -30
  157. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
  158. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
  159. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
  160. package/.sinapse-ai/monitor/hooks/stop.py +30 -30
  161. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
  162. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
  163. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  164. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  165. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  166. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  167. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  168. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  169. package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
  170. package/.sinapse-ai/product/templates/story.hbs +264 -264
  171. package/.sinapse-ai/product/templates/task.hbs +171 -171
  172. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  173. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  174. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  175. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  176. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  177. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  178. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  179. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  180. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  181. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  182. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  183. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  184. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  185. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  186. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  187. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
  188. package/LICENSE +34 -34
  189. package/README.en.md +167 -20
  190. package/README.md +190 -22
  191. package/bin/cli.js +510 -196
  192. package/bin/postinstall.js +564 -0
  193. package/bin/sinapse-cli +283 -283
  194. package/bin/sinapse-graph.js +9 -0
  195. package/bin/sinapse-init.js +36 -4
  196. package/bin/sinapse-minimal.js +20 -9
  197. package/bin/sinapse.js +202 -122
  198. package/bin/utils/deprecation-warning.js +46 -0
  199. package/bin/utils/pre-push-safety.js +14 -0
  200. package/docs/TELEMETRY.md +131 -0
  201. package/docs/chrome-brain-upgrade-plan.md +624 -0
  202. package/docs/codex-integration-process.md +22 -0
  203. package/docs/codex-parity-program.md +27 -0
  204. package/docs/framework/orqx-plan.md +1 -1
  205. package/docs/ide-integration.md +36 -0
  206. package/docs/installation/chrome-brain.md +17 -7
  207. package/docs/mega-upgrade-orchestration-plan.md +71 -0
  208. package/docs/pt/contributing.md +20 -0
  209. package/docs/research-synthesis-for-upgrade.md +511 -0
  210. package/docs/security-audit-report.md +306 -0
  211. package/package.json +20 -8
  212. package/packages/installer/src/config/configure-environment.js +19 -44
  213. package/packages/installer/src/detection/detect-project-type.js +181 -63
  214. package/packages/installer/src/installer/manifest-signature.js +32 -17
  215. package/packages/installer/src/wizard/i18n.js +12 -0
  216. package/packages/installer/src/wizard/ide-config-generator.js +8 -39
  217. package/packages/installer/src/wizard/index.js +119 -14
  218. package/packages/installer/src/wizard/questions.js +2 -3
  219. package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
  220. package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
  221. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
  222. package/packages/sinapse-install/bin/edmcp.js +0 -0
  223. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  224. package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
  225. package/scripts/check-markdown-links.py +353 -353
  226. package/scripts/coverage-report-summary.js +169 -0
  227. package/scripts/generate-install-manifest.js +6 -2
  228. package/scripts/release-readiness.js +169 -0
  229. package/scripts/test-install-matrix-local.sh +153 -0
  230. package/scripts/validate-install-docs.js +394 -0
  231. package/scripts/validate-no-external-refs.js +376 -0
  232. package/scripts/validate-squad-orqx.js +302 -0
  233. package/scripts/validate-story-meta.js +263 -0
  234. package/squads/claude-code-mastery/CHANGELOG.md +1 -1
  235. package/squads/claude-code-mastery/README.md +2 -2
  236. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  237. package/squads/claude-code-mastery/squad.yaml +1 -1
  238. package/squads/squad-artdir/README.md +90 -0
  239. package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
  240. package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
  241. package/squads/squad-artdir/agents/color-psychologist.md +166 -0
  242. package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
  243. package/squads/squad-artdir/agents/design-system-architect.md +100 -0
  244. package/squads/squad-artdir/agents/ia-architect.md +169 -0
  245. package/squads/squad-artdir/agents/interaction-designer.md +162 -0
  246. package/squads/squad-artdir/agents/layout-engineer.md +163 -0
  247. package/squads/squad-artdir/agents/motion-architect.md +185 -0
  248. package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
  249. package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
  250. package/squads/squad-artdir/agents/product-surface-director.md +86 -0
  251. package/squads/squad-artdir/agents/type-systemist.md +138 -0
  252. package/squads/squad-artdir/agents/visual-strategist.md +127 -0
  253. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
  254. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
  255. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
  256. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
  257. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
  258. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
  259. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
  260. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
  261. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
  262. package/squads/squad-artdir/package.json +20 -0
  263. package/squads/squad-artdir/squad.yaml +271 -0
  264. package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
  265. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
  266. package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
  267. package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
  268. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
  269. package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
  270. package/squads/squad-artdir/tasks/design-color-system.md +81 -0
  271. package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
  272. package/squads/squad-artdir/tasks/design-token-system.md +58 -0
  273. package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
  274. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
  275. package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
  276. package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
  277. package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
  278. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
  279. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
  280. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
  281. package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
  282. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  283. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  284. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  285. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  286. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  287. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  288. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  289. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  290. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  291. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  292. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  293. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  294. package/squads/squad-brand/squad.yaml +20 -6
  295. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  296. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  297. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  298. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  299. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  300. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  301. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  302. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  303. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  304. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  305. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  306. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  307. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  308. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  309. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  310. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  311. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  312. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  313. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  314. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  315. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  316. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  317. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  318. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  319. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  320. package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
  321. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  322. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  323. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  324. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  325. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  326. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  327. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  328. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  329. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  330. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  331. package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
  332. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  333. package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
  334. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  335. package/squads/squad-content/squad.yaml +187 -27
  336. package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
  337. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  338. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  339. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  340. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  341. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  342. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  343. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  344. package/squads/squad-copy/squad.yaml +19 -4
  345. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  346. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  347. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  348. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  349. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  350. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  351. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  352. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  353. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  354. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  355. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  356. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  357. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  358. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  359. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  360. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  361. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  362. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  363. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  364. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  365. package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
  366. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  367. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
  368. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  369. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  370. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  371. package/squads/squad-design/squad.yaml +19 -4
  372. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  373. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  374. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  375. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  376. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  377. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  378. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  379. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  380. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  381. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  382. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  383. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  384. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  385. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  386. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  387. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  388. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  389. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  390. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  391. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  392. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  393. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  394. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  395. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  396. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  397. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  398. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  399. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  400. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  401. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  402. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  403. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  404. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  405. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  406. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  407. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  408. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  409. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  410. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  411. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  412. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  413. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  414. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  415. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  416. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  417. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  418. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  419. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  420. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  421. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  422. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  423. package/.sinapse-ai/core/registry/service-registry.json +0 -6346
  424. package/.sinapse-ai/data/registry-update-log.jsonl +0 -1307
  425. package/.sinapse-ai/manifests/agents.csv +0 -29
  426. package/.sinapse-ai/manifests/tasks.csv +0 -204
  427. package/.sinapse-ai/manifests/workers.csv +0 -196
  428. package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
  429. package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
  430. package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
  431. package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
  432. package/squads/squad-paidmedia/tasks/calculate-sample-size.md +0 -57
@@ -0,0 +1,205 @@
1
+ # Power Words Catalog
2
+
3
+ > Power words sao palavras que acionam resposta emocional e psicologica imediata.
4
+ > Aumentam CTR, open rates e conversao quando usadas estrategicamente.
5
+ > Fonte: MS-008 (secao 5.6) + estudos Outbrain, Copyblogger, CoSchedule.
6
+
7
+ ---
8
+
9
+ ## Por Categoria Emocional
10
+
11
+ ### Urgencia e Escassez
12
+ Acionam loss aversion — medo de perder oportunidade.
13
+ ```
14
+ Agora, Hoje, Imediato, Urgente, Ultimo, Deadline
15
+ Expira, Esgotando, Limitado, Encerra, So ate [data]
16
+ Nao perca, Ultima chance, Agindo agora, Nesse momento
17
+ ```
18
+ **Regra de ouro:** Urgencia deve ser REAL. Urgencia falsa destroi credibilidade permanentemente.
19
+
20
+ ### Exclusividade e Status
21
+ Ativam o desejo de pertencimento a grupo especial.
22
+ ```
23
+ Exclusivo, VIP, Restrito, Apenas para membros, Convite
24
+ Secreto, Interno, Privilegiado, Seleto, Elite
25
+ Acesso antecipado, Primeiro a saber, Beta fechado
26
+ ```
27
+ **Uso correto:** Somente quando a exclusividade e genuina. Gatilho de Unidade (Cialdini).
28
+
29
+ ### Curiosidade e Revelacao
30
+ Exploram o Curiosity Gap (Loewenstein) — o cerebro PRECISA fechar informacao incompleta.
31
+ ```
32
+ Revelado, Descoberto, Confessao, Segredo, Finalmente
33
+ Verdade sobre, O que ninguem conta, Por que realmente
34
+ Pouco conhecido, Escondido, Surpreendente, Chocante
35
+ Isso explica, A razao verdadeira, O motivo real
36
+ ```
37
+ **Tecnica:** Open loop no headline, fechamento no body ou CTA.
38
+
39
+ ### Seguranca e Confianca
40
+ Reduzem ansiedade e resistencia a compra.
41
+ ```
42
+ Garantido, Comprovado, Testado, Certificado, Aprovado
43
+ Seguro, Confiavel, Verificado, Auditado, Validado
44
+ Sem risco, Devolucao garantida, Satisfacao ou dinheiro de volta
45
+ Respaldado por, Endossado por, Recomendado por
46
+ ```
47
+ **Quando usar:** BOFU — quando o maior obstaculo e o risco percebido.
48
+
49
+ ### Novidade e Inovacao
50
+ Ativam dopamina — o cerebro busca o novo.
51
+ ```
52
+ Novo, Lancamento, Inedito, Revolucionario, Primeiro
53
+ Moderno, Atualizado, 2025/2026, Breakthrough, Pioneiro
54
+ Exclusivo lançamento, Acabou de sair, Recente
55
+ ```
56
+ **Cuidado:** "Novo" perde impacto se o produto for antigo. Autenticidade primeiro.
57
+
58
+ ### Facilidade e Velocidade
59
+ Reduzem o custo percebido de acao.
60
+ ```
61
+ Simples, Rapido, Facil, Em minutos, Automatico
62
+ Passo-a-passo, Sem complicacao, Sem conhecimento tecnico
63
+ Pronto pra usar, Plug-and-play, Em 3 cliques
64
+ ```
65
+ **Uso:** Headlines de tutoriais, onboarding, produtos SaaS.
66
+
67
+ ### Economia e Valor
68
+ Acionam o instinto de buscar valor.
69
+ ```
70
+ Gratis, Desconto, Economize, Sem custo, De graça
71
+ Bonus, Brinde, Mais por menos, Melhor custo-beneficio
72
+ R$[valor] de desconto, Ate [%] off, Por apenas R$[preco]
73
+ ```
74
+ **Hierarquia de valor:** "Gratis" e a palavra mais poderosa no marketing (Claude Hopkins).
75
+
76
+ ### Emocao e Transformacao
77
+ Criam conexao emocional e visualizacao de resultado.
78
+ ```
79
+ Transforme, Mude, Alcance, Conquiste, Realize
80
+ Liberdade, Paz, Confianca, Orgulho, Alegria
81
+ Finalmente, Nunca mais, Para sempre, Definitivamente
82
+ ```
83
+ **Uso:** Sales pages, emails de nutricao, copy aspiracional.
84
+
85
+ ### Autoridade e Credibilidade
86
+ Ativam o principio de Autoridade (Cialdini).
87
+ ```
88
+ Especialista, Expert, Veterano, Pioneiro, Referencia
89
+ Citado por, Recomendado por, Usado por [N] empresas
90
+ Premio, Premiado, Reconhecido, Numero 1 em
91
+ Estudo comprova, Ciencia mostra, Pesquisa revela
92
+ ```
93
+ **Especificidade amplifica:** "Usado por 12.847 empresas" > "usado por milhares".
94
+
95
+ ---
96
+
97
+ ## Power Words por Canal
98
+
99
+ ### Email (Subject Lines)
100
+ | Objetivo | Power Words |
101
+ |----------|------------|
102
+ | Abertura | Gratis, Segredo, [Nome], Exclusivo, Urgente |
103
+ | Curiosidade | Revelado, Descobri, Isso muda tudo, Confissao |
104
+ | Valor | Template, Checklist, Guia, [N] dicas |
105
+ | Urgencia | Expira hoje, Ultima chance, Vagas esgotando |
106
+
107
+ ### Ads (Meta, Google)
108
+ | Objetivo | Power Words |
109
+ |----------|------------|
110
+ | Stop the scroll | Pare, Voce, [N]x, Mais de [N] pessoas |
111
+ | CTA | Comece agora, Experimente gratis, Saiba mais |
112
+ | Prova | Comprovado, Testado, Resultados reais |
113
+ | Urgencia | So hoje, Limitado, Restam [N] vagas |
114
+
115
+ ### Landing Pages
116
+ | Secao | Power Words |
117
+ |-------|------------|
118
+ | Above the fold | Transforme, Conquiste, Em [tempo] |
119
+ | Social proof | Confiado por, Ja ajudou [N], Clientes |
120
+ | CTA | Comece agora, Quero acessar, Sim, eu quero |
121
+ | Garantia | Garantido, Risco zero, 30 dias de garantia |
122
+
123
+ ---
124
+
125
+ ## Brazilian Power Words — Nuances Locais
126
+
127
+ Expressoes que ressoam especificamente com o publico brasileiro:
128
+
129
+ ### Tom de Proximidade (tipicamente brasileiro)
130
+ ```
131
+ Olha, Cara, Deixa eu te contar, Isso aqui e diferente
132
+ Sem enrolacao, Direto ao ponto, Vamos la
133
+ ```
134
+
135
+ ### Expressoes de Transformacao BR
136
+ ```
137
+ Mudar de vida, Sair da CLT, Virar o jogo
138
+ Do zero ao resultado, Da empresa pra voce
139
+ ```
140
+
141
+ ### Urgencia com Sotaque BR
142
+ ```
143
+ Agora ou nunca, Ta esperando o que, Bora la
144
+ Aproveita que ainda da, Enquanto tem vaga
145
+ ```
146
+
147
+ ### Credibilidade Local
148
+ ```
149
+ Reconhecido no Brasil, Maior plataforma nacional
150
+ [N] brasileiros ja, Feito no Brasil para o Brasil
151
+ ```
152
+
153
+ ---
154
+
155
+ ## Palavras a EVITAR
156
+
157
+ ### Cliches Desgastados (zero impacto)
158
+ ```
159
+ Sinergia, Disruptivo, Inovador (sem contexto), Game-changer
160
+ World-class, Best-in-class, Unico (quando nao e)
161
+ Estado-da-arte, De ponta, Vanguarda
162
+ ```
163
+
164
+ ### Hipérboles que Destroem Credibilidade
165
+ ```
166
+ Incrivel, Fenomenal, Revolucionario (sem prova)
167
+ O melhor do mercado (sem validacao), Garantia absoluta
168
+ 100% de sucesso, Resultado garantido (sem ressalvas)
169
+ ```
170
+
171
+ ### Urgencia Falsa (destroi confianca permanentemente)
172
+ ```
173
+ Oferta expira em [contador que reseta]
174
+ Ultimas vagas (quando ha infinitas)
175
+ Preco especial (que e o preco normal sempre)
176
+ ```
177
+
178
+ ---
179
+
180
+ ## Usando Power Words com Inteligencia
181
+
182
+ ### Regras de Aplicacao
183
+ 1. **Contexto primeiro:** Power word sem contexto e vazio. "Segredo" sozinho < "O segredo que [resultado especifico]"
184
+ 2. **Especificidade amplifica:** "Garantia de 30 dias" > "garantia" generico
185
+ 3. **Dosagem:** 2-3 power words por elemento (headline, CTA, subject line). Mais = dilui impacto
186
+ 4. **Tom correto:** Power words de urgencia num tom errado (formal demais) geram dissonancia
187
+ 5. **Prova social especifica:** "[N] clientes" > "muitos clientes"; "4.8 estrelas de 1.247 reviews" > "bem avaliado"
188
+
189
+ ### Teste A/B de Power Words
190
+ Elementos com maior ROI de teste:
191
+ 1. Subject lines de email (highest leverage)
192
+ 2. Headline da landing page
193
+ 3. CTA copy (o texto do botao)
194
+ 4. Headline do ad
195
+
196
+ **Formula de teste:** Controle (sem power word) vs. Variante (com power word especifica).
197
+ Significancia estatistica minima: 95% de confianca, N > 1.000 por variante.
198
+
199
+ ## Referencias
200
+ - MS-008 Content Research (secao 5.6) — Readability e Poder das Palavras
201
+ - Tested Advertising Methods — John Caples
202
+ - Scientific Advertising — Claude Hopkins
203
+ - The Adweek Copywriting Handbook — Joseph Sugarman
204
+ - Triggers — Joseph Sugarman
205
+ - Copyblogger.com — Power Words research
@@ -0,0 +1,255 @@
1
+ # SEO Copywriting
2
+
3
+ > Fonte primaria: MS-008 (secao 6) — SEO Content.
4
+ > Copywriting que converte para humanos E rankeia para motores de busca.
5
+ > Principio: Search intent antes de keywords. Humanos antes de algoritmos.
6
+
7
+ ---
8
+
9
+ ## 1. O Fundamento: Search Intent Mapping
10
+
11
+ Antes de escrever uma palavra de SEO copy, identifique o INTENTO de busca.
12
+ Copy que nao atende ao intent nao ranka — mesmo com tecnica impecavel.
13
+
14
+ | Intent | O que o Usuario Quer | Copy Approach | Formato Ideal |
15
+ |--------|---------------------|---------------|---------------|
16
+ | **Informacional** | Aprender algo | Educar — fornecer resposta completa | Blog post, guia, FAQ |
17
+ | **Navegacional** | Encontrar um site/marca especifico | Nao e target de SEO content | N/A |
18
+ | **Comercial** | Comparar antes de comprar | Comparar, avaliar, recomendar | Comparativo, review, listicle |
19
+ | **Transacional** | Realizar uma acao (comprar, se inscrever) | Converter — proposta de valor + CTA | Landing page, pagina de preco |
20
+
21
+ **Regra de ouro:** Escreva para o intent, depois otimize para keywords.
22
+ Copy para intent errado = bounce alto = sinal negativo para o Google.
23
+
24
+ ---
25
+
26
+ ## 2. Anatomia de Copy SEO-Friendly
27
+
28
+ ### Headline (Title Tag)
29
+ - Inclui keyword primaria — de preferencia no inicio
30
+ - < 60 caracteres (60-70 na SERP desktop)
31
+ - Hook que gera clique — mesmo que nao seja o #1
32
+ - Formula: "[Keyword] + [Beneficio/Angulo]" ou "[N] + [Keyword] + [Resultado]"
33
+
34
+ **Exemplo:**
35
+ - Keyword: "copywriting formulas"
36
+ - Title: "11 Formulas de Copywriting que Vendem (Com Exemplos Reais)"
37
+
38
+ ### Meta Description
39
+ - < 160 caracteres
40
+ - Inclui keyword (o Google grifa em negrito)
41
+ - CTA implicito ou explicito
42
+ - Complementa o title — nao repete
43
+ - Formula: "[Beneficio principal] + [detalhe especifico] + [CTA soft]"
44
+
45
+ **Exemplo:**
46
+ - Meta: "Aprenda as formulas de copywriting mais testadas da historia — AIDA, PAS, BAB e mais. Com exemplos reais e quando usar cada uma."
47
+
48
+ ### H1 (Headline Principal)
49
+ - Deve incluir a keyword primaria
50
+ - Pode ser igual ao title tag ou variacao
51
+ - Uma por pagina
52
+
53
+ ### H2s (Subheadings)
54
+ - Incluem keywords secundarias e variantes
55
+ - Ajudam o Google a entender a estrutura topica
56
+ - Respondem perguntas especificas (People Also Ask)
57
+ - Cada H2 deve ser uma promessa de valor para o leitor
58
+
59
+ ### Paragrafos de Abertura (primeiros 100-150 palavras)
60
+ - Inclui keyword primaria nos primeiros 100 caracteres
61
+ - Responde a query imediatamente (nao deixa o leitor esperando)
62
+ - Hook editorial — motivo para continuar lendo
63
+ - Sinaliza ao Google do que trata a pagina
64
+
65
+ ---
66
+
67
+ ## 3. E-E-A-T — Experiencia, Expertise, Autoridade, Confiabilidade
68
+
69
+ Google usa E-E-A-T como criterio central de qualidade de conteudo.
70
+ O primeiro "E" (Experience) foi adicionado em dezembro de 2022.
71
+
72
+ | Fator | Como Demonstrar no Copy |
73
+ |-------|------------------------|
74
+ | **Experience** | Escreva com base em experiencia propria — "testei isso por X meses", dados proprios, screenshots reais |
75
+ | **Expertise** | Bio do autor com credenciais, publicacoes, portfolio, anos de experiencia |
76
+ | **Authoritativeness** | Cite fontes respeitadas, mencione estudos, dados de pesquisa — nao apenas opinion |
77
+ | **Trustworthiness** | HTTPS, politica de privacidade, data de atualizacao, fontes citadas, nenhuma claim sem prova |
78
+
79
+ **Copy techniques para E-E-A-T:**
80
+ - Adicione data de atualizacao ("Ultima atualizacao: abril 2026")
81
+ - Cite estudos e dados com links para as fontes originais
82
+ - Inclua bio do autor com link para perfil profissional
83
+ - Use "Testei isso pessoalmente" ao inves de "Dizem que..."
84
+ - Adicione dados proprios, screenshots, resultados mensuraveis
85
+
86
+ ---
87
+
88
+ ## 4. Featured Snippets — Posicao Zero
89
+
90
+ Featured snippets sao trechos que o Google exibe diretamente na SERP antes dos resultados organicos.
91
+ Conquistar um featured snippet pode aumentar CTR em 20-30%.
92
+
93
+ ### Tipos e Como Otimizar
94
+
95
+ | Tipo | Formato | Formula de Copy |
96
+ |------|---------|----------------|
97
+ | **Paragrafo** | Resposta em 40-60 palavras | Heading com a pergunta + paragrafo de resposta direta |
98
+ | **Lista** | Lista ordenada ou nao | Heading + bullets/numerados claros e concisos |
99
+ | **Tabela** | Dados comparativos | Tabela HTML bem formatada com headers |
100
+ | **How-to** | Passos numerados | H2 "Como [X]" + steps numerados em H3 |
101
+
102
+ ### Template para Paragraph Snippet
103
+ ```
104
+ H2: O que e [Keyword]?
105
+
106
+ [Keyword] e [definicao em 40-60 palavras que responde diretamente].
107
+ [Adicione contexto especifico, por que importa, ou numero relevante].
108
+ ```
109
+
110
+ ### Template para List Snippet
111
+ ```
112
+ H2: [As X] [Keyword] [para/que/em]?
113
+
114
+ - Item 1 (com 1-2 frases de contexto)
115
+ - Item 2
116
+ - Item 3
117
+ [...]
118
+ ```
119
+
120
+ ---
121
+
122
+ ## 5. Semantic SEO — Escrevendo para Topicos, Nao Keywords
123
+
124
+ O Google de 2025-2026 entende topicos, entidades e relacoes semanticas — nao apenas keyword matching.
125
+ Copie que usa semantica rica ranka melhor e e mais lida.
126
+
127
+ ### Cobertura de Entidades
128
+ Todo artigo sobre um topico deve mencionar as entidades relacionadas que o Google espera ver.
129
+ Artigo sobre "copywriting formulas" deve mencionar: AIDA, David Ogilvy, Dan Kennedy, PAS, Eugene Schwartz, headline, CTA, conversao, persuasao.
130
+
131
+ **Como descobrir entidades esperadas:**
132
+ 1. Analise os top-5 resultados rankeados para sua keyword
133
+ 2. Identifique entidades/termos que TODOS mencionam
134
+ 3. Garanta cobertura dessas entidades no seu artigo
135
+
136
+ ### NLP Optimization
137
+ - Use linguagem natural — variantes e sinonimos, nao a keyword repetida mecanicamente
138
+ - Responda as "People Also Ask" — cada PAA e uma secao potencial com featured snippet
139
+ - Coocorrencias semanticas: palavras que o Google espera ver juntas com sua keyword
140
+
141
+ ### Pillar/Cluster Model (HubSpot)
142
+ Organiza conteudo em torno de topicos, nao keywords individuais.
143
+
144
+ ```
145
+ PILLAR PAGE: "Guia Completo de Copywriting" (3.000-10.000 palavras)
146
+ ↕ link bidirec.
147
+ CLUSTER 1: "Formulas de Copywriting" ← link para/do pillar
148
+ CLUSTER 2: "Headlines que Convertem" ← link para/do pillar
149
+ CLUSTER 3: "Email Copywriting" ← link para/do pillar
150
+ CLUSTER 4: "Copy para Ads" ← link para/do pillar
151
+ CLUSTER 5: "Landing Page Copy" ← link para/do pillar
152
+ ```
153
+
154
+ **Resultado comprovado:** HubSpot reportou 3x mais crescimento de trafego em topic clusters vs. conteudo nao-clusterizado.
155
+
156
+ ---
157
+
158
+ ## 6. Readability — Escrevendo para Humanos Primeiro
159
+
160
+ **Flesch-Kincaid ideal para conteudo web:** Grade 7-8 (compreensivel por aluno de 12-13 anos).
161
+ Isso nao significa simplista — significa claro.
162
+
163
+ ### Regras de Readability para SEO
164
+ - Frases: < 25 palavras (meta), < 20 palavras para partes criticas
165
+ - Paragrafos: < 5 linhas (web), 3 linhas e ideal
166
+ - Subheadings: a cada 300-400 palavras
167
+ - Bullets: quando ha 3+ itens na mesma categoria
168
+ - Bold: conceitos-chave, dados importantes, CTAs inline
169
+ - Voz ativa: "fizemos" em vez de "foi feito por nos"
170
+ - Palavras simples: "usar" em vez de "utilizar", "mostrar" em vez de "demonstrar"
171
+
172
+ ### Estrutura de Introducao Ideal
173
+ ```
174
+ [Frase 1] Hook — afirmacao contraintuitiva, numero, ou promessa
175
+ [Frase 2] Contexto — por que isso importa agora
176
+ [Frase 3] Keyword natural — a query respondida em linguagem natural
177
+ [Frase 4-5] O que o leitor vai aprender neste artigo
178
+ ```
179
+
180
+ ---
181
+
182
+ ## 7. Content Decay e Refresh Strategy
183
+
184
+ **Content decay:** Perda gradual de trafego por desatualizacao, novos competidores, mudancas de intent.
185
+ 20% do esforco editorial deve ir para refresh — e quase sempre mais eficiente que criar do zero.
186
+
187
+ ### Quando Fazer Refresh
188
+
189
+ | Urgencia | Trigger | Acao |
190
+ |---------- |---------|------|
191
+ | Imediata | Dados factuais errados, informacoes desatualizadas | Atualizar imediatamente |
192
+ | Alta | Queda > 30% trafego, perdeu featured snippet | Refresh em 2 semanas |
193
+ | Media | Queda 15-30%, novo conteudo melhor nos concorrentes | Refresh em 30 dias |
194
+ | Baixa | Conteudo ok mas pode ser melhorado | Proximo ciclo trimestral |
195
+
196
+ ### Refresh Checklist
197
+ ```
198
+ [ ] Dados e estatisticas atualizados para 2025/2026
199
+ [ ] Novas secoes adicionadas (subtopicos emergentes)
200
+ [ ] H2s revisados para capturar novos PAAs
201
+ [ ] Internal links atualizados
202
+ [ ] Meta title e description otimizados
203
+ [ ] Data de publicacao atualizada (se mudancas substanciais)
204
+ [ ] Featured snippet recapturado com templates de snippet
205
+ [ ] Novos exemplos e cases de 2024-2026
206
+ ```
207
+
208
+ ---
209
+
210
+ ## 8. SEO Copy Checklist Pre-Publicacao
211
+
212
+ ```
213
+ KEYWORD OPTIMIZATION:
214
+ [ ] Keyword primaria no H1, primeiros 100 chars, e 2-3 vezes no body
215
+ [ ] Keywords secundarias distribuidas naturalmente
216
+ [ ] Semantica rica — entidades relacionadas presentes
217
+ [ ] Sem keyword stuffing (nunca force — leitura natural primeiro)
218
+
219
+ STRUCTURE:
220
+ [ ] Title tag < 60 chars, inclui keyword, tem hook
221
+ [ ] Meta description < 160 chars, inclui keyword + CTA
222
+ [ ] H1 unico com keyword
223
+ [ ] H2s com keywords secundarias e PAAs respondidas
224
+ [ ] Introducao com keyword nos primeiros 100 palavras
225
+
226
+ E-E-A-T:
227
+ [ ] Experiencia de primeira mao demonstrada
228
+ [ ] Fontes autoritativas citadas com links
229
+ [ ] Data de publicacao/atualizacao visivel
230
+ [ ] Bio do autor com credenciais
231
+
232
+ FEATURED SNIPPETS:
233
+ [ ] Perguntas no formato de H2/H3
234
+ [ ] Resposta direta em 40-60 palavras logo apos a pergunta
235
+ [ ] Lists formatadas corretamente para snippet
236
+ [ ] Tabelas com headers para snippet de tabela
237
+
238
+ LINKS:
239
+ [ ] 3-5 internal links para conteudo relacionado
240
+ [ ] 2-3 external links para fontes autoritativas
241
+ [ ] Anchor text descritivo (nao "clique aqui")
242
+
243
+ READABILITY:
244
+ [ ] Paragrafos < 5 linhas
245
+ [ ] Subheadings a cada 300-400 palavras
246
+ [ ] Voz ativa predominante
247
+ [ ] Frases curtas (< 25 palavras media)
248
+ ```
249
+
250
+ ## Referencias
251
+ - MS-008 Content Research (secao 6)
252
+ - Ahrefs Blog — SEO Copywriting Guide
253
+ - Moz — On-Page SEO Ranking Factors
254
+ - Google Search Quality Evaluator Guidelines
255
+ - HubSpot — Pillar/Cluster Content Strategy
@@ -0,0 +1,239 @@
1
+ # Video Script Copywriting
2
+
3
+ > Fonte primaria: MS-008 (secoes 7.1 a 7.4) + frameworks de copywriting aplicados a video.
4
+ > Video e o formato de maior crescimento — short-form domina atencao, long-form constroi autoridade.
5
+
6
+ ---
7
+
8
+ ## 1. O Hook — Tudo que Importa Nos Primeiros 3 Segundos
9
+
10
+ 65% dos viewers decidem nos primeiros 3 segundos se continuam assistindo.
11
+ No YouTube: a retenção nos primeiros 30 segundos define o alcance do video.
12
+ No TikTok/Reels: o algoritmo mede a "taxa de conclusao" — quanto mais assistem, mais distribui.
13
+
14
+ ### Principio do Hook
15
+ O hook de video tem 3 funcoes simultaneas:
16
+ 1. **Parar o scroll** — dissonancia cognitiva, curiosidade, promessa
17
+ 2. **Qualificar o viewer** — "isso e pra voce se..."
18
+ 3. **Fazer a promessa** — o que o viewer vai ganhar assistindo
19
+
20
+ ### Os 8 Tipos de Hook por Eficiencia
21
+
22
+ | Tipo | Exemplo | Canal Ideal |
23
+ |------|---------|------------|
24
+ | **Afirmacao controversa** | "Content marketing esta morto. Aqui o que funciona de verdade." | TikTok, Reels, YouTube |
25
+ | **Pergunta direta** | "Voce sabe por que 90% dos blogs nao geram nem um lead?" | LinkedIn, YouTube |
26
+ | **Numero/Estatistica chocante** | "Essa tecnica triplicou nosso trafego em 30 dias" | Todos |
27
+ | **Before/After pessoal** | "Minha newsletter tinha 200 inscritos. Hoje tem 50.000. O que mudou:" | Instagram, TikTok |
28
+ | **Promessa de tutorial** | "Em 60 segundos voce vai aprender a escrever headlines 3x melhores" | YouTube Shorts, TikTok |
29
+ | **Pattern interrupt visual** | Acao inesperada nos primeiros quadros — contraste, corte rapido, objeto incomum | TikTok, Reels |
30
+ | **Segredo/Revelacao** | "O metodo que ninguem fala sobre copywriting — aprendi depois de 200 testes" | YouTube, LinkedIn |
31
+ | **Resultado sem contexto** | (Mostrar o resultado final primeiro, depois revelar como chegou la) | TikTok, Reels |
32
+
33
+ ### Hook Copy para Texto na Tela (Reels/TikTok)
34
+ - 1-5 palavras de alto impacto
35
+ - Fonte bold, alto contraste (branco/amarelo no fundo escuro)
36
+ - Aparece nos primeiros 0-2 segundos
37
+ - Funciona como headline visual — aplica as mesmas regras de headline
38
+
39
+ ---
40
+
41
+ ## 2. Scripts para YouTube (Long-form)
42
+
43
+ ### Estrutura de Video Educativo (10-15 min)
44
+
45
+ ```
46
+ [0:00-0:30] INTRO/HOOK
47
+ - Declaracao contraintuitiva OU pergunta OU resultado
48
+ - "Nesse video, voce vai [beneficio especifico]"
49
+ - Credencial rapida se necessario (autoridade em 10 segundos)
50
+
51
+ [0:30-2:00] CONTEXTO E SETUP
52
+ - Por que esse tema importa agora
53
+ - O problema que voce vai resolver
54
+ - "Eu estava [situacao] quando descobri..."
55
+
56
+ [2:00-10:00] CONTEUDO PRINCIPAL
57
+ - 3-5 pontos principais (numeros ajudam: "Os 3 metodos")
58
+ - Cada ponto: Conceito → Exemplo → Aplicacao pratica
59
+ - B-roll, demos, screen shares, exemplos visuais
60
+ - Bucket brigades para manter atencao: "Mas aqui fica interessante..."
61
+
62
+ [10:00-12:00] PROVA E CASO REAL
63
+ - Exemplo da vida real aplicando o que ensinou
64
+ - Dados, screenshots, resultados mensuravelmente especificos
65
+
66
+ [12:00-14:00] RESUMO E NEXT STEP
67
+ - Recapitulacao dos pontos em bullets
68
+ - A aplicacao mais imediata que o viewer pode fazer hoje
69
+
70
+ [14:00-15:00] CTA
71
+ - Subscriba + notificacoes (se faz sentido)
72
+ - Link na descricao para recurso gratuito
73
+ - Proximo video sugerido
74
+ - "Se voce gostou disso, o proximo video que voce precisa ver e..."
75
+ ```
76
+
77
+ ### Tecnicas de Retenção em Long-form
78
+ - **Open loops:** "Mais pra frente no video, vou revelar o que poucos sabem sobre..."
79
+ - **Pattern interrupts:** Mudar tom, zoom, cut, slide, B-roll a cada 2-3 minutos
80
+ - **Antecipacao:** "No minuto 8, vou te mostrar o resultado que mais me surpreendeu"
81
+ - **Chapters/Timestamps:** Ajuda SEO e deixa o viewer saber o que vem
82
+
83
+ ---
84
+
85
+ ## 3. Scripts para Short-form (Reels, TikTok, Shorts < 60 seg)
86
+
87
+ ### Estrutura Basica
88
+ ```
89
+ [0-3 seg] HOOK: Afirmacao, pergunta, ou visual de impacto
90
+ [3-45 seg] CONTEUDO: Valor prometido no hook — entregue rapidamente, sem padding
91
+ [45-60 seg] CTA: Acao especifica, simples, direta
92
+ ```
93
+
94
+ ### Roteiro de Short-form (Template)
95
+ ```
96
+ [Hook - frase 1]: [Afirmacao contraintuitiva / pergunta / numero chocante]
97
+ [Setup - 1-2 frases]: Por que isso importa para voce
98
+ [Ponto 1 - 1 frase]: [O primeiro insight, mais concreto]
99
+ [Ponto 2 - 1 frase]: [Segundo insight, build no primeiro]
100
+ [Ponto 3 - 1 frase]: [Terceiro insight ou o mais importante]
101
+ [Reforco do hook - 1 frase]: [Fecha o loop aberto no inicio]
102
+ [CTA - 1 frase]: [Follow, link na bio, comentario, compartilha]
103
+ ```
104
+
105
+ ### Principios de Short-form
106
+ - **Velocidade:** Nenhum padding, nenhuma intro de 10 segundos
107
+ - **Legendas:** 85% assiste sem som — legendas sao obrigatorias
108
+ - **Cortes rapidos:** 2-3 segundos por cena no maximo
109
+ - **Texto na tela:** Reforce pontos-chave com overlay de texto
110
+ - **Especificidade:** "3 dicas" nao funciona — "dica de SEO em 30 segundos" funciona
111
+
112
+ ---
113
+
114
+ ## 4. VSL (Video Sales Letter) — Script Completo
115
+
116
+ VSL substitui a sales page de texto — mesmo conteudo, formato video.
117
+ Taxas de conversao tipicamente 20-40% maiores que sales pages de texto puro.
118
+
119
+ ### Estrutura de VSL (15-45 min)
120
+
121
+ ```
122
+ [1-3 min] HOOK E QUALIFICACAO
123
+ "Se voce e [descricao especifica do avatar], preste atencao nos proximos [X] minutos porque..."
124
+ Resultado especifico que pode alcancaro
125
+
126
+ [3-8 min] A HISTORIA E O PROBLEMA
127
+ - Historia do fundador/criador com o problema
128
+ - Por que tentou outras solucoes que falharam
129
+ - Momento de virada — a descoberta do mecanismo
130
+ (Usa Epiphany Bridge de Brunson)
131
+
132
+ [8-15 min] O MECANISMO UNICO
133
+ - O que faz sua solucao diferente de tudo que existe
134
+ - Ensine a logica (nao o passo-a-passo completo — isso e o produto)
135
+ - Use analogias e metaforas para simplificar
136
+
137
+ [15-22 min] PROVA
138
+ - Case studies de clientes reais
139
+ - Depoimentos em video se possivel
140
+ - Dados e metricas especificas
141
+
142
+ [22-28 min] A OFERTA
143
+ - Apresente o produto/servico com todos os componentes
144
+ - Value stack: mostre o valor individual de cada componente
145
+ - Total percebido >> preco pedido
146
+
147
+ [28-32 min] GARANTIA E RISCO REVERSAL
148
+ - Remova o risco do comprador: "se nao funcionar, devolvo cada centavo"
149
+ - Quanto mais especifica a garantia, mais credivel
150
+
151
+ [32-38 min] URGENCIA E ESCASSEZ
152
+ - Por que agir agora (razao real)
153
+ - O que acontece se nao agir
154
+
155
+ [38-45 min] CTA E FECHAMENTO
156
+ - CTA claro e especifico
157
+ - Recapitulacao do que receberao
158
+ - "Aqui esta o que acontece quando voce clica no botao abaixo..."
159
+ - FAQ rapido (2-3 perguntas)
160
+ ```
161
+
162
+ ---
163
+
164
+ ## 5. Scripts por Objetivo
165
+
166
+ ### Awareness Video (Topo de Funil)
167
+ - Objetivo: Educacao e brand awareness
168
+ - Tom: Informativo, sem venda direta
169
+ - CTA: Soft — "se isso foi util, siga para mais"
170
+ - Estrutura: Hook educativo → Conteudo de valor → Soft CTA
171
+
172
+ ### Consideration Video (Meio de Funil)
173
+ - Objetivo: Mostrar solucao sem vender produto diretamente
174
+ - Tom: Demonstrativo, "como fizemos isso"
175
+ - CTA: Recurso gratuito (ebook, template, webinar)
176
+ - Estrutura: Problema → Abordagem → Resultado → "Tenho um guia gratuito que aprofunda isso"
177
+
178
+ ### Conversion Video (Fundo de Funil)
179
+ - Objetivo: Vender diretamente
180
+ - Tom: Direto, especifico, urgente
181
+ - CTA: Compra, trial, demo
182
+ - Estrutura: Hook (resultado) → Problema → Solucao → Prova → Oferta → CTA
183
+
184
+ ### Testimonial/Case Study Video
185
+ - Objetivo: Prova social visual
186
+ - Estrutura ideal:
187
+ ```
188
+ 1. Quem e o cliente (titulo/empresa) — 5 segundos
189
+ 2. O problema antes — "estava lutando com..."
190
+ 3. Por que escolheu esta solucao — o diferenciador
191
+ 4. O resultado especifico — numeros, antes/depois
192
+ 5. Recomendacao direta
193
+ ```
194
+
195
+ ---
196
+
197
+ ## 6. Producao e Entrega
198
+
199
+ ### Preparacao de Script
200
+ - **Teleprompter vs. bullets:** Bullets sao mais naturais; teleprompter para VSL/formato corporativo
201
+ - **Leitura em voz alta:** Leia o script antes de gravar — identifica frases artificiais
202
+ - **Tempo estimado:** ~130-150 palavras por minuto para ritmo conversacional
203
+
204
+ ### Elementos Visuais que Apoiam o Copy
205
+ - **Lower thirds:** Nome/titulo aparecem nos primeiros 30 seg
206
+ - **Bullet points na tela:** Aparecen conforme voce menciona
207
+ - **B-roll:** Cobre o "talking head" com imagens relacionadas ao que esta dizendo
208
+ - **Screen shares:** Para tutoriais — mostra, nao apenas conta
209
+
210
+ ### Metricas de Video Copy
211
+
212
+ | Metrica | O que indica | Benchmark |
213
+ |---------|-------------|-----------|
214
+ | Retenção 30 seg | Eficacia do hook | > 70% |
215
+ | Retenção media | Qualidade do conteudo | > 40-50% para long-form |
216
+ | Taxa de clique na descricao | Eficacia do CTA | > 1-3% |
217
+ | Taxa de conclusao | Engajamento geral | Shorts: > 60%, Long: > 40% |
218
+
219
+ ---
220
+
221
+ ## 7. SEO de Video (YouTube)
222
+
223
+ | Elemento | Otimizacao |
224
+ |---------|-----------|
225
+ | **Title** | Keyword primaria nos primeiros 60 chars, hook de curiosidade |
226
+ | **Description** | 200+ palavras, keyword nos primeiros 100 chars, timestamps marcados |
227
+ | **Tags** | 5-15 tags: keyword primaria + variantes + topico amplo |
228
+ | **Thumbnail** | Custom, alto contraste, face expressiva ou visual chocante, texto curto |
229
+ | **Chapters** | Timestamps no formato 0:00 na descricao (gera Key Moments no Google) |
230
+ | **Filename** | keyword-do-video.mp4 antes do upload |
231
+
232
+ **Regra de Ogilvy para thumbnails:** O thumbnail e o headline do video.
233
+ 5x mais pessoas veem o thumbnail antes de decidir assistir.
234
+
235
+ ## Referencias
236
+ - MS-008 Content Research (secoes 7.1 a 7.4)
237
+ - Expert Secrets — Russell Brunson
238
+ - YouTube Creator Academy (Think with Google)
239
+ - The Adweek Copywriting Handbook — Joseph Sugarman