sinapse-ai 9.2.0 → 9.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1610) hide show
  1. package/.claude/CLAUDE.md +56 -343
  2. package/.claude/hooks/README.md +1 -0
  3. package/.claude/hooks/enforce-architecture-first.py +197 -196
  4. package/.claude/hooks/install-hooks.sh +1 -0
  5. package/.claude/hooks/mind-clone-governance.py +193 -192
  6. package/.claude/hooks/pre-commit-version-check.sh +1 -0
  7. package/.claude/hooks/precompact-session-digest.cjs +1 -0
  8. package/.claude/hooks/precompact-wrapper.cjs +1 -0
  9. package/.claude/hooks/read-protection.py +152 -151
  10. package/.claude/hooks/sql-governance.py +183 -182
  11. package/.claude/hooks/synapse-engine.cjs +1 -0
  12. package/.claude/hooks/synapse-wrapper.cjs +1 -0
  13. package/.claude/hooks/write-path-validation.py +195 -194
  14. package/.claude/rules/agent-authority.md +6 -0
  15. package/.claude/rules/agent-handoff.md +5 -0
  16. package/.claude/rules/cross-squad-routing.md +5 -0
  17. package/.claude/rules/hook-governance.md +6 -0
  18. package/.claude/rules/ids-principles.md +1 -0
  19. package/.claude/rules/mcp-usage.md +3 -1
  20. package/.claude/rules/safe-collaboration.md +10 -0
  21. package/.claude/rules/security-data-protection.md +9 -0
  22. package/.claude/rules/squad-awareness.md +73 -0
  23. package/.claude/rules/story-lifecycle.md +1 -0
  24. package/.claude/rules/tool-examples.md +7 -0
  25. package/.claude/rules/workflow-execution.md +8 -0
  26. package/.codex/agents/analyst.md +253 -72
  27. package/.codex/agents/architect.md +455 -68
  28. package/.codex/agents/data-engineer.md +492 -106
  29. package/.codex/agents/developer.md +560 -0
  30. package/.codex/agents/devops.md +518 -69
  31. package/.codex/agents/product-lead.md +335 -0
  32. package/.codex/agents/project-lead.md +377 -0
  33. package/.codex/agents/quality-gate.md +449 -0
  34. package/.codex/agents/sinapse-orqx.md +9 -7
  35. package/.codex/agents/sprint-lead.md +287 -0
  36. package/.codex/agents/squad-creator.md +344 -0
  37. package/.codex/agents/ux-design-expert.md +495 -0
  38. package/.codex/delegation-matrix.json +756 -44
  39. package/.codex/handoff-packet.schema.json +30 -6
  40. package/.sinapse-ai/cli/commands/config/index.js +1 -0
  41. package/.sinapse-ai/cli/commands/generate/index.js +1 -0
  42. package/.sinapse-ai/cli/commands/manifest/index.js +1 -0
  43. package/.sinapse-ai/cli/commands/manifest/regenerate.js +1 -0
  44. package/.sinapse-ai/cli/commands/manifest/validate.js +1 -0
  45. package/.sinapse-ai/cli/commands/mcp/add.js +1 -0
  46. package/.sinapse-ai/cli/commands/mcp/index.js +1 -0
  47. package/.sinapse-ai/cli/commands/mcp/link.js +1 -0
  48. package/.sinapse-ai/cli/commands/mcp/setup.js +1 -0
  49. package/.sinapse-ai/cli/commands/mcp/status.js +1 -0
  50. package/.sinapse-ai/cli/commands/metrics/cleanup.js +1 -0
  51. package/.sinapse-ai/cli/commands/metrics/index.js +1 -0
  52. package/.sinapse-ai/cli/commands/metrics/record.js +1 -0
  53. package/.sinapse-ai/cli/commands/metrics/seed.js +1 -0
  54. package/.sinapse-ai/cli/commands/metrics/show.js +1 -0
  55. package/.sinapse-ai/cli/commands/migrate/analyze.js +1 -0
  56. package/.sinapse-ai/cli/commands/migrate/backup.js +1 -0
  57. package/.sinapse-ai/cli/commands/migrate/execute.js +1 -0
  58. package/.sinapse-ai/cli/commands/migrate/index.js +1 -0
  59. package/.sinapse-ai/cli/commands/migrate/rollback.js +1 -0
  60. package/.sinapse-ai/cli/commands/migrate/update-imports.js +1 -0
  61. package/.sinapse-ai/cli/commands/migrate/validate.js +1 -0
  62. package/.sinapse-ai/cli/commands/qa/run.js +1 -0
  63. package/.sinapse-ai/cli/commands/qa/status.js +1 -0
  64. package/.sinapse-ai/cli/commands/workers/formatters/info-formatter.js +1 -0
  65. package/.sinapse-ai/cli/commands/workers/formatters/list-table.js +1 -0
  66. package/.sinapse-ai/cli/commands/workers/formatters/list-tree.js +1 -0
  67. package/.sinapse-ai/cli/commands/workers/index.js +1 -0
  68. package/.sinapse-ai/cli/commands/workers/info.js +1 -0
  69. package/.sinapse-ai/cli/commands/workers/list.js +1 -0
  70. package/.sinapse-ai/cli/commands/workers/search-filters.js +1 -0
  71. package/.sinapse-ai/cli/commands/workers/search-keyword.js +1 -0
  72. package/.sinapse-ai/cli/commands/workers/search-semantic.js +1 -0
  73. package/.sinapse-ai/cli/commands/workers/search.js +1 -0
  74. package/.sinapse-ai/cli/commands/workers/utils/pagination.js +1 -0
  75. package/.sinapse-ai/cli/index.js +1 -0
  76. package/.sinapse-ai/cli/utils/output-formatter-cli.js +1 -0
  77. package/.sinapse-ai/cli/utils/score-calculator.js +1 -0
  78. package/.sinapse-ai/core/README.md +1 -0
  79. package/.sinapse-ai/core/code-intel/code-intel-client.js +1 -0
  80. package/.sinapse-ai/core/code-intel/code-intel-enricher.js +1 -0
  81. package/.sinapse-ai/core/code-intel/helpers/creation-helper.js +1 -0
  82. package/.sinapse-ai/core/code-intel/helpers/dev-helper.js +1 -0
  83. package/.sinapse-ai/core/code-intel/helpers/devops-helper.js +1 -0
  84. package/.sinapse-ai/core/code-intel/helpers/planning-helper.js +1 -0
  85. package/.sinapse-ai/core/code-intel/helpers/qa-helper.js +1 -0
  86. package/.sinapse-ai/core/code-intel/helpers/story-helper.js +1 -0
  87. package/.sinapse-ai/core/code-intel/hook-runtime.js +1 -0
  88. package/.sinapse-ai/core/code-intel/index.js +1 -0
  89. package/.sinapse-ai/core/code-intel/providers/code-graph-provider.js +1 -0
  90. package/.sinapse-ai/core/code-intel/providers/provider-interface.js +1 -0
  91. package/.sinapse-ai/core/code-intel/providers/registry-provider.js +1 -0
  92. package/.sinapse-ai/core/code-intel/registry-syncer.js +1 -0
  93. package/.sinapse-ai/core/config/config-cache.js +1 -0
  94. package/.sinapse-ai/core/config/config-loader.js +1 -0
  95. package/.sinapse-ai/core/config/config-resolver.js +1 -0
  96. package/.sinapse-ai/core/config/env-interpolator.js +1 -0
  97. package/.sinapse-ai/core/config/merge-utils.js +1 -0
  98. package/.sinapse-ai/core/config/migrate-config.js +1 -0
  99. package/.sinapse-ai/core/config/schemas/framework-config.schema.json +2 -1
  100. package/.sinapse-ai/core/config/schemas/local-config.schema.json +1 -0
  101. package/.sinapse-ai/core/config/schemas/project-config.schema.json +1 -0
  102. package/.sinapse-ai/core/config/schemas/user-config.schema.json +1 -0
  103. package/.sinapse-ai/core/config/template-overrides.js +1 -0
  104. package/.sinapse-ai/core/config/templates/user-config.yaml +1 -0
  105. package/.sinapse-ai/core/docs/SHARD-TRANSLATION-GUIDE.md +1 -0
  106. package/.sinapse-ai/core/docs/component-creation-guide.md +1 -1
  107. package/.sinapse-ai/core/docs/session-update-pattern.md +1 -0
  108. package/.sinapse-ai/core/docs/template-syntax.md +1 -1
  109. package/.sinapse-ai/core/docs/troubleshooting-guide.md +1 -1
  110. package/.sinapse-ai/core/doctor/checks/agent-memory.js +1 -0
  111. package/.sinapse-ai/core/doctor/checks/claude-md.js +1 -0
  112. package/.sinapse-ai/core/doctor/checks/code-intel.js +1 -0
  113. package/.sinapse-ai/core/doctor/checks/commands-count.js +1 -0
  114. package/.sinapse-ai/core/doctor/checks/core-config.js +1 -0
  115. package/.sinapse-ai/core/doctor/checks/entity-registry.js +1 -0
  116. package/.sinapse-ai/core/doctor/checks/git-hooks.js +1 -0
  117. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +1 -0
  118. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +1 -0
  119. package/.sinapse-ai/core/doctor/checks/ide-sync.js +1 -0
  120. package/.sinapse-ai/core/doctor/checks/node-version.js +1 -0
  121. package/.sinapse-ai/core/doctor/checks/npm-packages.js +1 -0
  122. package/.sinapse-ai/core/doctor/checks/rules-files.js +1 -0
  123. package/.sinapse-ai/core/doctor/checks/settings-json.js +1 -0
  124. package/.sinapse-ai/core/doctor/checks/skills-count.js +1 -0
  125. package/.sinapse-ai/core/doctor/fix-handler.js +1 -0
  126. package/.sinapse-ai/core/doctor/formatters/json.js +1 -0
  127. package/.sinapse-ai/core/doctor/formatters/text.js +1 -0
  128. package/.sinapse-ai/core/elicitation/agent-elicitation.js +1 -1
  129. package/.sinapse-ai/core/elicitation/elicitation-engine.js +1 -0
  130. package/.sinapse-ai/core/elicitation/session-manager.js +1 -0
  131. package/.sinapse-ai/core/elicitation/task-elicitation.js +1 -1
  132. package/.sinapse-ai/core/events/dashboard-emitter.js +1 -0
  133. package/.sinapse-ai/core/events/index.js +1 -0
  134. package/.sinapse-ai/core/events/types.js +1 -0
  135. package/.sinapse-ai/core/execution/autonomous-build-loop.js +1 -0
  136. package/.sinapse-ai/core/execution/build-orchestrator.js +1 -0
  137. package/.sinapse-ai/core/execution/build-state-manager.js +1 -0
  138. package/.sinapse-ai/core/execution/context-injector.js +1 -0
  139. package/.sinapse-ai/core/execution/parallel-executor.js +1 -0
  140. package/.sinapse-ai/core/execution/parallel-monitor.js +1 -0
  141. package/.sinapse-ai/core/execution/rate-limit-manager.js +1 -0
  142. package/.sinapse-ai/core/execution/result-aggregator.js +1 -0
  143. package/.sinapse-ai/core/execution/semantic-merge-engine.js +1 -0
  144. package/.sinapse-ai/core/execution/subagent-dispatcher.js +1 -0
  145. package/.sinapse-ai/core/execution/wave-executor.js +1 -0
  146. package/.sinapse-ai/core/graph-dashboard/cli.js +1 -0
  147. package/.sinapse-ai/core/graph-dashboard/data-sources/code-intel-source.js +1 -0
  148. package/.sinapse-ai/core/graph-dashboard/data-sources/metrics-source.js +1 -0
  149. package/.sinapse-ai/core/graph-dashboard/data-sources/registry-source.js +1 -0
  150. package/.sinapse-ai/core/graph-dashboard/formatters/dot-formatter.js +1 -0
  151. package/.sinapse-ai/core/graph-dashboard/formatters/html-formatter.js +1 -0
  152. package/.sinapse-ai/core/graph-dashboard/formatters/json-formatter.js +1 -0
  153. package/.sinapse-ai/core/graph-dashboard/formatters/mermaid-formatter.js +1 -0
  154. package/.sinapse-ai/core/graph-dashboard/index.js +1 -0
  155. package/.sinapse-ai/core/graph-dashboard/renderers/stats-renderer.js +1 -0
  156. package/.sinapse-ai/core/graph-dashboard/renderers/status-renderer.js +1 -0
  157. package/.sinapse-ai/core/graph-dashboard/renderers/tree-renderer.js +1 -0
  158. package/.sinapse-ai/core/health-check/base-check.js +1 -0
  159. package/.sinapse-ai/core/health-check/check-registry.js +1 -0
  160. package/.sinapse-ai/core/health-check/checks/deployment/build-config.js +1 -0
  161. package/.sinapse-ai/core/health-check/checks/deployment/ci-config.js +1 -0
  162. package/.sinapse-ai/core/health-check/checks/deployment/deployment-readiness.js +1 -0
  163. package/.sinapse-ai/core/health-check/checks/deployment/docker-config.js +1 -0
  164. package/.sinapse-ai/core/health-check/checks/deployment/env-file.js +1 -0
  165. package/.sinapse-ai/core/health-check/checks/deployment/index.js +1 -0
  166. package/.sinapse-ai/core/health-check/checks/index.js +1 -0
  167. package/.sinapse-ai/core/health-check/checks/local/disk-space.js +1 -0
  168. package/.sinapse-ai/core/health-check/checks/local/environment-vars.js +1 -0
  169. package/.sinapse-ai/core/health-check/checks/local/git-install.js +1 -0
  170. package/.sinapse-ai/core/health-check/checks/local/ide-detection.js +1 -0
  171. package/.sinapse-ai/core/health-check/checks/local/index.js +1 -0
  172. package/.sinapse-ai/core/health-check/checks/local/memory.js +1 -0
  173. package/.sinapse-ai/core/health-check/checks/local/network.js +1 -0
  174. package/.sinapse-ai/core/health-check/checks/local/npm-install.js +1 -0
  175. package/.sinapse-ai/core/health-check/checks/local/shell-environment.js +1 -0
  176. package/.sinapse-ai/core/health-check/checks/project/agent-config.js +1 -0
  177. package/.sinapse-ai/core/health-check/checks/project/dependencies.js +1 -0
  178. package/.sinapse-ai/core/health-check/checks/project/framework-config.js +1 -0
  179. package/.sinapse-ai/core/health-check/checks/project/node-version.js +1 -0
  180. package/.sinapse-ai/core/health-check/checks/project/package-json.js +1 -0
  181. package/.sinapse-ai/core/health-check/checks/project/sinapse-directory.js +1 -0
  182. package/.sinapse-ai/core/health-check/checks/project/task-definitions.js +1 -0
  183. package/.sinapse-ai/core/health-check/checks/project/workflow-dependencies.js +1 -0
  184. package/.sinapse-ai/core/health-check/checks/repository/branch-protection.js +1 -0
  185. package/.sinapse-ai/core/health-check/checks/repository/commit-history.js +1 -0
  186. package/.sinapse-ai/core/health-check/checks/repository/conflicts.js +1 -0
  187. package/.sinapse-ai/core/health-check/checks/repository/git-repo.js +1 -0
  188. package/.sinapse-ai/core/health-check/checks/repository/git-status.js +1 -0
  189. package/.sinapse-ai/core/health-check/checks/repository/gitignore.js +1 -0
  190. package/.sinapse-ai/core/health-check/checks/repository/index.js +1 -0
  191. package/.sinapse-ai/core/health-check/checks/repository/large-files.js +1 -0
  192. package/.sinapse-ai/core/health-check/checks/repository/lockfile-integrity.js +1 -0
  193. package/.sinapse-ai/core/health-check/checks/services/api-endpoints.js +1 -0
  194. package/.sinapse-ai/core/health-check/checks/services/claude-code.js +1 -0
  195. package/.sinapse-ai/core/health-check/checks/services/github-cli.js +1 -0
  196. package/.sinapse-ai/core/health-check/checks/services/index.js +1 -2
  197. package/.sinapse-ai/core/health-check/checks/services/mcp-integration.js +1 -0
  198. package/.sinapse-ai/core/health-check/engine.js +1 -0
  199. package/.sinapse-ai/core/health-check/healers/backup-manager.js +1 -0
  200. package/.sinapse-ai/core/health-check/healers/index.js +1 -0
  201. package/.sinapse-ai/core/health-check/index.js +1 -0
  202. package/.sinapse-ai/core/health-check/reporters/console.js +1 -0
  203. package/.sinapse-ai/core/health-check/reporters/index.js +1 -0
  204. package/.sinapse-ai/core/health-check/reporters/markdown.js +1 -0
  205. package/.sinapse-ai/core/ideation/ideation-engine.js +1 -0
  206. package/.sinapse-ai/core/ids/README.md +1 -0
  207. package/.sinapse-ai/core/ids/circuit-breaker.js +1 -0
  208. package/.sinapse-ai/core/ids/framework-governor.js +1 -0
  209. package/.sinapse-ai/core/ids/gates/g1-epic-creation.js +1 -0
  210. package/.sinapse-ai/core/ids/gates/g2-story-creation.js +1 -0
  211. package/.sinapse-ai/core/ids/gates/g3-story-validation.js +1 -0
  212. package/.sinapse-ai/core/ids/gates/g4-dev-context.js +1 -0
  213. package/.sinapse-ai/core/ids/incremental-decision-engine.js +1 -0
  214. package/.sinapse-ai/core/ids/index.js +1 -0
  215. package/.sinapse-ai/core/ids/layer-classifier.js +1 -0
  216. package/.sinapse-ai/core/ids/registry-healer.js +1 -0
  217. package/.sinapse-ai/core/ids/registry-loader.js +1 -0
  218. package/.sinapse-ai/core/ids/registry-updater.js +1 -0
  219. package/.sinapse-ai/core/ids/verification-gate.js +1 -0
  220. package/.sinapse-ai/core/index.esm.js +1 -0
  221. package/.sinapse-ai/core/index.js +1 -0
  222. package/.sinapse-ai/core/manifest/manifest-generator.js +1 -0
  223. package/.sinapse-ai/core/manifest/manifest-validator.js +1 -0
  224. package/.sinapse-ai/core/mcp/config-migrator.js +1 -0
  225. package/.sinapse-ai/core/mcp/global-config-manager.js +1 -0
  226. package/.sinapse-ai/core/mcp/index.js +1 -0
  227. package/.sinapse-ai/core/mcp/os-detector.js +1 -0
  228. package/.sinapse-ai/core/mcp/symlink-manager.js +1 -0
  229. package/.sinapse-ai/core/memory/__tests__/active-modules.verify.js +1 -0
  230. package/.sinapse-ai/core/memory/gotchas-memory.js +1 -0
  231. package/.sinapse-ai/core/migration/migration-config.yaml +1 -0
  232. package/.sinapse-ai/core/migration/module-mapping.yaml +1 -0
  233. package/.sinapse-ai/core/orchestration/agent-invoker.js +1 -0
  234. package/.sinapse-ai/core/orchestration/bob-orchestrator.js +1 -0
  235. package/.sinapse-ai/core/orchestration/bob-status-writer.js +1 -0
  236. package/.sinapse-ai/core/orchestration/bob-surface-criteria.yaml +1 -0
  237. package/.sinapse-ai/core/orchestration/brownfield-handler.js +1 -0
  238. package/.sinapse-ai/core/orchestration/checklist-runner.js +1 -0
  239. package/.sinapse-ai/core/orchestration/cli-commands.js +1 -0
  240. package/.sinapse-ai/core/orchestration/condition-evaluator.js +1 -0
  241. package/.sinapse-ai/core/orchestration/context-manager.js +1 -0
  242. package/.sinapse-ai/core/orchestration/dashboard-integration.js +1 -0
  243. package/.sinapse-ai/core/orchestration/data-lifecycle-manager.js +1 -0
  244. package/.sinapse-ai/core/orchestration/epic-context-accumulator.js +1 -0
  245. package/.sinapse-ai/core/orchestration/execution-profile-resolver.js +1 -0
  246. package/.sinapse-ai/core/orchestration/executor-assignment.js +1 -0
  247. package/.sinapse-ai/core/orchestration/executors/epic-3-executor.js +1 -0
  248. package/.sinapse-ai/core/orchestration/executors/epic-4-executor.js +1 -0
  249. package/.sinapse-ai/core/orchestration/executors/epic-5-executor.js +1 -0
  250. package/.sinapse-ai/core/orchestration/executors/epic-6-executor.js +1 -0
  251. package/.sinapse-ai/core/orchestration/executors/epic-executor.js +1 -0
  252. package/.sinapse-ai/core/orchestration/executors/index.js +1 -0
  253. package/.sinapse-ai/core/orchestration/gate-evaluator.js +1 -0
  254. package/.sinapse-ai/core/orchestration/greenfield-handler.js +1 -0
  255. package/.sinapse-ai/core/orchestration/index.js +1 -0
  256. package/.sinapse-ai/core/orchestration/lock-manager.js +1 -0
  257. package/.sinapse-ai/core/orchestration/master-orchestrator.js +1 -0
  258. package/.sinapse-ai/core/orchestration/message-formatter.js +1 -0
  259. package/.sinapse-ai/core/orchestration/parallel-executor.js +1 -0
  260. package/.sinapse-ai/core/orchestration/recovery-handler.js +1 -0
  261. package/.sinapse-ai/core/orchestration/session-state.js +1 -0
  262. package/.sinapse-ai/core/orchestration/skill-dispatcher.js +1 -0
  263. package/.sinapse-ai/core/orchestration/subagent-prompt-builder.js +1 -0
  264. package/.sinapse-ai/core/orchestration/surface-checker.js +1 -0
  265. package/.sinapse-ai/core/orchestration/task-complexity-classifier.js +1 -0
  266. package/.sinapse-ai/core/orchestration/tech-stack-detector.js +1 -0
  267. package/.sinapse-ai/core/orchestration/terminal-spawner.js +1 -0
  268. package/.sinapse-ai/core/orchestration/workflow-executor.js +1 -0
  269. package/.sinapse-ai/core/orchestration/workflow-orchestrator.js +1 -0
  270. package/.sinapse-ai/core/permissions/__tests__/permission-mode.test.js +1 -0
  271. package/.sinapse-ai/core/permissions/index.js +1 -0
  272. package/.sinapse-ai/core/permissions/operation-guard.js +1 -0
  273. package/.sinapse-ai/core/permissions/permission-mode.js +1 -0
  274. package/.sinapse-ai/core/quality-gates/base-layer.js +1 -0
  275. package/.sinapse-ai/core/quality-gates/checklist-generator.js +1 -0
  276. package/.sinapse-ai/core/quality-gates/human-review-orchestrator.js +1 -0
  277. package/.sinapse-ai/core/quality-gates/index.js +244 -0
  278. package/.sinapse-ai/core/quality-gates/layer1-precommit.js +1 -0
  279. package/.sinapse-ai/core/quality-gates/layer2-pr-automation.js +1 -0
  280. package/.sinapse-ai/core/quality-gates/layer3-human-review.js +1 -0
  281. package/.sinapse-ai/core/quality-gates/notification-manager.js +1 -0
  282. package/.sinapse-ai/core/quality-gates/quality-gate-config.js +462 -0
  283. package/.sinapse-ai/core/quality-gates/quality-gate-config.yaml +105 -16
  284. package/.sinapse-ai/core/quality-gates/quality-gate-manager.js +1 -0
  285. package/.sinapse-ai/core/registry/README.md +1 -0
  286. package/.sinapse-ai/core/registry/build-registry.js +1 -0
  287. package/.sinapse-ai/core/registry/registry-loader.js +1 -0
  288. package/.sinapse-ai/core/registry/registry-schema.json +1 -0
  289. package/.sinapse-ai/core/registry/service-registry.json +0 -120
  290. package/.sinapse-ai/core/registry/validate-registry.js +1 -0
  291. package/.sinapse-ai/core/session/context-detector.js +1 -0
  292. package/.sinapse-ai/core/session/context-loader.js +1 -0
  293. package/.sinapse-ai/core/synapse/context/context-builder.js +1 -0
  294. package/.sinapse-ai/core/synapse/context/context-tracker.js +1 -0
  295. package/.sinapse-ai/core/synapse/diagnostics/collectors/consistency-collector.js +1 -0
  296. package/.sinapse-ai/core/synapse/diagnostics/collectors/hook-collector.js +1 -0
  297. package/.sinapse-ai/core/synapse/diagnostics/collectors/manifest-collector.js +1 -0
  298. package/.sinapse-ai/core/synapse/diagnostics/collectors/output-analyzer.js +1 -0
  299. package/.sinapse-ai/core/synapse/diagnostics/collectors/pipeline-collector.js +1 -0
  300. package/.sinapse-ai/core/synapse/diagnostics/collectors/quality-collector.js +1 -0
  301. package/.sinapse-ai/core/synapse/diagnostics/collectors/relevance-matrix.js +1 -0
  302. package/.sinapse-ai/core/synapse/diagnostics/collectors/safe-read-json.js +1 -0
  303. package/.sinapse-ai/core/synapse/diagnostics/collectors/session-collector.js +1 -0
  304. package/.sinapse-ai/core/synapse/diagnostics/collectors/timing-collector.js +1 -0
  305. package/.sinapse-ai/core/synapse/diagnostics/collectors/uap-collector.js +1 -0
  306. package/.sinapse-ai/core/synapse/diagnostics/report-formatter.js +1 -0
  307. package/.sinapse-ai/core/synapse/diagnostics/synapse-diagnostics.js +1 -0
  308. package/.sinapse-ai/core/synapse/domain/domain-loader.js +1 -0
  309. package/.sinapse-ai/core/synapse/engine.js +1 -0
  310. package/.sinapse-ai/core/synapse/layers/l0-constitution.js +1 -0
  311. package/.sinapse-ai/core/synapse/layers/l1-global.js +1 -0
  312. package/.sinapse-ai/core/synapse/layers/l2-agent.js +1 -0
  313. package/.sinapse-ai/core/synapse/layers/l3-workflow.js +1 -0
  314. package/.sinapse-ai/core/synapse/layers/l4-task.js +1 -0
  315. package/.sinapse-ai/core/synapse/layers/l5-squad.js +1 -0
  316. package/.sinapse-ai/core/synapse/layers/l6-keyword.js +1 -0
  317. package/.sinapse-ai/core/synapse/layers/l7-star-command.js +1 -0
  318. package/.sinapse-ai/core/synapse/layers/layer-processor.js +1 -0
  319. package/.sinapse-ai/core/synapse/memory/memory-bridge.js +1 -0
  320. package/.sinapse-ai/core/synapse/memory/synapse-memory-provider.js +1 -0
  321. package/.sinapse-ai/core/synapse/output/formatter.js +1 -0
  322. package/.sinapse-ai/core/synapse/runtime/hook-runtime.js +1 -0
  323. package/.sinapse-ai/core/synapse/scripts/generate-constitution.js +1 -0
  324. package/.sinapse-ai/core/synapse/session/session-manager.js +1 -0
  325. package/.sinapse-ai/core/synapse/utils/atomic-write.js +1 -0
  326. package/.sinapse-ai/core/synapse/utils/paths.js +1 -0
  327. package/.sinapse-ai/core/synapse/utils/tokens.js +1 -0
  328. package/.sinapse-ai/core/ui/index.js +1 -0
  329. package/.sinapse-ai/core/ui/observability-panel.js +1 -0
  330. package/.sinapse-ai/core/ui/panel-renderer.js +1 -0
  331. package/.sinapse-ai/core/utils/output-formatter.js +1 -0
  332. package/.sinapse-ai/core/utils/security-utils.js +1 -0
  333. package/.sinapse-ai/core/utils/yaml-validator.js +1 -0
  334. package/.sinapse-ai/data/agent-config-requirements.yaml +1 -0
  335. package/.sinapse-ai/data/capability-detection.js +1 -0
  336. package/.sinapse-ai/data/entity-registry.yaml +1654 -1831
  337. package/.sinapse-ai/data/learned-patterns.yaml +1 -0
  338. package/.sinapse-ai/data/mcp-discipline.js +1 -0
  339. package/.sinapse-ai/data/mcp-tool-examples.yaml +1 -0
  340. package/.sinapse-ai/data/registry-update-log.jsonl +709 -0
  341. package/.sinapse-ai/data/tok2-validation.js +1 -0
  342. package/.sinapse-ai/data/tok3-token-comparison.js +1 -0
  343. package/.sinapse-ai/data/tool-registry.yaml +1 -0
  344. package/.sinapse-ai/data/tool-search-validation.js +1 -0
  345. package/.sinapse-ai/data/workflow-chains.yaml +1 -0
  346. package/.sinapse-ai/data/workflow-patterns.yaml +1 -0
  347. package/.sinapse-ai/data/workflow-state-schema.yaml +1 -0
  348. package/.sinapse-ai/development/README.md +1 -0
  349. package/.sinapse-ai/development/agents/analyst/MEMORY.md +1 -0
  350. package/.sinapse-ai/development/agents/analyst.md +90 -0
  351. package/.sinapse-ai/development/agents/architect.md +73 -0
  352. package/.sinapse-ai/development/agents/data-engineer/MEMORY.md +1 -0
  353. package/.sinapse-ai/development/agents/data-engineer.md +1 -0
  354. package/.sinapse-ai/development/agents/developer/MEMORY.md +1 -0
  355. package/.sinapse-ai/development/agents/developer.md +69 -0
  356. package/.sinapse-ai/development/agents/devops/MEMORY.md +1 -0
  357. package/.sinapse-ai/development/agents/devops.md +117 -0
  358. package/.sinapse-ai/development/agents/project-lead/MEMORY.md +1 -0
  359. package/.sinapse-ai/development/agents/quality-gate/MEMORY.md +1 -0
  360. package/.sinapse-ai/development/agents/quality-gate.md +85 -0
  361. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +1 -0
  362. package/.sinapse-ai/development/agents/ux/MEMORY.md +1 -0
  363. package/.sinapse-ai/development/checklists/agent-quality-gate.md +28 -0
  364. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +21 -0
  365. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  366. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +10 -0
  367. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +17 -0
  368. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  369. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  370. package/.sinapse-ai/development/checklists/self-critique-checklist.md +20 -1
  371. package/.sinapse-ai/development/data/quality-dimensions-framework.md +1 -0
  372. package/.sinapse-ai/development/data/tier-system-framework.md +1 -0
  373. package/.sinapse-ai/development/scripts/activation-runtime.js +1 -0
  374. package/.sinapse-ai/development/scripts/agent-assignment-resolver.js +1 -0
  375. package/.sinapse-ai/development/scripts/agent-config-loader.js +1 -0
  376. package/.sinapse-ai/development/scripts/agent-exit-hooks.js +1 -0
  377. package/.sinapse-ai/development/scripts/apply-inline-greeting-all-agents.js +1 -0
  378. package/.sinapse-ai/development/scripts/approval-workflow.js +1 -1
  379. package/.sinapse-ai/development/scripts/backlog-manager.js +1 -0
  380. package/.sinapse-ai/development/scripts/backup-manager.js +1 -1
  381. package/.sinapse-ai/development/scripts/batch-update-agents-session-context.js +1 -0
  382. package/.sinapse-ai/development/scripts/branch-manager.js +1 -1
  383. package/.sinapse-ai/development/scripts/code-quality-improver.js +1 -1
  384. package/.sinapse-ai/development/scripts/commit-message-generator.js +1 -1
  385. package/.sinapse-ai/development/scripts/conflict-resolver.js +1 -1
  386. package/.sinapse-ai/development/scripts/decision-context.js +1 -0
  387. package/.sinapse-ai/development/scripts/decision-log-generator.js +1 -0
  388. package/.sinapse-ai/development/scripts/decision-log-indexer.js +1 -0
  389. package/.sinapse-ai/development/scripts/decision-recorder.js +1 -0
  390. package/.sinapse-ai/development/scripts/dependency-analyzer.js +1 -1
  391. package/.sinapse-ai/development/scripts/dev-context-loader.js +1 -0
  392. package/.sinapse-ai/development/scripts/diff-generator.js +1 -1
  393. package/.sinapse-ai/development/scripts/elicitation-engine.js +1 -1
  394. package/.sinapse-ai/development/scripts/elicitation-session-manager.js +1 -1
  395. package/.sinapse-ai/development/scripts/generate-greeting.js +1 -0
  396. package/.sinapse-ai/development/scripts/git-wrapper.js +1 -1
  397. package/.sinapse-ai/development/scripts/greeting-builder.js +1 -0
  398. package/.sinapse-ai/development/scripts/greeting-config-cli.js +1 -0
  399. package/.sinapse-ai/development/scripts/greeting-preference-manager.js +1 -0
  400. package/.sinapse-ai/development/scripts/issue-triage.js +1 -0
  401. package/.sinapse-ai/development/scripts/manifest-preview.js +1 -1
  402. package/.sinapse-ai/development/scripts/metrics-tracker.js +1 -1
  403. package/.sinapse-ai/development/scripts/migrate-task-to-v2.js +1 -0
  404. package/.sinapse-ai/development/scripts/modification-validator.js +1 -1
  405. package/.sinapse-ai/development/scripts/pattern-learner.js +1 -1
  406. package/.sinapse-ai/development/scripts/performance-analyzer.js +1 -1
  407. package/.sinapse-ai/development/scripts/populate-entity-registry.js +1 -0
  408. package/.sinapse-ai/development/scripts/refactoring-suggester.js +1 -1
  409. package/.sinapse-ai/development/scripts/rollback-handler.js +1 -1
  410. package/.sinapse-ai/development/scripts/security-checker.js +1 -1
  411. package/.sinapse-ai/development/scripts/skill-validator.js +1 -0
  412. package/.sinapse-ai/development/scripts/squad/README.md +1 -0
  413. package/.sinapse-ai/development/scripts/squad/index.js +1 -0
  414. package/.sinapse-ai/development/scripts/squad/squad-analyzer.js +1 -0
  415. package/.sinapse-ai/development/scripts/squad/squad-designer.js +1 -0
  416. package/.sinapse-ai/development/scripts/squad/squad-extender.js +1 -0
  417. package/.sinapse-ai/development/scripts/squad/squad-generator.js +1 -0
  418. package/.sinapse-ai/development/scripts/squad/squad-loader.js +1 -0
  419. package/.sinapse-ai/development/scripts/squad/squad-migrator.js +1 -0
  420. package/.sinapse-ai/development/scripts/squad/squad-validator.js +1 -0
  421. package/.sinapse-ai/development/scripts/story-index-generator.js +1 -0
  422. package/.sinapse-ai/development/scripts/story-manager.js +1 -0
  423. package/.sinapse-ai/development/scripts/story-update-hook.js +1 -0
  424. package/.sinapse-ai/development/scripts/task-identifier-resolver.js +1 -0
  425. package/.sinapse-ai/development/scripts/template-engine.js +1 -1
  426. package/.sinapse-ai/development/scripts/template-validator.js +1 -1
  427. package/.sinapse-ai/development/scripts/test-generator.js +1 -1
  428. package/.sinapse-ai/development/scripts/test-greeting-system.js +1 -0
  429. package/.sinapse-ai/development/scripts/transaction-manager.js +1 -1
  430. package/.sinapse-ai/development/scripts/unified-activation-pipeline.js +1 -0
  431. package/.sinapse-ai/development/scripts/usage-tracker.js +1 -1
  432. package/.sinapse-ai/development/scripts/validate-filenames.js +1 -0
  433. package/.sinapse-ai/development/scripts/validate-task-v2.js +1 -0
  434. package/.sinapse-ai/development/scripts/verify-workflow-gaps.js +1 -0
  435. package/.sinapse-ai/development/scripts/version-tracker.js +1 -1
  436. package/.sinapse-ai/development/scripts/workflow-navigator.js +1 -0
  437. package/.sinapse-ai/development/scripts/workflow-state-manager.js +1 -0
  438. package/.sinapse-ai/development/scripts/workflow-validator.js +1 -0
  439. package/.sinapse-ai/development/scripts/yaml-validator.js +1 -1
  440. package/.sinapse-ai/development/skills/debug.md +57 -0
  441. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  442. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  443. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  444. package/.sinapse-ai/development/skills/verify.md +53 -0
  445. package/.sinapse-ai/development/tasks/add-mcp.md +1 -0
  446. package/.sinapse-ai/development/tasks/advanced-elicitation.md +1 -1
  447. package/.sinapse-ai/development/tasks/analyst-facilitate-brainstorming.md +1 -1
  448. package/.sinapse-ai/development/tasks/analyze-brownfield.md +1 -0
  449. package/.sinapse-ai/development/tasks/analyze-cross-artifact.md +1 -0
  450. package/.sinapse-ai/development/tasks/analyze-framework.md +1 -1
  451. package/.sinapse-ai/development/tasks/analyze-performance.md +1 -0
  452. package/.sinapse-ai/development/tasks/architect-analyze-impact.md +1 -1
  453. package/.sinapse-ai/development/tasks/audit-codebase.md +1 -0
  454. package/.sinapse-ai/development/tasks/audit-tailwind-config.md +1 -0
  455. package/.sinapse-ai/development/tasks/audit-utilities.md +1 -0
  456. package/.sinapse-ai/development/tasks/blocks/README.md +1 -0
  457. package/.sinapse-ai/development/tasks/blocks/agent-prompt-template.md +1 -0
  458. package/.sinapse-ai/development/tasks/blocks/context-loading.md +1 -0
  459. package/.sinapse-ai/development/tasks/blocks/execution-pattern.md +1 -0
  460. package/.sinapse-ai/development/tasks/blocks/finalization.md +1 -0
  461. package/.sinapse-ai/development/tasks/bootstrap-shadcn-library.md +1 -0
  462. package/.sinapse-ai/development/tasks/build-component.md +1 -0
  463. package/.sinapse-ai/development/tasks/calculate-roi.md +1 -0
  464. package/.sinapse-ai/development/tasks/check-docs-links.md +1 -0
  465. package/.sinapse-ai/development/tasks/ci-cd-configuration.md +1 -0
  466. package/.sinapse-ai/development/tasks/cleanup-utilities.md +1 -0
  467. package/.sinapse-ai/development/tasks/cleanup-worktrees.md +1 -0
  468. package/.sinapse-ai/development/tasks/collaborative-edit.md +1 -1
  469. package/.sinapse-ai/development/tasks/compose-molecule.md +1 -0
  470. package/.sinapse-ai/development/tasks/consolidate-patterns.md +1 -0
  471. package/.sinapse-ai/development/tasks/correct-course.md +1 -1
  472. package/.sinapse-ai/development/tasks/create-doc.md +1 -0
  473. package/.sinapse-ai/development/tasks/create-task.md +1 -1
  474. package/.sinapse-ai/development/tasks/db-analyze-hotpaths.md +1 -0
  475. package/.sinapse-ai/development/tasks/db-apply-migration.md +1 -0
  476. package/.sinapse-ai/development/tasks/db-bootstrap.md +1 -0
  477. package/.sinapse-ai/development/tasks/db-domain-modeling.md +1 -0
  478. package/.sinapse-ai/development/tasks/db-dry-run.md +1 -0
  479. package/.sinapse-ai/development/tasks/db-env-check.md +1 -0
  480. package/.sinapse-ai/development/tasks/db-explain.md +1 -0
  481. package/.sinapse-ai/development/tasks/db-impersonate.md +1 -0
  482. package/.sinapse-ai/development/tasks/db-load-csv.md +1 -0
  483. package/.sinapse-ai/development/tasks/db-policy-apply.md +1 -0
  484. package/.sinapse-ai/development/tasks/db-rls-audit.md +1 -0
  485. package/.sinapse-ai/development/tasks/db-rollback.md +1 -0
  486. package/.sinapse-ai/development/tasks/db-run-sql.md +1 -0
  487. package/.sinapse-ai/development/tasks/db-schema-audit.md +1 -0
  488. package/.sinapse-ai/development/tasks/db-seed.md +1 -0
  489. package/.sinapse-ai/development/tasks/db-smoke-test.md +1 -0
  490. package/.sinapse-ai/development/tasks/db-snapshot.md +1 -0
  491. package/.sinapse-ai/development/tasks/db-squad-integration.md +1 -0
  492. package/.sinapse-ai/development/tasks/db-supabase-setup.md +1 -0
  493. package/.sinapse-ai/development/tasks/db-verify-order.md +1 -0
  494. package/.sinapse-ai/development/tasks/deprecate-component.md +1 -1
  495. package/.sinapse-ai/development/tasks/dev-apply-qa-fixes.md +1 -0
  496. package/.sinapse-ai/development/tasks/dev-improve-code-quality.md +1 -1
  497. package/.sinapse-ai/development/tasks/dev-optimize-performance.md +1 -1
  498. package/.sinapse-ai/development/tasks/dev-suggest-refactoring.md +1 -1
  499. package/.sinapse-ai/development/tasks/dev-validate-next-story.md +1 -1
  500. package/.sinapse-ai/development/tasks/document-gotchas.md +1 -0
  501. package/.sinapse-ai/development/tasks/document-project.md +1 -1
  502. package/.sinapse-ai/development/tasks/export-design-tokens-dtcg.md +1 -0
  503. package/.sinapse-ai/development/tasks/extend-pattern.md +1 -0
  504. package/.sinapse-ai/development/tasks/extract-tokens.md +1 -0
  505. package/.sinapse-ai/development/tasks/facilitate-brainstorming-session.md +1 -0
  506. package/.sinapse-ai/development/tasks/generate-ai-frontend-prompt.md +1 -1
  507. package/.sinapse-ai/development/tasks/generate-documentation.md +1 -0
  508. package/.sinapse-ai/development/tasks/generate-migration-strategy.md +1 -0
  509. package/.sinapse-ai/development/tasks/generate-shock-report.md +1 -0
  510. package/.sinapse-ai/development/tasks/github-devops-pre-push-quality-gate.md +1 -0
  511. package/.sinapse-ai/development/tasks/github-devops-repository-cleanup.md +1 -0
  512. package/.sinapse-ai/development/tasks/github-devops-version-management.md +1 -0
  513. package/.sinapse-ai/development/tasks/github-issue-triage.md +1 -0
  514. package/.sinapse-ai/development/tasks/ids-health.md +1 -0
  515. package/.sinapse-ai/development/tasks/ids-query.md +1 -0
  516. package/.sinapse-ai/development/tasks/improve-self.md +1 -1
  517. package/.sinapse-ai/development/tasks/index-docs.md +1 -1
  518. package/.sinapse-ai/development/tasks/integrate-squad.md +1 -0
  519. package/.sinapse-ai/development/tasks/kb-mode-interaction.md +1 -1
  520. package/.sinapse-ai/development/tasks/learn-patterns.md +1 -1
  521. package/.sinapse-ai/development/tasks/list-mcps.md +1 -0
  522. package/.sinapse-ai/development/tasks/mcp-workflow.md +1 -0
  523. package/.sinapse-ai/development/tasks/merge-worktree.md +1 -0
  524. package/.sinapse-ai/development/tasks/modify-agent.md +1 -1
  525. package/.sinapse-ai/development/tasks/modify-task.md +1 -1
  526. package/.sinapse-ai/development/tasks/modify-workflow.md +1 -1
  527. package/.sinapse-ai/development/tasks/orchestrate-resume.md +1 -0
  528. package/.sinapse-ai/development/tasks/orchestrate-status.md +1 -0
  529. package/.sinapse-ai/development/tasks/orchestrate-stop.md +1 -0
  530. package/.sinapse-ai/development/tasks/orchestrate.md +1 -0
  531. package/.sinapse-ai/development/tasks/po-manage-story-backlog.md +1 -0
  532. package/.sinapse-ai/development/tasks/po-pull-story-from-clickup.md +1 -0
  533. package/.sinapse-ai/development/tasks/po-pull-story.md +1 -0
  534. package/.sinapse-ai/development/tasks/po-sync-story-to-clickup.md +1 -0
  535. package/.sinapse-ai/development/tasks/po-sync-story.md +1 -0
  536. package/.sinapse-ai/development/tasks/propose-modification.md +1 -1
  537. package/.sinapse-ai/development/tasks/publish-npm.md +1 -0
  538. package/.sinapse-ai/development/tasks/qa-browser-console-check.md +1 -0
  539. package/.sinapse-ai/development/tasks/qa-evidence-requirements.md +1 -0
  540. package/.sinapse-ai/development/tasks/qa-false-positive-detection.md +1 -0
  541. package/.sinapse-ai/development/tasks/qa-gate.md +1 -1
  542. package/.sinapse-ai/development/tasks/qa-generate-tests.md +1 -1
  543. package/.sinapse-ai/development/tasks/qa-library-validation.md +1 -0
  544. package/.sinapse-ai/development/tasks/qa-migration-validation.md +1 -0
  545. package/.sinapse-ai/development/tasks/qa-nfr-assess.md +1 -1
  546. package/.sinapse-ai/development/tasks/qa-review-proposal.md +1 -1
  547. package/.sinapse-ai/development/tasks/qa-risk-profile.md +1 -1
  548. package/.sinapse-ai/development/tasks/qa-security-checklist.md +1 -0
  549. package/.sinapse-ai/development/tasks/qa-test-design.md +1 -1
  550. package/.sinapse-ai/development/tasks/qa-trace-requirements.md +1 -1
  551. package/.sinapse-ai/development/tasks/remove-mcp.md +1 -0
  552. package/.sinapse-ai/development/tasks/review-contributor-pr.md +1 -0
  553. package/.sinapse-ai/development/tasks/run-design-system-pipeline.md +1 -0
  554. package/.sinapse-ai/development/tasks/run-workflow.md +1 -0
  555. package/.sinapse-ai/development/tasks/search-mcp.md +1 -0
  556. package/.sinapse-ai/development/tasks/security-audit.md +1 -0
  557. package/.sinapse-ai/development/tasks/security-scan.md +1 -0
  558. package/.sinapse-ai/development/tasks/session-resume.md +1 -0
  559. package/.sinapse-ai/development/tasks/setup-database.md +1 -0
  560. package/.sinapse-ai/development/tasks/setup-design-system.md +1 -0
  561. package/.sinapse-ai/development/tasks/setup-project-docs.md +1 -0
  562. package/.sinapse-ai/development/tasks/shard-doc.md +1 -1
  563. package/.sinapse-ai/development/tasks/sm-create-next-story.md +1 -0
  564. package/.sinapse-ai/development/tasks/squad-creator-analyze.md +1 -0
  565. package/.sinapse-ai/development/tasks/squad-creator-design.md +1 -0
  566. package/.sinapse-ai/development/tasks/squad-creator-extend.md +1 -0
  567. package/.sinapse-ai/development/tasks/squad-creator-list.md +1 -0
  568. package/.sinapse-ai/development/tasks/squad-creator-migrate.md +1 -0
  569. package/.sinapse-ai/development/tasks/squad-creator-validate.md +1 -0
  570. package/.sinapse-ai/development/tasks/sync-documentation.md +1 -1
  571. package/.sinapse-ai/development/tasks/sync-registry-intel.md +1 -0
  572. package/.sinapse-ai/development/tasks/tailwind-upgrade.md +1 -0
  573. package/.sinapse-ai/development/tasks/test-as-user.md +1 -0
  574. package/.sinapse-ai/development/tasks/test-validation-task.md +1 -0
  575. package/.sinapse-ai/development/tasks/triage-github-issues.md +1 -0
  576. package/.sinapse-ai/development/tasks/undo-last.md +1 -1
  577. package/.sinapse-ai/development/tasks/update-manifest.md +1 -1
  578. package/.sinapse-ai/development/tasks/update-source-tree.md +1 -0
  579. package/.sinapse-ai/development/tasks/ux-create-wireframe.md +1 -0
  580. package/.sinapse-ai/development/tasks/ux-ds-scan-artifact.md +1 -0
  581. package/.sinapse-ai/development/tasks/ux-user-research.md +1 -0
  582. package/.sinapse-ai/development/tasks/validate-agents.md +1 -0
  583. package/.sinapse-ai/development/tasks/validate-workflow.md +1 -0
  584. package/.sinapse-ai/development/tasks/yolo-toggle.md +1 -0
  585. package/.sinapse-ai/development/templates/ptc-entity-validation.md +1 -0
  586. package/.sinapse-ai/development/templates/ptc-qa-gate.md +1 -0
  587. package/.sinapse-ai/development/templates/ptc-research-aggregation.md +1 -0
  588. package/.sinapse-ai/development/templates/research-prompt-tmpl.md +1 -0
  589. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -158
  590. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -237
  591. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -403
  592. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -182
  593. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -120
  594. package/.sinapse-ai/development/templates/service-template/jest.config.js +1 -0
  595. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -87
  596. package/.sinapse-ai/development/templates/service-template/tsconfig.json +1 -0
  597. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -145
  598. package/.sinapse-ai/development/templates/sinapse-doc-template.md +1 -0
  599. package/.sinapse-ai/development/templates/squad/agent-template.md +18 -4
  600. package/.sinapse-ai/development/templates/squad/checklist-template.md +14 -5
  601. package/.sinapse-ai/development/templates/squad/data-template.yaml +1 -0
  602. package/.sinapse-ai/development/templates/squad/script-template.js +1 -0
  603. package/.sinapse-ai/development/templates/squad/task-template.md +8 -0
  604. package/.sinapse-ai/development/templates/squad/template-template.md +1 -0
  605. package/.sinapse-ai/development/templates/squad/tool-template.js +1 -0
  606. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +8 -0
  607. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -21
  608. package/.sinapse-ai/development/templates/squad-template/README.md +1 -0
  609. package/.sinapse-ai/development/templates/squad-template/agents/example-agent.yaml +1 -0
  610. package/.sinapse-ai/development/templates/squad-template/package.json +1 -0
  611. package/.sinapse-ai/development/templates/squad-template/squad.yaml +1 -0
  612. package/.sinapse-ai/development/templates/squad-template/tasks/example-task.yaml +1 -0
  613. package/.sinapse-ai/development/templates/squad-template/templates/example-template.md +1 -0
  614. package/.sinapse-ai/development/templates/squad-template/tests/example-agent.test.js +1 -0
  615. package/.sinapse-ai/development/templates/squad-template/workflows/example-workflow.yaml +1 -0
  616. package/.sinapse-ai/development/workflows/README.md +1 -0
  617. package/.sinapse-ai/development/workflows/auto-worktree.yaml +1 -0
  618. package/.sinapse-ai/development/workflows/brownfield-discovery.yaml +1 -0
  619. package/.sinapse-ai/development/workflows/brownfield-fullstack.yaml +1 -0
  620. package/.sinapse-ai/development/workflows/brownfield-service.yaml +1 -0
  621. package/.sinapse-ai/development/workflows/brownfield-ui.yaml +1 -0
  622. package/.sinapse-ai/development/workflows/design-system-build-quality.yaml +1 -0
  623. package/.sinapse-ai/development/workflows/development-cycle.yaml +1 -0
  624. package/.sinapse-ai/development/workflows/epic-orchestration.yaml +1 -0
  625. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  626. package/.sinapse-ai/development/workflows/greenfield-fullstack.yaml +1 -0
  627. package/.sinapse-ai/development/workflows/greenfield-service.yaml +1 -0
  628. package/.sinapse-ai/development/workflows/greenfield-ui.yaml +1 -0
  629. package/.sinapse-ai/development/workflows/qa-loop.yaml +1 -0
  630. package/.sinapse-ai/development/workflows/spec-pipeline.yaml +1 -0
  631. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +1 -0
  632. package/.sinapse-ai/docs/standards/EXECUTOR-DECISION-TREE.md +1 -0
  633. package/.sinapse-ai/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +1 -0
  634. package/.sinapse-ai/docs/standards/QUALITY-GATES-SPECIFICATION.md +1 -0
  635. package/.sinapse-ai/docs/standards/SINAPSE-COLOR-PALETTE-QUICK-REFERENCE.md +1 -0
  636. package/.sinapse-ai/docs/standards/SINAPSE-COLOR-PALETTE-V2.1.md +1 -0
  637. package/.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md +1 -0
  638. package/.sinapse-ai/docs/standards/STANDARDS-INDEX.md +1 -0
  639. package/.sinapse-ai/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +1 -0
  640. package/.sinapse-ai/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md +1 -0
  641. package/.sinapse-ai/elicitation/agent-elicitation.js +1 -1
  642. package/.sinapse-ai/elicitation/task-elicitation.js +1 -1
  643. package/.sinapse-ai/elicitation/workflow-elicitation.js +1 -1
  644. package/.sinapse-ai/framework-config.yaml +1 -16
  645. package/.sinapse-ai/hooks/ids-post-commit.js +1 -0
  646. package/.sinapse-ai/hooks/ids-pre-push.js +1 -0
  647. package/.sinapse-ai/hooks/unified/README.md +11 -11
  648. package/.sinapse-ai/hooks/unified/hook-interface.js +1 -0
  649. package/.sinapse-ai/hooks/unified/hook-registry.js +1 -0
  650. package/.sinapse-ai/hooks/unified/index.js +1 -0
  651. package/.sinapse-ai/hooks/unified/runners/precompact-runner.js +1 -0
  652. package/.sinapse-ai/index.esm.js +1 -1
  653. package/.sinapse-ai/index.js +1 -1
  654. package/.sinapse-ai/infrastructure/README.md +1 -0
  655. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-4.0.4.yaml +1 -21
  656. package/.sinapse-ai/infrastructure/index.js +1 -0
  657. package/.sinapse-ai/infrastructure/integrations/ai-providers/README.md +1 -0
  658. package/.sinapse-ai/infrastructure/integrations/ai-providers/ai-provider-factory.js +7 -5
  659. package/.sinapse-ai/infrastructure/integrations/ai-providers/ai-provider.js +1 -0
  660. package/.sinapse-ai/infrastructure/integrations/ai-providers/claude-provider.js +1 -0
  661. package/.sinapse-ai/infrastructure/integrations/ai-providers/index.js +1 -0
  662. package/.sinapse-ai/infrastructure/integrations/pm-adapters/README.md +1 -0
  663. package/.sinapse-ai/infrastructure/integrations/pm-adapters/clickup-adapter.js +1 -0
  664. package/.sinapse-ai/infrastructure/integrations/pm-adapters/github-adapter.js +1 -0
  665. package/.sinapse-ai/infrastructure/integrations/pm-adapters/jira-adapter.js +1 -0
  666. package/.sinapse-ai/infrastructure/integrations/pm-adapters/local-adapter.js +1 -0
  667. package/.sinapse-ai/infrastructure/schemas/agent-v3-schema.json +1 -0
  668. package/.sinapse-ai/infrastructure/schemas/task-v3-schema.json +1 -0
  669. package/.sinapse-ai/infrastructure/scripts/approach-manager.js +1 -0
  670. package/.sinapse-ai/infrastructure/scripts/approval-workflow.js +1 -1
  671. package/.sinapse-ai/infrastructure/scripts/asset-inventory.js +1 -0
  672. package/.sinapse-ai/infrastructure/scripts/atomic-layer-classifier.js +1 -0
  673. package/.sinapse-ai/infrastructure/scripts/backup-manager.js +1 -1
  674. package/.sinapse-ai/infrastructure/scripts/batch-creator.js +1 -1
  675. package/.sinapse-ai/infrastructure/scripts/branch-manager.js +1 -1
  676. package/.sinapse-ai/infrastructure/scripts/capability-analyzer.js +1 -1
  677. package/.sinapse-ai/infrastructure/scripts/changelog-generator.js +1 -0
  678. package/.sinapse-ai/infrastructure/scripts/cicd-discovery.js +1 -0
  679. package/.sinapse-ai/infrastructure/scripts/clickup-helpers.js +1 -0
  680. package/.sinapse-ai/infrastructure/scripts/code-quality-improver.js +1 -1
  681. package/.sinapse-ai/infrastructure/scripts/codebase-mapper.js +1 -0
  682. package/.sinapse-ai/infrastructure/scripts/collect-tool-usage.js +1 -0
  683. package/.sinapse-ai/infrastructure/scripts/commit-message-generator.js +1 -1
  684. package/.sinapse-ai/infrastructure/scripts/component-generator.js +1 -1
  685. package/.sinapse-ai/infrastructure/scripts/component-metadata.js +1 -1
  686. package/.sinapse-ai/infrastructure/scripts/component-search.js +1 -0
  687. package/.sinapse-ai/infrastructure/scripts/config-cache.js +1 -0
  688. package/.sinapse-ai/infrastructure/scripts/config-loader.js +1 -0
  689. package/.sinapse-ai/infrastructure/scripts/conflict-resolver.js +1 -1
  690. package/.sinapse-ai/infrastructure/scripts/coverage-analyzer.js +1 -1
  691. package/.sinapse-ai/infrastructure/scripts/dashboard-status-writer.js +1 -0
  692. package/.sinapse-ai/infrastructure/scripts/dependency-analyzer.js +1 -1
  693. package/.sinapse-ai/infrastructure/scripts/dependency-impact-analyzer.js +1 -1
  694. package/.sinapse-ai/infrastructure/scripts/diff-generator.js +1 -0
  695. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/brownfield-analyzer.js +1 -0
  696. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/config-generator.js +1 -0
  697. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/deployment-config-loader.js +1 -0
  698. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/doc-generator.js +1 -0
  699. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/gitignore-generator.js +1 -0
  700. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/index.js +1 -0
  701. package/.sinapse-ai/infrastructure/scripts/documentation-integrity/mode-detector.js +1 -0
  702. package/.sinapse-ai/infrastructure/scripts/documentation-synchronizer.js +1 -1
  703. package/.sinapse-ai/infrastructure/scripts/framework-analyzer.js +1 -1
  704. package/.sinapse-ai/infrastructure/scripts/generate-optimization-report.js +1 -0
  705. package/.sinapse-ai/infrastructure/scripts/generate-settings-json.js +1 -0
  706. package/.sinapse-ai/infrastructure/scripts/git-config-detector.js +1 -0
  707. package/.sinapse-ai/infrastructure/scripts/git-hooks/post-commit.js +1 -0
  708. package/.sinapse-ai/infrastructure/scripts/git-wrapper.js +1 -0
  709. package/.sinapse-ai/infrastructure/scripts/gotchas-documenter.js +1 -0
  710. package/.sinapse-ai/infrastructure/scripts/ide-sync/README.md +1 -0
  711. package/.sinapse-ai/infrastructure/scripts/ide-sync/agent-parser.js +1 -0
  712. package/.sinapse-ai/infrastructure/scripts/ide-sync/redirect-generator.js +1 -0
  713. package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/claude-code.js +1 -0
  714. package/.sinapse-ai/infrastructure/scripts/ide-sync/validator.js +1 -0
  715. package/.sinapse-ai/infrastructure/scripts/improvement-engine.js +1 -1
  716. package/.sinapse-ai/infrastructure/scripts/improvement-validator.js +1 -1
  717. package/.sinapse-ai/infrastructure/scripts/llm-routing/install-llm-routing.js +1 -0
  718. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh +1 -0
  719. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free.cmd +81 -80
  720. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free.sh +1 -0
  721. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-max.cmd +27 -26
  722. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-max.sh +1 -0
  723. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.sh +1 -0
  724. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.sh +1 -0
  725. package/.sinapse-ai/infrastructure/scripts/llm-routing/usage-tracker/index.js +1 -0
  726. package/.sinapse-ai/infrastructure/scripts/migrate-agent.js +1 -0
  727. package/.sinapse-ai/infrastructure/scripts/modification-risk-assessment.js +1 -1
  728. package/.sinapse-ai/infrastructure/scripts/modification-validator.js +1 -1
  729. package/.sinapse-ai/infrastructure/scripts/output-formatter.js +1 -0
  730. package/.sinapse-ai/infrastructure/scripts/path-analyzer.js +1 -0
  731. package/.sinapse-ai/infrastructure/scripts/pattern-extractor.js +1 -0
  732. package/.sinapse-ai/infrastructure/scripts/performance-analyzer.js +1 -1
  733. package/.sinapse-ai/infrastructure/scripts/performance-and-error-resolver.js +1 -0
  734. package/.sinapse-ai/infrastructure/scripts/performance-optimizer.js +1 -1
  735. package/.sinapse-ai/infrastructure/scripts/performance-tracker.js +1 -0
  736. package/.sinapse-ai/infrastructure/scripts/plan-tracker.js +1 -0
  737. package/.sinapse-ai/infrastructure/scripts/pm-adapter-factory.js +1 -0
  738. package/.sinapse-ai/infrastructure/scripts/pm-adapter.js +1 -0
  739. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +1 -0
  740. package/.sinapse-ai/infrastructure/scripts/project-status-loader.js +1 -0
  741. package/.sinapse-ai/infrastructure/scripts/qa-loop-orchestrator.js +1 -0
  742. package/.sinapse-ai/infrastructure/scripts/qa-report-generator.js +1 -0
  743. package/.sinapse-ai/infrastructure/scripts/recovery-tracker.js +1 -0
  744. package/.sinapse-ai/infrastructure/scripts/refactoring-suggester.js +1 -1
  745. package/.sinapse-ai/infrastructure/scripts/repository-detector.js +1 -0
  746. package/.sinapse-ai/infrastructure/scripts/rollback-manager.js +1 -0
  747. package/.sinapse-ai/infrastructure/scripts/sandbox-tester.js +1 -0
  748. package/.sinapse-ai/infrastructure/scripts/security-checker.js +1 -1
  749. package/.sinapse-ai/infrastructure/scripts/sinapse-validator.js +1 -0
  750. package/.sinapse-ai/infrastructure/scripts/spot-check-validator.js +1 -0
  751. package/.sinapse-ai/infrastructure/scripts/status-mapper.js +1 -0
  752. package/.sinapse-ai/infrastructure/scripts/story-worktree-hooks.js +1 -0
  753. package/.sinapse-ai/infrastructure/scripts/stuck-detector.js +1 -0
  754. package/.sinapse-ai/infrastructure/scripts/subtask-verifier.js +1 -0
  755. package/.sinapse-ai/infrastructure/scripts/template-engine.js +1 -1
  756. package/.sinapse-ai/infrastructure/scripts/template-validator.js +1 -1
  757. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +1 -0
  758. package/.sinapse-ai/infrastructure/scripts/test-generator.js +1 -1
  759. package/.sinapse-ai/infrastructure/scripts/test-quality-assessment.js +1 -1
  760. package/.sinapse-ai/infrastructure/scripts/test-utilities-fast.js +1 -0
  761. package/.sinapse-ai/infrastructure/scripts/test-utilities.js +1 -0
  762. package/.sinapse-ai/infrastructure/scripts/tool-resolver.js +1 -0
  763. package/.sinapse-ai/infrastructure/scripts/transaction-manager.js +1 -1
  764. package/.sinapse-ai/infrastructure/scripts/usage-analytics.js +1 -0
  765. package/.sinapse-ai/infrastructure/scripts/validate-agents.js +1 -0
  766. package/.sinapse-ai/infrastructure/scripts/validate-claude-integration.js +1 -0
  767. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  768. package/.sinapse-ai/infrastructure/scripts/validate-output-pattern.js +1 -0
  769. package/.sinapse-ai/infrastructure/scripts/validate-user-profile.js +1 -0
  770. package/.sinapse-ai/infrastructure/scripts/visual-impact-generator.js +1 -1
  771. package/.sinapse-ai/infrastructure/scripts/worktree-manager.js +1 -0
  772. package/.sinapse-ai/infrastructure/scripts/yaml-validator.js +1 -1
  773. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -279
  774. package/.sinapse-ai/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +1 -0
  775. package/.sinapse-ai/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +1 -0
  776. package/.sinapse-ai/infrastructure/templates/github-workflows/README.md +1 -0
  777. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -169
  778. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -330
  779. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -196
  780. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -18
  781. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -85
  782. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -145
  783. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -63
  784. package/.sinapse-ai/infrastructure/templates/project-docs/coding-standards-tmpl.md +1 -0
  785. package/.sinapse-ai/infrastructure/templates/project-docs/source-tree-tmpl.md +1 -0
  786. package/.sinapse-ai/infrastructure/templates/project-docs/tech-stack-tmpl.md +1 -0
  787. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -182
  788. package/.sinapse-ai/infrastructure/tests/project-status-loader.test.js +1 -0
  789. package/.sinapse-ai/infrastructure/tests/regression-suite-v2.md +1 -0
  790. package/.sinapse-ai/infrastructure/tests/validate-module.js +1 -0
  791. package/.sinapse-ai/infrastructure/tests/worktree-manager.test.js +1 -0
  792. package/.sinapse-ai/infrastructure/tools/README.md +1 -0
  793. package/.sinapse-ai/infrastructure/tools/cli/github-cli.yaml +1 -0
  794. package/.sinapse-ai/infrastructure/tools/cli/llm-routing.yaml +1 -0
  795. package/.sinapse-ai/infrastructure/tools/cli/railway-cli.yaml +1 -0
  796. package/.sinapse-ai/infrastructure/tools/cli/supabase-cli.yaml +1 -0
  797. package/.sinapse-ai/infrastructure/tools/local/ffmpeg.yaml +1 -0
  798. package/.sinapse-ai/infrastructure/tools/mcp/21st-dev-magic.yaml +1 -0
  799. package/.sinapse-ai/infrastructure/tools/mcp/browser.yaml +1 -0
  800. package/.sinapse-ai/infrastructure/tools/mcp/clickup.yaml +1 -0
  801. package/.sinapse-ai/infrastructure/tools/mcp/context7.yaml +1 -0
  802. package/.sinapse-ai/infrastructure/tools/mcp/desktop-commander.yaml +1 -0
  803. package/.sinapse-ai/infrastructure/tools/mcp/exa.yaml +1 -0
  804. package/.sinapse-ai/infrastructure/tools/mcp/google-workspace.yaml +1 -0
  805. package/.sinapse-ai/infrastructure/tools/mcp/n8n.yaml +1 -0
  806. package/.sinapse-ai/infrastructure/tools/mcp/supabase.yaml +1 -0
  807. package/.sinapse-ai/install-manifest.yaml +1933 -1937
  808. package/.sinapse-ai/local-config.yaml.template +65 -71
  809. package/.sinapse-ai/manifests/agents.csv +29 -0
  810. package/.sinapse-ai/manifests/schema/manifest-schema.json +1 -0
  811. package/.sinapse-ai/manifests/tasks.csv +204 -0
  812. package/.sinapse-ai/manifests/workers.csv +196 -0
  813. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -1
  814. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -58
  815. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -47
  816. package/.sinapse-ai/monitor/hooks/notification.py +30 -29
  817. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -45
  818. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -29
  819. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -40
  820. package/.sinapse-ai/monitor/hooks/stop.py +30 -29
  821. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -29
  822. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -38
  823. package/.sinapse-ai/presets/README.md +1 -0
  824. package/.sinapse-ai/product/README.md +1 -0
  825. package/.sinapse-ai/product/checklists/accessibility-wcag-checklist.md +1 -0
  826. package/.sinapse-ai/product/checklists/architect-checklist.md +1 -1
  827. package/.sinapse-ai/product/checklists/change-checklist.md +1 -1
  828. package/.sinapse-ai/product/checklists/component-quality-checklist.md +1 -0
  829. package/.sinapse-ai/product/checklists/database-design-checklist.md +1 -0
  830. package/.sinapse-ai/product/checklists/dba-predeploy-checklist.md +1 -0
  831. package/.sinapse-ai/product/checklists/dba-rollback-checklist.md +1 -0
  832. package/.sinapse-ai/product/checklists/migration-readiness-checklist.md +1 -0
  833. package/.sinapse-ai/product/checklists/pattern-audit-checklist.md +1 -0
  834. package/.sinapse-ai/product/checklists/pm-checklist.md +1 -1
  835. package/.sinapse-ai/product/checklists/po-master-checklist.md +1 -1
  836. package/.sinapse-ai/product/checklists/pre-push-checklist.md +1 -0
  837. package/.sinapse-ai/product/checklists/release-checklist.md +1 -0
  838. package/.sinapse-ai/product/checklists/self-critique-checklist.md +1 -0
  839. package/.sinapse-ai/product/checklists/story-dod-checklist.md +1 -1
  840. package/.sinapse-ai/product/data/atomic-design-principles.md +1 -0
  841. package/.sinapse-ai/product/data/brainstorming-techniques.md +1 -1
  842. package/.sinapse-ai/product/data/consolidation-algorithms.md +1 -0
  843. package/.sinapse-ai/product/data/database-best-practices.md +1 -0
  844. package/.sinapse-ai/product/data/design-token-best-practices.md +1 -0
  845. package/.sinapse-ai/product/data/elicitation-methods.md +1 -1
  846. package/.sinapse-ai/product/data/integration-patterns.md +1 -0
  847. package/.sinapse-ai/product/data/migration-safety-guide.md +1 -0
  848. package/.sinapse-ai/product/data/mode-selection-best-practices.md +1 -0
  849. package/.sinapse-ai/product/data/postgres-tuning-guide.md +1 -0
  850. package/.sinapse-ai/product/data/rls-security-patterns.md +1 -0
  851. package/.sinapse-ai/product/data/roi-calculation-guide.md +1 -0
  852. package/.sinapse-ai/product/data/supabase-patterns.md +1 -0
  853. package/.sinapse-ai/product/data/test-levels-framework.md +1 -1
  854. package/.sinapse-ai/product/data/test-priorities-matrix.md +1 -1
  855. package/.sinapse-ai/product/data/wcag-compliance-guide.md +1 -0
  856. package/.sinapse-ai/product/templates/activation-instructions-inline-greeting.yaml +1 -0
  857. package/.sinapse-ai/product/templates/activation-instructions-template.md +1 -0
  858. package/.sinapse-ai/product/templates/adr.hbs +126 -125
  859. package/.sinapse-ai/product/templates/agent-template.yaml +1 -1
  860. package/.sinapse-ai/product/templates/architecture-tmpl.yaml +1 -1
  861. package/.sinapse-ai/product/templates/brainstorming-output-tmpl.yaml +1 -1
  862. package/.sinapse-ai/product/templates/brownfield-architecture-tmpl.yaml +1 -1
  863. package/.sinapse-ai/product/templates/brownfield-prd-tmpl.yaml +1 -1
  864. package/.sinapse-ai/product/templates/brownfield-risk-report-tmpl.yaml +1 -0
  865. package/.sinapse-ai/product/templates/changelog-template.md +1 -0
  866. package/.sinapse-ai/product/templates/command-rationalization-matrix.md +1 -0
  867. package/.sinapse-ai/product/templates/competitor-analysis-tmpl.yaml +1 -1
  868. package/.sinapse-ai/product/templates/component-react-tmpl.tsx +1 -0
  869. package/.sinapse-ai/product/templates/current-approach-tmpl.md +1 -0
  870. package/.sinapse-ai/product/templates/dbdr.hbs +242 -241
  871. package/.sinapse-ai/product/templates/design-story-tmpl.yaml +1 -0
  872. package/.sinapse-ai/product/templates/ds-artifact-analysis.md +1 -0
  873. package/.sinapse-ai/product/templates/engine/elicitation.js +1 -0
  874. package/.sinapse-ai/product/templates/engine/index.js +1 -0
  875. package/.sinapse-ai/product/templates/engine/loader.js +1 -0
  876. package/.sinapse-ai/product/templates/engine/renderer.js +1 -0
  877. package/.sinapse-ai/product/templates/engine/schemas/adr.schema.json +1 -0
  878. package/.sinapse-ai/product/templates/engine/schemas/dbdr.schema.json +1 -0
  879. package/.sinapse-ai/product/templates/engine/schemas/epic.schema.json +1 -0
  880. package/.sinapse-ai/product/templates/engine/schemas/pmdr.schema.json +1 -0
  881. package/.sinapse-ai/product/templates/engine/schemas/prd-v2.schema.json +1 -0
  882. package/.sinapse-ai/product/templates/engine/schemas/prd.schema.json +1 -0
  883. package/.sinapse-ai/product/templates/engine/schemas/story.schema.json +1 -0
  884. package/.sinapse-ai/product/templates/engine/schemas/task.schema.json +1 -0
  885. package/.sinapse-ai/product/templates/engine/validator.js +1 -0
  886. package/.sinapse-ai/product/templates/epic.hbs +213 -212
  887. package/.sinapse-ai/product/templates/eslintrc-security.json +1 -0
  888. package/.sinapse-ai/product/templates/front-end-architecture-tmpl.yaml +1 -1
  889. package/.sinapse-ai/product/templates/front-end-spec-tmpl.yaml +1 -1
  890. package/.sinapse-ai/product/templates/fullstack-architecture-tmpl.yaml +1 -1
  891. package/.sinapse-ai/product/templates/github-actions-cd.yml +1 -0
  892. package/.sinapse-ai/product/templates/github-actions-ci.yml +1 -0
  893. package/.sinapse-ai/product/templates/github-pr-template.md +1 -0
  894. package/.sinapse-ai/product/templates/gordon-mcp.yaml +1 -0
  895. package/.sinapse-ai/product/templates/index-strategy-tmpl.yaml +1 -0
  896. package/.sinapse-ai/product/templates/market-research-tmpl.yaml +1 -1
  897. package/.sinapse-ai/product/templates/mcp-workflow.js +1 -0
  898. package/.sinapse-ai/product/templates/migration-plan-tmpl.yaml +1 -0
  899. package/.sinapse-ai/product/templates/migration-strategy-tmpl.md +1 -0
  900. package/.sinapse-ai/product/templates/personalized-agent-template.md +1 -0
  901. package/.sinapse-ai/product/templates/personalized-checklist-template.md +1 -0
  902. package/.sinapse-ai/product/templates/personalized-task-template.md +1 -0
  903. package/.sinapse-ai/product/templates/personalized-template-file.yaml +1 -0
  904. package/.sinapse-ai/product/templates/personalized-workflow-template.yaml +1 -0
  905. package/.sinapse-ai/product/templates/pmdr.hbs +187 -186
  906. package/.sinapse-ai/product/templates/prd-tmpl.yaml +1 -1
  907. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -216
  908. package/.sinapse-ai/product/templates/prd.hbs +202 -201
  909. package/.sinapse-ai/product/templates/project-brief-tmpl.yaml +1 -1
  910. package/.sinapse-ai/product/templates/qa-gate-tmpl.yaml +1 -0
  911. package/.sinapse-ai/product/templates/qa-report-tmpl.md +1 -0
  912. package/.sinapse-ai/product/templates/rls-policies-tmpl.yaml +1 -0
  913. package/.sinapse-ai/product/templates/schema-design-tmpl.yaml +1 -0
  914. package/.sinapse-ai/product/templates/shock-report-tmpl.html +1 -0
  915. package/.sinapse-ai/product/templates/spec-tmpl.md +1 -0
  916. package/.sinapse-ai/product/templates/state-persistence-tmpl.yaml +1 -0
  917. package/.sinapse-ai/product/templates/statusline/statusline-script.js +1 -0
  918. package/.sinapse-ai/product/templates/statusline/track-agent.sh +1 -0
  919. package/.sinapse-ai/product/templates/story-tmpl.yaml +1 -1
  920. package/.sinapse-ai/product/templates/story.hbs +264 -263
  921. package/.sinapse-ai/product/templates/task-execution-report.md +1 -0
  922. package/.sinapse-ai/product/templates/task-template.md +1 -1
  923. package/.sinapse-ai/product/templates/task.hbs +171 -170
  924. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -158
  925. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -91
  926. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -104
  927. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -10
  928. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -135
  929. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -77
  930. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -152
  931. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -77
  932. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -140
  933. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -16
  934. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -139
  935. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -140
  936. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -152
  937. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -133
  938. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -177
  939. package/.sinapse-ai/product/templates/token-exports-css-tmpl.css +1 -0
  940. package/.sinapse-ai/product/templates/token-exports-tailwind-tmpl.js +1 -0
  941. package/.sinapse-ai/product/templates/tokens-schema-tmpl.yaml +1 -0
  942. package/.sinapse-ai/product/templates/workflow-template.yaml +1 -1
  943. package/.sinapse-ai/quality/metrics-collector.js +1 -0
  944. package/.sinapse-ai/quality/metrics-hook.js +1 -0
  945. package/.sinapse-ai/quality/schemas/quality-metrics.schema.json +1 -0
  946. package/.sinapse-ai/quality/seed-metrics.js +1 -0
  947. package/.sinapse-ai/schemas/README.md +1 -0
  948. package/.sinapse-ai/schemas/validate-v3-schema.js +1 -0
  949. package/.sinapse-ai/scripts/README.md +1 -0
  950. package/.sinapse-ai/scripts/batch-migrate-phase1.ps1 +37 -36
  951. package/.sinapse-ai/scripts/batch-migrate-phase2.ps1 +89 -88
  952. package/.sinapse-ai/scripts/batch-migrate-phase3.ps1 +46 -45
  953. package/.sinapse-ai/scripts/command-execution-hook.js +1 -0
  954. package/.sinapse-ai/scripts/diagnostics/diagnose-npx-issue.ps1 +97 -96
  955. package/.sinapse-ai/scripts/diagnostics/health-dashboard/README.md +1 -0
  956. package/.sinapse-ai/scripts/diagnostics/health-dashboard/index.html +1 -0
  957. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +1 -0
  958. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package.json +1 -0
  959. package/.sinapse-ai/scripts/diagnostics/health-dashboard/public/favicon.svg +1 -0
  960. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/App.jsx +1 -0
  961. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/AutoFixLog.css +1 -0
  962. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/AutoFixLog.jsx +1 -0
  963. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/DomainCard.css +1 -0
  964. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/DomainCard.jsx +1 -0
  965. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/HealthScore.css +1 -0
  966. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/HealthScore.jsx +1 -0
  967. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/IssuesList.css +1 -0
  968. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/IssuesList.jsx +1 -0
  969. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/TechDebtList.css +1 -0
  970. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/TechDebtList.jsx +1 -0
  971. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/index.js +1 -0
  972. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/Card.css +1 -0
  973. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/Card.jsx +1 -0
  974. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/Chart.css +1 -0
  975. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/Chart.jsx +1 -0
  976. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/Header.css +1 -0
  977. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/Header.jsx +1 -0
  978. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/StatusBadge.css +1 -0
  979. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/StatusBadge.jsx +1 -0
  980. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/components/shared/index.js +1 -0
  981. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/hooks/index.js +1 -0
  982. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/hooks/useAutoRefresh.js +1 -0
  983. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/hooks/useHealthData.js +1 -0
  984. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/main.jsx +1 -0
  985. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/pages/Dashboard.css +1 -0
  986. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/pages/Dashboard.jsx +1 -0
  987. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/pages/DomainDetail.css +1 -0
  988. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/pages/DomainDetail.jsx +1 -0
  989. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/pages/index.js +1 -0
  990. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/styles/App.css +1 -0
  991. package/.sinapse-ai/scripts/diagnostics/health-dashboard/src/styles/index.css +1 -0
  992. package/.sinapse-ai/scripts/diagnostics/health-dashboard/vite.config.js +1 -0
  993. package/.sinapse-ai/scripts/diagnostics/quick-diagnose.cmd +86 -85
  994. package/.sinapse-ai/scripts/diagnostics/quick-diagnose.ps1 +118 -117
  995. package/.sinapse-ai/scripts/migrate-framework-docs.sh +1 -0
  996. package/.sinapse-ai/scripts/pm.sh +1 -0
  997. package/.sinapse-ai/scripts/session-context-loader.js +1 -0
  998. package/.sinapse-ai/scripts/sinapse-doc-template.md +1 -0
  999. package/.sinapse-ai/scripts/test-template-system.js +1 -1
  1000. package/.sinapse-ai/scripts/validate-phase1.ps1 +36 -35
  1001. package/.sinapse-ai/scripts/workflow-management.md +1 -0
  1002. package/.sinapse-ai/utils/filters/constants.js +1 -0
  1003. package/.sinapse-ai/utils/filters/content-filter.js +1 -0
  1004. package/.sinapse-ai/utils/filters/field-filter.js +1 -0
  1005. package/.sinapse-ai/utils/filters/index.js +1 -0
  1006. package/.sinapse-ai/utils/filters/schema-filter.js +1 -0
  1007. package/.sinapse-ai/utils/format-duration.js +1 -0
  1008. package/.sinapse-ai/utils/sinapse-validator.js +1 -0
  1009. package/.sinapse-ai/workflow-intelligence/__tests__/confidence-scorer.test.js +1 -0
  1010. package/.sinapse-ai/workflow-intelligence/__tests__/integration.test.js +1 -0
  1011. package/.sinapse-ai/workflow-intelligence/__tests__/suggestion-engine.test.js +1 -0
  1012. package/.sinapse-ai/workflow-intelligence/__tests__/wave-analyzer.test.js +1 -0
  1013. package/.sinapse-ai/workflow-intelligence/__tests__/workflow-registry.test.js +1 -0
  1014. package/.sinapse-ai/workflow-intelligence/engine/confidence-scorer.js +1 -0
  1015. package/.sinapse-ai/workflow-intelligence/engine/output-formatter.js +1 -0
  1016. package/.sinapse-ai/workflow-intelligence/engine/suggestion-engine.js +1 -0
  1017. package/.sinapse-ai/workflow-intelligence/engine/wave-analyzer.js +1 -0
  1018. package/.sinapse-ai/workflow-intelligence/index.js +1 -0
  1019. package/.sinapse-ai/workflow-intelligence/learning/capture-hook.js +1 -0
  1020. package/.sinapse-ai/workflow-intelligence/learning/gotcha-registry.js +1 -0
  1021. package/.sinapse-ai/workflow-intelligence/learning/index.js +1 -0
  1022. package/.sinapse-ai/workflow-intelligence/learning/pattern-capture.js +1 -0
  1023. package/.sinapse-ai/workflow-intelligence/learning/pattern-store.js +1 -0
  1024. package/.sinapse-ai/workflow-intelligence/learning/pattern-validator.js +1 -0
  1025. package/.sinapse-ai/workflow-intelligence/learning/qa-feedback.js +1 -0
  1026. package/.sinapse-ai/workflow-intelligence/learning/semantic-search.js +1 -0
  1027. package/.sinapse-ai/workflow-intelligence/registry/workflow-registry.js +1 -0
  1028. package/LICENSE +34 -33
  1029. package/README.en.md +192 -229
  1030. package/README.md +118 -308
  1031. package/bin/modules/mcp-installer.js +1 -0
  1032. package/bin/sinapse-graph.js +1 -0
  1033. package/bin/sinapse-ids.js +1 -0
  1034. package/bin/sinapse-minimal.js +1 -0
  1035. package/bin/utils/detect-fsmonitor.js +1 -0
  1036. package/bin/utils/framework-guard.js +1 -0
  1037. package/bin/utils/install-errors.js +1 -0
  1038. package/bin/utils/install-transaction.js +1 -0
  1039. package/bin/utils/pro-detector.js +1 -0
  1040. package/docs/README.md +1 -0
  1041. package/docs/codex-integration-process.md +12 -160
  1042. package/docs/codex-parity-program.md +18 -661
  1043. package/docs/examples/squads/basic-squad/README.md +1 -0
  1044. package/docs/examples/squads/basic-squad/agents/greeter-agent.md +1 -0
  1045. package/docs/examples/squads/basic-squad/tasks/greet-user.md +1 -0
  1046. package/docs/examples/squads/multi-agent-squad/README.md +1 -0
  1047. package/docs/examples/squads/multi-agent-squad/agents/lead-agent.md +1 -0
  1048. package/docs/examples/squads/multi-agent-squad/agents/researcher-agent.md +1 -0
  1049. package/docs/examples/squads/multi-agent-squad/agents/writer-agent.md +1 -0
  1050. package/docs/examples/squads/multi-agent-squad/tasks/research-topic.md +1 -0
  1051. package/docs/examples/squads/multi-agent-squad/tasks/write-report.md +1 -0
  1052. package/docs/examples/squads/squad-with-tools/README.md +1 -0
  1053. package/docs/examples/squads/squad-with-tools/agents/analyzer-agent.md +1 -0
  1054. package/docs/examples/squads/squad-with-tools/tools/text-analyzer.js +1 -0
  1055. package/docs/framework/codex-parity/codex-integration-process.md +171 -0
  1056. package/docs/framework/codex-parity/codex-parity-program.md +670 -0
  1057. package/docs/framework/config-override-guide.md +1 -0
  1058. package/docs/{core-architecture.md → framework/core-architecture.md} +1 -0
  1059. package/docs/framework/entity-layer-classification.md +1 -0
  1060. package/docs/{glossary.md → framework/glossary.md} +1 -0
  1061. package/docs/framework/performance-tips.md +1 -0
  1062. package/docs/{00-shared-activation-pipeline.md → framework/shared-activation-pipeline.md} +1 -0
  1063. package/docs/framework/source-tree.md +1 -0
  1064. package/docs/framework/squad-creation-standards.md +331 -0
  1065. package/docs/{versioning-and-releases.md → framework/versioning-and-releases.md} +1 -0
  1066. package/docs/guides/README.md +1 -0
  1067. package/docs/guides/ade-guide.md +1 -0
  1068. package/docs/guides/agent-reference.md +131 -194
  1069. package/docs/guides/agent-selection-guide.md +1 -0
  1070. package/docs/guides/agents/ANALYST-SYSTEM.md +1 -0
  1071. package/docs/guides/agents/ARCHITECT-SYSTEM.md +1 -0
  1072. package/docs/guides/agents/DATA-ENGINEER-SYSTEM.md +1 -0
  1073. package/docs/guides/agents/DEV-SYSTEM.md +1 -0
  1074. package/docs/guides/agents/DEVOPS-SYSTEM.md +1 -0
  1075. package/docs/guides/agents/PM-SYSTEM.md +1 -0
  1076. package/docs/guides/agents/QA-SYSTEM.md +1 -0
  1077. package/docs/guides/agents/SINAPSE-AGENT-FLOWS.zip +0 -0
  1078. package/docs/guides/agents/SINAPSE-MASTER-SYSTEM.md +1 -0
  1079. package/docs/guides/agents/SM-SYSTEM.md +1 -0
  1080. package/docs/guides/agents/SQUAD-CREATOR-SYSTEM.md +1 -0
  1081. package/docs/guides/agents/UX-DESIGN-EXPERT-SYSTEM.md +1 -0
  1082. package/docs/guides/agents/traces/00-shared-activation-pipeline.md +1 -0
  1083. package/docs/guides/agents/traces/00-shared-activation-pipeline.v1-act8.md +1 -0
  1084. package/docs/guides/agents/traces/README.md +1 -0
  1085. package/docs/guides/agents/traces/analyst-execution-trace.md +1 -0
  1086. package/docs/guides/agents/traces/architect-execution-trace.md +1 -0
  1087. package/docs/guides/agents/traces/data-engineer-execution-trace.md +1 -0
  1088. package/docs/guides/agents/traces/dev-execution-trace.md +1 -0
  1089. package/docs/guides/agents/traces/devops-execution-trace.md +1 -0
  1090. package/docs/guides/agents/traces/execution-traces.zip +0 -0
  1091. package/docs/guides/agents/traces/pm-execution-trace.md +1 -0
  1092. package/docs/guides/agents/traces/po-execution-trace.md +1 -0
  1093. package/docs/guides/agents/traces/qa-execution-trace.md +1 -0
  1094. package/docs/guides/agents/traces/sinapse-orqx-execution-trace.md +1 -0
  1095. package/docs/guides/agents/traces/sm-execution-trace.md +1 -0
  1096. package/docs/guides/agents/traces/squad-creation-execution-trace.md +1 -0
  1097. package/docs/guides/agents/traces/ux-design-expert-execution-trace.md +1 -0
  1098. package/docs/guides/api-reference.md +1 -0
  1099. package/docs/guides/build-recovery-guide.md +1 -0
  1100. package/docs/guides/code-graph-mcp-setup.md +1 -0
  1101. package/docs/guides/coderabbit/README.md +1 -0
  1102. package/docs/guides/config-migration-guide.md +1 -0
  1103. package/docs/guides/contextual-greeting-system-guide.md +1 -0
  1104. package/docs/guides/development-setup.md +1 -0
  1105. package/docs/{docker-mcp-setup.md → guides/docker-mcp-setup.md} +1 -0
  1106. package/docs/guides/ide-integration.md +237 -0
  1107. package/docs/guides/ide-sync-guide.md +1 -0
  1108. package/docs/guides/mcp/desktop-commander.md +1 -0
  1109. package/docs/guides/mcp/docker-gateway-tutorial.md +1 -0
  1110. package/docs/guides/mcp-global-setup.md +1 -0
  1111. package/docs/{meta-agent-commands.md → guides/meta-agent-commands.md} +1 -1
  1112. package/docs/guides/permission-modes.md +1 -0
  1113. package/docs/guides/project-status-feature.md +1 -0
  1114. package/docs/guides/quality-dashboard.md +1 -0
  1115. package/docs/guides/quality-gates.md +1 -0
  1116. package/docs/guides/service-discovery.md +1 -0
  1117. package/docs/guides/squad-examples/README.md +1 -0
  1118. package/docs/guides/squad-examples/data-processor-squad.yaml +1 -0
  1119. package/docs/guides/squad-examples/simple-agent.yaml +1 -0
  1120. package/docs/guides/squad-migration.md +1 -0
  1121. package/docs/guides/testing-guide.md +1 -0
  1122. package/docs/guides/vertical-trails/data-engineer-trail.md +1 -0
  1123. package/docs/guides/vertical-trails/devops-trail.md +1 -0
  1124. package/docs/guides/vertical-trails/squad-creator-trail.md +1 -0
  1125. package/docs/guides/workflows/AUTO-WORKTREE-WORKFLOW.md +1 -0
  1126. package/docs/guides/workflows/BROWNFIELD-DISCOVERY-WORKFLOW.md +1 -0
  1127. package/docs/guides/workflows/BROWNFIELD-FULLSTACK-WORKFLOW.md +1 -0
  1128. package/docs/guides/workflows/BROWNFIELD-SERVICE-WORKFLOW.md +1 -0
  1129. package/docs/guides/workflows/BROWNFIELD-UI-WORKFLOW.md +1 -0
  1130. package/docs/guides/workflows/DESIGN-SYSTEM-BUILD-QUALITY-WORKFLOW.md +1 -0
  1131. package/docs/guides/workflows/GREENFIELD-FULLSTACK-WORKFLOW.md +1 -0
  1132. package/docs/guides/workflows/GREENFIELD-SERVICE-WORKFLOW.md +1 -0
  1133. package/docs/guides/workflows/GREENFIELD-UI-WORKFLOW.md +1 -0
  1134. package/docs/guides/workflows/QA-LOOP-WORKFLOW.md +1 -0
  1135. package/docs/guides/workflows/SINAPSE-COMPLETE-CROSS-REFERENCE-ANALYSIS.md +1 -0
  1136. package/docs/guides/workflows/SINAPSE-WORKFLOWS.zip +0 -0
  1137. package/docs/guides/workflows/SPEC-PIPELINE-WORKFLOW.md +1 -0
  1138. package/docs/guides/workflows/STORY-DEVELOPMENT-CYCLE-WORKFLOW.md +1 -0
  1139. package/docs/guides/workflows/WORKFLOW-TASK-AGENT-ANALYSIS.md +1 -0
  1140. package/docs/guides/workflows/xref-phase3-scripts.md +1 -0
  1141. package/docs/guides/workflows/xref-phase5-core.md +1 -0
  1142. package/docs/ide-integration.md +30 -231
  1143. package/docs/pt/ENVIRONMENT.md +1 -0
  1144. package/docs/pt/README.md +1 -0
  1145. package/docs/pt/agents/archetype-rationale.md +1 -0
  1146. package/docs/pt/agents/persona-definitions.md +1 -0
  1147. package/docs/pt/architecture/ADE-ARCHITECT-HANDOFF.md +1 -0
  1148. package/docs/pt/architecture/ADE-EPIC1-HANDOFF.md +1 -0
  1149. package/docs/pt/architecture/ADE-EPIC2-HANDOFF.md +1 -0
  1150. package/docs/pt/architecture/ADE-EPIC3-HANDOFF.md +1 -0
  1151. package/docs/pt/architecture/ade-architecture.md +1 -0
  1152. package/docs/pt/architecture/adr/adr-hcs-health-check-system.md +1 -0
  1153. package/docs/pt/architecture/adr/adr-isolated-vm-decision.md +1 -0
  1154. package/docs/pt/architecture/agent-config-audit.md +1 -0
  1155. package/docs/pt/architecture/agent-responsibility-matrix.md +1 -0
  1156. package/docs/pt/architecture/agent-tool-integration-guide.md +1 -0
  1157. package/docs/pt/architecture/contribution-workflow-research.md +1 -0
  1158. package/docs/pt/architecture/dashboard-architecture.md +1 -0
  1159. package/docs/pt/architecture/dashboard-realtime.md +1 -0
  1160. package/docs/pt/architecture/hcs-check-specifications.md +1 -0
  1161. package/docs/pt/architecture/hcs-execution-modes.md +1 -0
  1162. package/docs/pt/architecture/hcs-self-healing-spec.md +1 -0
  1163. package/docs/pt/architecture/high-level-architecture.md +1 -0
  1164. package/docs/pt/architecture/introduction.md +1 -0
  1165. package/docs/pt/architecture/mcp-api-keys-management.md +1 -0
  1166. package/docs/pt/architecture/mcp-system-diagrams.md +1 -0
  1167. package/docs/pt/architecture/module-system.md +1 -0
  1168. package/docs/pt/architecture/source-tree.md +1 -0
  1169. package/docs/pt/architecture/squad-improvement-recommended-approach.md +1 -0
  1170. package/docs/pt/architecture/utility-integration-guide.md +1 -0
  1171. package/docs/pt/contributing.md +1 -0
  1172. package/docs/pt/core-architecture.md +1 -0
  1173. package/docs/pt/docker-mcp-setup.md +1 -0
  1174. package/docs/pt/framework/source-tree.md +1 -0
  1175. package/docs/pt/getting-started.md +1 -0
  1176. package/docs/pt/guides/README.md +1 -0
  1177. package/docs/pt/guides/ade-guide.md +1 -0
  1178. package/docs/pt/guides/agent-selection-guide.md +1 -0
  1179. package/docs/pt/guides/api-reference.md +1 -0
  1180. package/docs/pt/guides/build-recovery-guide.md +1 -0
  1181. package/docs/pt/guides/contextual-greeting-system-guide.md +1 -0
  1182. package/docs/pt/guides/development-setup.md +1 -0
  1183. package/docs/pt/guides/ide-sync-guide.md +1 -0
  1184. package/docs/pt/guides/mcp/desktop-commander.md +1 -0
  1185. package/docs/pt/guides/mcp/docker-gateway-tutorial.md +1 -0
  1186. package/docs/pt/guides/mcp-global-setup.md +1 -0
  1187. package/docs/pt/guides/permission-modes.md +1 -0
  1188. package/docs/pt/guides/project-status-feature.md +1 -0
  1189. package/docs/pt/guides/quality-dashboard.md +1 -0
  1190. package/docs/pt/guides/quality-gates.md +1 -0
  1191. package/docs/pt/guides/service-discovery.md +1 -0
  1192. package/docs/pt/guides/squad-examples/README.md +1 -0
  1193. package/docs/pt/guides/squad-migration.md +1 -0
  1194. package/docs/pt/guides/testing-guide.md +1 -0
  1195. package/docs/pt/guides/user-guide.md +1 -0
  1196. package/docs/pt/guides/workflows-guide.md +1 -0
  1197. package/docs/pt/installation/troubleshooting.md +1 -0
  1198. package/docs/pt/installation/v4-quick-start.md +1 -0
  1199. package/docs/pt/meta-agent-commands.md +1 -0
  1200. package/docs/pt/performance-tuning-guide.md +1 -0
  1201. package/docs/pt/platforms/claude-code.md +1 -0
  1202. package/docs/pt/sinapse-nomenclature-specification.md +1 -0
  1203. package/docs/pt/specifications/docs-agent-technical-specification.md +1 -0
  1204. package/docs/pt/troubleshooting.md +1 -0
  1205. package/docs/pt/versioning-and-releases.md +1 -0
  1206. package/docs/sinapse-agent-flows/README.md +1 -0
  1207. package/docs/sinapse-agent-flows/analyst-system.md +1 -0
  1208. package/docs/sinapse-agent-flows/architect-system.md +1 -0
  1209. package/docs/sinapse-agent-flows/data-engineer-system.md +1 -0
  1210. package/docs/sinapse-agent-flows/dev-system.md +1 -0
  1211. package/docs/sinapse-agent-flows/devops-system.md +1 -0
  1212. package/docs/sinapse-agent-flows/pm-system.md +1 -0
  1213. package/docs/sinapse-agent-flows/qa-system.md +1 -0
  1214. package/docs/sinapse-agent-flows/sinapse-orqx-system.md +1 -0
  1215. package/docs/sinapse-agent-flows/sm-system.md +1 -0
  1216. package/docs/sinapse-agent-flows/squad-creator-system.md +1 -0
  1217. package/docs/sinapse-agent-flows/ux-design-expert-system.md +1 -0
  1218. package/docs/sinapse-workflows/README.md +1 -0
  1219. package/docs/sinapse-workflows/auto-worktree-workflow.md +1 -0
  1220. package/docs/sinapse-workflows/brownfield-discovery-workflow.md +1 -0
  1221. package/docs/sinapse-workflows/brownfield-fullstack-workflow.md +1 -0
  1222. package/docs/sinapse-workflows/brownfield-service-workflow.md +1 -0
  1223. package/docs/sinapse-workflows/brownfield-ui-workflow.md +1 -0
  1224. package/docs/sinapse-workflows/design-system-build-quality-workflow.md +1 -0
  1225. package/docs/sinapse-workflows/greenfield-fullstack-workflow.md +1 -0
  1226. package/docs/sinapse-workflows/greenfield-service-workflow.md +1 -0
  1227. package/docs/sinapse-workflows/greenfield-ui-workflow.md +1 -0
  1228. package/docs/sinapse-workflows/qa-loop-workflow.md +1 -0
  1229. package/docs/sinapse-workflows/spec-pipeline-workflow.md +1 -0
  1230. package/docs/sinapse-workflows/story-development-cycle-workflow.md +1 -0
  1231. package/package.json +1 -1
  1232. package/packages/installer/package.json +1 -0
  1233. package/packages/installer/src/__tests__/performance-benchmark.js +1 -0
  1234. package/packages/installer/src/config/templates/env-template.js +1 -0
  1235. package/packages/installer/src/config/validation/config-validator.js +1 -0
  1236. package/packages/installer/src/detection/detect-project-type.js +1 -0
  1237. package/packages/installer/src/installer/dependency-installer.js +1 -0
  1238. package/packages/installer/src/installer/file-hasher.js +1 -0
  1239. package/packages/installer/src/installer/manifest-signature.js +1 -0
  1240. package/packages/installer/src/merger/index.js +1 -0
  1241. package/packages/installer/src/merger/parsers/env-parser.js +1 -0
  1242. package/packages/installer/src/merger/parsers/markdown-section-parser.js +1 -0
  1243. package/packages/installer/src/merger/strategies/base-merger.js +1 -0
  1244. package/packages/installer/src/merger/strategies/env-merger.js +1 -0
  1245. package/packages/installer/src/merger/strategies/index.js +1 -0
  1246. package/packages/installer/src/merger/strategies/markdown-merger.js +1 -0
  1247. package/packages/installer/src/merger/strategies/replace-merger.js +1 -0
  1248. package/packages/installer/src/merger/strategies/yaml-merger.js +1 -0
  1249. package/packages/installer/src/merger/types.js +1 -0
  1250. package/packages/installer/src/updater/index.js +1 -0
  1251. package/packages/installer/src/utils/sinapse-colors.js +1 -0
  1252. package/packages/installer/src/wizard/ide-selector.js +1 -0
  1253. package/packages/installer/src/wizard/validation/index.js +1 -0
  1254. package/packages/installer/src/wizard/validation/validators/config-validator.js +1 -0
  1255. package/packages/installer/src/wizard/validation/validators/dependency-validator.js +1 -0
  1256. package/packages/installer/src/wizard/validation/validators/file-structure-validator.js +1 -0
  1257. package/packages/installer/src/wizard/validation/validators/mcp-health-checker.js +1 -0
  1258. package/packages/installer/src/wizard/validators.js +1 -0
  1259. package/packages/installer/src/wizard/wizard.js +1 -0
  1260. package/packages/installer/tests/integration/environment-configuration.test.js +1 -0
  1261. package/packages/installer/tests/integration/wizard-detection.test.js +1 -0
  1262. package/packages/installer/tests/unit/claude-md-template-v5/claude-md-template-v5.test.js +1 -0
  1263. package/packages/installer/tests/unit/detection/detect-project-type.test.js +1 -0
  1264. package/packages/installer/tests/unit/doctor/doctor-checks.test.js +1 -0
  1265. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +1 -0
  1266. package/packages/installer/tests/unit/generate-settings-json/generate-settings-json.test.js +1 -0
  1267. package/packages/installer/tests/unit/ide-sync-integration/ide-sync-integration.test.js +1 -0
  1268. package/packages/installer/tests/unit/merger/markdown-merger.test.js +1 -0
  1269. package/packages/installer/tests/unit/merger/strategies.test.js +1 -0
  1270. package/packages/installer/tests/unit/merger/yaml-merger.test.js +1 -0
  1271. package/packages/sinapse-install/README.md +1 -0
  1272. package/packages/sinapse-install/src/dep-checker.js +1 -0
  1273. package/packages/sinapse-install/src/edmcp/index.js +1 -0
  1274. package/packages/sinapse-install/src/os-detector.js +1 -0
  1275. package/packages/sinapse-pro-cli/src/recover.js +1 -0
  1276. package/scripts/check-markdown-links.py +353 -352
  1277. package/scripts/code-intel-health-check.js +1 -0
  1278. package/scripts/dashboard-parallel-dev.sh +1 -0
  1279. package/scripts/dashboard-parallel-phase3.sh +1 -0
  1280. package/scripts/dashboard-parallel-phase4.sh +1 -0
  1281. package/scripts/install-monitor-hooks.sh +1 -0
  1282. package/scripts/package-synapse.js +1 -0
  1283. package/scripts/semantic-lint.js +1 -0
  1284. package/scripts/sign-manifest.ps1 +131 -130
  1285. package/scripts/validate-sinapse-ai-deps.js +1 -0
  1286. package/sinapse/knowledge-base/cross-squad-patterns.md +1 -0
  1287. package/sinapse/knowledge-base/routing-catalog.md +1 -0
  1288. package/sinapse/squad.yaml +1 -0
  1289. package/sinapse/tasks/compose-multi-squad-plan.md +1 -0
  1290. package/sinapse/tasks/coordinate-cross-squad.md +1 -0
  1291. package/sinapse/tasks/diagnose-and-route.md +1 -0
  1292. package/sinapse/tasks/onboard-user.md +1 -0
  1293. package/sinapse/tasks/resolve-conflict.md +1 -0
  1294. package/sinapse/tasks/squad-status-report.md +1 -0
  1295. package/sinapse/tasks/strategic-brief.md +1 -0
  1296. package/squads/claude-code-mastery/README.md +1 -0
  1297. package/squads/claude-code-mastery/agents/claude-mastery-chief.md +1 -0
  1298. package/squads/claude-code-mastery/checklists/brownfield-readiness-checklist.md +1 -0
  1299. package/squads/claude-code-mastery/checklists/change-checklist.md +1 -0
  1300. package/squads/claude-code-mastery/checklists/context-rot-checklist.md +1 -0
  1301. package/squads/claude-code-mastery/checklists/integration-audit-checklist.md +1 -0
  1302. package/squads/claude-code-mastery/checklists/pre-push-checklist.md +1 -0
  1303. package/squads/claude-code-mastery/data/ci-cd-patterns.yaml +1 -0
  1304. package/squads/claude-code-mastery/data/claude-code-quick-ref.yaml +1 -0
  1305. package/squads/claude-code-mastery/data/hook-patterns.yaml +1 -0
  1306. package/squads/claude-code-mastery/data/mcp-integration-catalog.yaml +1 -0
  1307. package/squads/claude-code-mastery/data/project-type-signatures.yaml +1 -0
  1308. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  1309. package/squads/claude-code-mastery/scripts/validate-setup.js +1 -0
  1310. package/squads/claude-code-mastery/templates/claude-md-fullstack.md +1 -0
  1311. package/squads/claude-code-mastery/templates/claude-md-library.md +1 -0
  1312. package/squads/claude-code-mastery/templates/claude-md-microservices.md +1 -0
  1313. package/squads/claude-code-mastery/templates/claude-md-mobile.md +1 -0
  1314. package/squads/claude-code-mastery/templates/claude-md-monorepo.md +1 -0
  1315. package/squads/claude-code-mastery/templates/github-actions-claude-ci.yml +1 -0
  1316. package/squads/claude-code-mastery/templates/github-actions-claude-review.yml +1 -0
  1317. package/squads/claude-code-mastery/workflows/wf-audit-complete.yaml +1 -0
  1318. package/squads/claude-code-mastery/workflows/wf-knowledge-update.yaml +1 -0
  1319. package/squads/claude-code-mastery/workflows/wf-project-setup.yaml +1 -0
  1320. package/squads/squad-animations/knowledge-base/unicorn-studio-pipeline.md +197 -0
  1321. package/squads/squad-animations/squad.yaml +7 -2
  1322. package/squads/squad-animations/tasks/create-unicorn-animation.md +61 -0
  1323. package/squads/squad-animations/tasks/identify-website-animation.md +120 -0
  1324. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  1325. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  1326. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  1327. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  1328. package/squads/squad-brand/knowledge-base/brand-experience-bx.md +227 -0
  1329. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  1330. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  1331. package/squads/squad-brand/knowledge-base/brand-rebranding-framework.md +208 -0
  1332. package/squads/squad-brand/knowledge-base/brand-strategy-frameworks-catalog.md +330 -52
  1333. package/squads/squad-brand/knowledge-base/brand-valuation-frameworks.md +92 -13
  1334. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  1335. package/squads/squad-brand/knowledge-base/brazilian-branding-context.md +208 -0
  1336. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  1337. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  1338. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  1339. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  1340. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  1341. package/squads/squad-claude/knowledge-base/claude-code-internals-deep.md +578 -0
  1342. package/squads/squad-claude/knowledge-base/claude-code-tools-reference.md +313 -0
  1343. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  1344. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  1345. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  1346. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  1347. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  1348. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  1349. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  1350. package/squads/squad-cloning/knowledge-base/agent-generation-guide.md +89 -0
  1351. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  1352. package/squads/squad-cloning/knowledge-base/cognitive-dna-framework.md +90 -0
  1353. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  1354. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  1355. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  1356. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  1357. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  1358. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  1359. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  1360. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  1361. package/squads/squad-cloning/knowledge-base/source-classification.md +68 -0
  1362. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  1363. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  1364. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  1365. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  1366. package/squads/squad-commercial/knowledge-base/commercial-analytics-reporting.md +120 -1
  1367. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  1368. package/squads/squad-commercial/knowledge-base/negotiation-frameworks.md +166 -0
  1369. package/squads/squad-commercial/knowledge-base/plg-pls-framework.md +160 -0
  1370. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  1371. package/squads/squad-commercial/knowledge-base/revenue-architecture-models.md +153 -1
  1372. package/squads/squad-commercial/knowledge-base/sales-compensation-brazil.md +210 -0
  1373. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  1374. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  1375. package/squads/squad-commercial/knowledge-base/sales-qualification-methodology.md +97 -4
  1376. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  1377. package/squads/squad-content/knowledge-base/ai-leverage-content-framework.md +104 -0
  1378. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  1379. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  1380. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  1381. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  1382. package/squads/squad-content/knowledge-base/content-governance-principles.md +132 -1
  1383. package/squads/squad-content/knowledge-base/content-measurement-framework.md +99 -3
  1384. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  1385. package/squads/squad-content/knowledge-base/content-repurposing-playbook.md +107 -1
  1386. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  1387. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  1388. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  1389. package/squads/squad-content/knowledge-base/editorial-strategy-frameworks.md +148 -5
  1390. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  1391. package/squads/squad-content/knowledge-base/hook-formulas-library.md +88 -0
  1392. package/squads/squad-content/knowledge-base/narrative-structures-library.md +72 -1
  1393. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  1394. package/squads/squad-content/knowledge-base/seo-content-deep.md +231 -0
  1395. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  1396. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  1397. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  1398. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  1399. package/squads/squad-copy/knowledge-base/copywriting-formulas-encyclopedia.md +164 -80
  1400. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  1401. package/squads/squad-copy/knowledge-base/headline-patterns-library.md +70 -0
  1402. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  1403. package/squads/squad-copy/knowledge-base/legendary-copywriters-frameworks.md +128 -0
  1404. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  1405. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  1406. package/squads/squad-copy/knowledge-base/storytelling-frameworks.md +103 -0
  1407. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  1408. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  1409. package/squads/squad-council/knowledge-base/decision-frameworks-encyclopedia.md +266 -0
  1410. package/squads/squad-council/knowledge-base/financial-strategy-models.md +239 -0
  1411. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  1412. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  1413. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  1414. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  1415. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  1416. package/squads/squad-courses/knowledge-base/adult-learning-principles.md +75 -0
  1417. package/squads/squad-courses/knowledge-base/assessment-design-guide.md +68 -0
  1418. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  1419. package/squads/squad-courses/knowledge-base/course-pricing-models.md +95 -0
  1420. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  1421. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  1422. package/squads/squad-courses/knowledge-base/engagement-retention-patterns.md +93 -0
  1423. package/squads/squad-courses/knowledge-base/instructional-design-frameworks.md +149 -2
  1424. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  1425. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  1426. package/squads/squad-cybersecurity/knowledge-base/authentication-security.md +393 -0
  1427. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  1428. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  1429. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  1430. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  1431. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  1432. package/squads/squad-cybersecurity/knowledge-base/owasp-top-10-reference.md +362 -0
  1433. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  1434. package/squads/squad-cybersecurity/knowledge-base/supply-chain-security.md +311 -0
  1435. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  1436. package/squads/squad-cybersecurity/knowledge-base/zero-trust-architecture.md +225 -0
  1437. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  1438. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  1439. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  1440. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +433 -25
  1441. package/squads/squad-design/knowledge-base/design-to-code-pipeline.md +375 -0
  1442. package/squads/squad-design/knowledge-base/design-token-architecture.md +259 -4
  1443. package/squads/squad-design/knowledge-base/designops-maturity.md +312 -0
  1444. package/squads/squad-design/knowledge-base/famous-design-systems-study.md +291 -0
  1445. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  1446. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  1447. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  1448. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  1449. package/squads/squad-finance/knowledge-base/capital-budgeting.md +229 -0
  1450. package/squads/squad-finance/knowledge-base/cash-flow-management.md +220 -0
  1451. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  1452. package/squads/squad-finance/knowledge-base/corporate-finance-frameworks.md +272 -0
  1453. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  1454. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  1455. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  1456. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  1457. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  1458. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  1459. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  1460. package/squads/squad-finance/knowledge-base/valuation-methods.md +254 -0
  1461. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  1462. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  1463. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  1464. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  1465. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  1466. package/squads/squad-growth/knowledge-base/cro-experimentation-framework.md +93 -2
  1467. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  1468. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  1469. package/squads/squad-growth/knowledge-base/growth-frameworks.md +99 -6
  1470. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  1471. package/squads/squad-growth/knowledge-base/plg-metrics-framework.md +183 -0
  1472. package/squads/squad-growth/knowledge-base/retention-lifecycle-marketing.md +193 -0
  1473. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  1474. package/squads/squad-growth/knowledge-base/seo-technical-reference.md +69 -0
  1475. package/squads/squad-growth/knowledge-base/unit-economics-ltv-cac.md +253 -0
  1476. package/squads/squad-growth/knowledge-base/viral-referral-mechanics.md +159 -0
  1477. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  1478. package/squads/squad-paidmedia/knowledge-base/brazil-market-context.md +284 -0
  1479. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  1480. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  1481. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  1482. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  1483. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  1484. package/squads/squad-paidmedia/knowledge-base/programmatic-attribution-deep.md +311 -0
  1485. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  1486. package/squads/squad-paidmedia/knowledge-base/social-algorithms-playbook.md +361 -0
  1487. package/squads/squad-paidmedia/knowledge-base/tiktok-linkedin-ads-playbook.md +213 -0
  1488. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  1489. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  1490. package/squads/squad-product/knowledge-base/customer-success-integration.md +242 -0
  1491. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  1492. package/squads/squad-product/knowledge-base/experimentation-framework.md +196 -0
  1493. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  1494. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  1495. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  1496. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  1497. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  1498. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  1499. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  1500. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  1501. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  1502. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  1503. package/squads/squad-research/knowledge-base/hybrid-retrieval-patterns.md +144 -0
  1504. package/squads/squad-research/knowledge-base/knowledge-graph-construction.md +122 -0
  1505. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  1506. package/squads/squad-research/knowledge-base/multi-agent-research-methodology.md +144 -0
  1507. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  1508. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  1509. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  1510. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  1511. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  1512. package/squads/squad-storytelling/knowledge-base/blake-snyder-beat-sheet.md +151 -0
  1513. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  1514. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  1515. package/squads/squad-storytelling/knowledge-base/business-storytelling-frameworks.md +209 -0
  1516. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  1517. package/squads/squad-storytelling/knowledge-base/heros-journey-deep.md +174 -0
  1518. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  1519. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  1520. package/squads/squad-storytelling/knowledge-base/pitch-presentation-frameworks.md +222 -0
  1521. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  1522. package/squads/squad-storytelling/knowledge-base/story-circle-dan-harmon.md +171 -0
  1523. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  1524. package/.sinapse-ai/core/health-check/checks/services/gemini-cli.js +0 -239
  1525. package/.sinapse-ai/core/orchestration/gemini-model-selector.js +0 -161
  1526. package/.sinapse-ai/hooks/gemini/after-tool.js +0 -77
  1527. package/.sinapse-ai/hooks/gemini/before-agent.js +0 -79
  1528. package/.sinapse-ai/hooks/gemini/before-tool.js +0 -114
  1529. package/.sinapse-ai/hooks/gemini/rewind-handler.js +0 -68
  1530. package/.sinapse-ai/hooks/gemini/session-end.js +0 -90
  1531. package/.sinapse-ai/hooks/gemini/session-start.js +0 -90
  1532. package/.sinapse-ai/infrastructure/integrations/ai-providers/gemini-provider.js +0 -365
  1533. package/.sinapse-ai/infrastructure/integrations/gemini-extensions/cloudrun-adapter.js +0 -128
  1534. package/.sinapse-ai/infrastructure/integrations/gemini-extensions/index.js +0 -41
  1535. package/.sinapse-ai/infrastructure/integrations/gemini-extensions/policy-sync.js +0 -73
  1536. package/.sinapse-ai/infrastructure/integrations/gemini-extensions/security-adapter.js +0 -159
  1537. package/.sinapse-ai/infrastructure/integrations/gemini-extensions/supabase-adapter.js +0 -88
  1538. package/.sinapse-ai/infrastructure/integrations/gemini-extensions/workspace-adapter.js +0 -99
  1539. package/.sinapse-ai/infrastructure/scripts/ide-sync/gemini-commands.js +0 -205
  1540. package/.sinapse-ai/product/templates/gemini/settings.json +0 -79
  1541. package/.sinapse-ai/product/templates/sinapse-ai-config.yaml +0 -106
  1542. package/docs/changelog.md +0 -184
  1543. package/docs/community.md +0 -227
  1544. package/docs/en/sinapse-agent-flows/README.md +0 -190
  1545. package/docs/en/sinapse-agent-flows/analyst-system.md +0 -26
  1546. package/docs/en/sinapse-agent-flows/architect-system.md +0 -26
  1547. package/docs/en/sinapse-agent-flows/data-engineer-system.md +0 -26
  1548. package/docs/en/sinapse-agent-flows/dev-system.md +0 -26
  1549. package/docs/en/sinapse-agent-flows/devops-system.md +0 -26
  1550. package/docs/en/sinapse-agent-flows/pm-system.md +0 -26
  1551. package/docs/en/sinapse-agent-flows/qa-system.md +0 -26
  1552. package/docs/en/sinapse-agent-flows/sinapse-orqx-system.md +0 -26
  1553. package/docs/en/sinapse-agent-flows/sm-system.md +0 -26
  1554. package/docs/en/sinapse-agent-flows/squad-creator-system.md +0 -26
  1555. package/docs/en/sinapse-agent-flows/ux-design-expert-system.md +0 -26
  1556. package/docs/en/sinapse-workflows/README.md +0 -247
  1557. package/docs/en/sinapse-workflows/auto-worktree-workflow.md +0 -62
  1558. package/docs/en/sinapse-workflows/brownfield-discovery-workflow.md +0 -50
  1559. package/docs/en/sinapse-workflows/brownfield-fullstack-workflow.md +0 -50
  1560. package/docs/en/sinapse-workflows/brownfield-service-workflow.md +0 -51
  1561. package/docs/en/sinapse-workflows/brownfield-ui-workflow.md +0 -51
  1562. package/docs/en/sinapse-workflows/design-system-build-quality-workflow.md +0 -53
  1563. package/docs/en/sinapse-workflows/greenfield-fullstack-workflow.md +0 -45
  1564. package/docs/en/sinapse-workflows/greenfield-service-workflow.md +0 -45
  1565. package/docs/en/sinapse-workflows/greenfield-ui-workflow.md +0 -45
  1566. package/docs/en/sinapse-workflows/qa-loop-workflow.md +0 -50
  1567. package/docs/en/sinapse-workflows/spec-pipeline-workflow.md +0 -48
  1568. package/docs/en/sinapse-workflows/story-development-cycle-workflow.md +0 -50
  1569. package/docs/how-to-contribute-with-pull-requests.md +0 -158
  1570. package/docs/prd-cli-graph-dashboard.md +0 -274
  1571. package/docs/troubleshooting.md +0 -881
  1572. package/packages/gemini-sinapse-extension/README.md +0 -53
  1573. package/packages/gemini-sinapse-extension/commands/lib/agent-launcher.js +0 -138
  1574. package/packages/gemini-sinapse-extension/commands/sinapse-agent.js +0 -7
  1575. package/packages/gemini-sinapse-extension/commands/sinapse-agents.js +0 -49
  1576. package/packages/gemini-sinapse-extension/commands/sinapse-analyst.js +0 -6
  1577. package/packages/gemini-sinapse-extension/commands/sinapse-architect.js +0 -6
  1578. package/packages/gemini-sinapse-extension/commands/sinapse-data-engineer.js +0 -6
  1579. package/packages/gemini-sinapse-extension/commands/sinapse-dev.js +0 -6
  1580. package/packages/gemini-sinapse-extension/commands/sinapse-devops.js +0 -6
  1581. package/packages/gemini-sinapse-extension/commands/sinapse-menu.js +0 -6
  1582. package/packages/gemini-sinapse-extension/commands/sinapse-orqx.js +0 -6
  1583. package/packages/gemini-sinapse-extension/commands/sinapse-pm.js +0 -6
  1584. package/packages/gemini-sinapse-extension/commands/sinapse-po.js +0 -6
  1585. package/packages/gemini-sinapse-extension/commands/sinapse-qa.js +0 -6
  1586. package/packages/gemini-sinapse-extension/commands/sinapse-sm.js +0 -6
  1587. package/packages/gemini-sinapse-extension/commands/sinapse-squad-creator.js +0 -6
  1588. package/packages/gemini-sinapse-extension/commands/sinapse-status.js +0 -66
  1589. package/packages/gemini-sinapse-extension/commands/sinapse-ux-design-expert.js +0 -6
  1590. package/packages/gemini-sinapse-extension/commands/sinapse-validate.js +0 -33
  1591. package/packages/gemini-sinapse-extension/extension.json +0 -147
  1592. package/packages/gemini-sinapse-extension/gemini-extension.json +0 -147
  1593. package/packages/gemini-sinapse-extension/hooks/hooks.json +0 -70
  1594. /package/docs/{architecture-overview.md → framework/architecture-overview.md} +0 -0
  1595. /package/docs/{codex-delegation-parity.md → framework/codex-parity/codex-delegation-parity.md} +0 -0
  1596. /package/docs/{codex-total-parity-orchestration-plan.md → framework/codex-parity/codex-total-parity-orchestration-plan.md} +0 -0
  1597. /package/docs/{codex-workflow-task-parity.md → framework/codex-parity/codex-workflow-task-parity.md} +0 -0
  1598. /package/docs/{collaboration-autonomy-plan.md → framework/collaboration-autonomy-plan.md} +0 -0
  1599. /package/docs/{feature-process.md → framework/feature-process.md} +0 -0
  1600. /package/docs/{guiding-principles.md → framework/guiding-principles.md} +0 -0
  1601. /package/docs/{orqx-plan.md → framework/orqx-plan.md} +0 -0
  1602. /package/docs/{roadmap.md → framework/roadmap.md} +0 -0
  1603. /package/docs/{getting-started.md → guides/getting-started.md} +0 -0
  1604. /package/docs/{git-workflow-guide.md → guides/git-workflow-guide.md} +0 -0
  1605. /package/docs/{squad-commands-reference.md → guides/squad-commands-reference.md} +0 -0
  1606. /package/{CHROME-BRAIN-INSTALL.md → docs/installation/chrome-brain.md} +0 -0
  1607. /package/docs/{npx-install.md → installation/npx-install.md} +0 -0
  1608. /package/docs/{uninstallation.md → installation/uninstallation.md} +0 -0
  1609. /package/docs/{security.md → security/overview.md} +0 -0
  1610. /package/docs/{security-best-practices.md → security/security-best-practices.md} +0 -0
@@ -0,0 +1,1308 @@
1
+ # Paid Traffic Master Reference
2
+
3
+ > **Source:** MS-005 Research (2026-04-07) | **Verified:** @research-orqx via WebSearch
4
+ > **Scope:** Meta, Google, TikTok, LinkedIn, Programmatic, Attribution, Creative, CRO, Budget, Brazil Context
5
+
6
+ ---
7
+
8
+ ## Table of Contents
9
+
10
+ 1. [Ecosystem Fundamentals](#1-ecosystem-fundamentals)
11
+ 2. [Meta Ads](#2-meta-ads)
12
+ 3. [Google Ads](#3-google-ads)
13
+ 4. [TikTok Ads](#4-tiktok-ads)
14
+ 5. [LinkedIn Ads](#5-linkedin-ads)
15
+ 6. [Programmatic and DSPs](#6-programmatic-and-dsps)
16
+ 7. [Attribution and Measurement](#7-attribution-and-measurement)
17
+ 8. [Creative Strategy](#8-creative-strategy)
18
+ 9. [CRO and Landing Pages](#9-cro-and-landing-pages)
19
+ 10. [Audiences and Segmentation](#10-audiences-and-segmentation)
20
+ 11. [Budget and Bidding](#11-budget-and-bidding)
21
+ 12. [Analytics and Reporting](#12-analytics-and-reporting)
22
+ 13. [AI and Automation](#13-ai-and-automation)
23
+ 14. [Brazilian Context](#14-brazilian-context)
24
+ 15. [Checklists](#15-checklists)
25
+
26
+ ---
27
+
28
+ ## 1. Ecosystem Fundamentals
29
+
30
+ ### 1.1 Market Size (2025)
31
+
32
+ | Metric | Value |
33
+ |--------|-------|
34
+ | Global digital ad spend | USD 680-800B (Dentsu: 678.7B; Statista: 798.7B) |
35
+ | Global total ad market | USD 1.14T (WPP GroupM) |
36
+ | Digital share of total | >60% (surpassed all traditional media combined) |
37
+
38
+ ### 1.2 Evolution Eras
39
+
40
+ | Era | Period | Key Innovation |
41
+ |-----|--------|----------------|
42
+ | Banner & Direct Buy | 1994-2002 | CPM buying, DoubleClick ad server |
43
+ | Search & Performance | 2000-2010 | Google AdWords (2000), Quality Score, Facebook Ads (2007) |
44
+ | Programmatic & Data | 2010-2018 | RTB, DSPs, DMPs, Custom/Lookalike Audiences |
45
+ | AI, Privacy & Automation | 2018-present | Smart Bidding, Advantage+, PMax, iOS 14.5 ATT, LGPD |
46
+
47
+ ### 1.3 Auction Mechanics
48
+
49
+ All modern digital advertising operates via auctions. Google migrated to first-price auction in 2019.
50
+
51
+ | Component | Description |
52
+ |-----------|-------------|
53
+ | Bid | Maximum amount advertiser will pay |
54
+ | Quality Score | Ad relevance to user (Google) |
55
+ | Estimated Action Rate | Probability user takes desired action (Meta) |
56
+ | Ad Rank | Final score = Bid x Quality (determines position and cost) |
57
+ | Reserve Price | Minimum to enter the auction |
58
+
59
+ **Key principle:** Money alone does not win. An irrelevant ad with a high bid loses to a relevant ad with a lower bid. Platforms optimize for user experience.
60
+
61
+ ### 1.4 Core Metrics Reference
62
+
63
+ | Metric | Formula | Measures |
64
+ |--------|---------|----------|
65
+ | CPM | (Cost / Impressions) x 1000 | Cost per thousand impressions |
66
+ | CPC | Cost / Clicks | Cost per click |
67
+ | CTR | (Clicks / Impressions) x 100 | Click-through rate |
68
+ | CPA | Cost / Conversions | Cost per acquisition |
69
+ | ROAS | Revenue / Ad Cost | Return on ad spend |
70
+ | CVR | (Conversions / Clicks) x 100 | Conversion rate |
71
+ | CPL | Cost / Leads | Cost per lead |
72
+ | LTV | Avg revenue per customer x Avg lifetime | Customer lifetime value |
73
+ | CAC | Total acquisition cost / New customers | Customer acquisition cost |
74
+ | MER | Total revenue / Total marketing cost | Marketing efficiency ratio |
75
+ | Frequency | Impressions / Reach | Times each person saw the ad |
76
+
77
+ ### 1.5 The Attention Economy
78
+
79
+ - Average attention on a digital ad: **1.7 seconds** (Microsoft/Dentsu, 2023)
80
+ - In social feeds: **0.4 seconds** before scroll
81
+ - Video ads: **3-second rule** -- if not captured, the ad failed
82
+ - Creative is the new targeting: with audience automation, creative quality is the primary differentiator
83
+
84
+ ---
85
+
86
+ ## 2. Meta Ads
87
+
88
+ ### 2.1 Campaign Architecture
89
+
90
+ ```
91
+ Campaign (Objective + Budget)
92
+ --> Ad Set (Audience + Placement + Schedule + Bid)
93
+ --> Ad (Creative + Copy + CTA + URL)
94
+ ```
95
+
96
+ ### 2.2 CBO vs ABO
97
+
98
+ | Aspect | CBO | ABO |
99
+ |--------|-----|-----|
100
+ | Budget control | Meta distributes across ad sets | You define budget per ad set |
101
+ | When to use | Audience testing, scale | Granular control, unequal budgets |
102
+ | Advantage | Algorithm optimizes allocation | Spend predictability |
103
+ | Disadvantage | May concentrate on 1 ad set | May waste on poor ad sets |
104
+ | Best practice | Default for most cases | When audiences have very different sizes |
105
+
106
+ Meta recommends CBO as default since 2019.
107
+
108
+ ### 2.3 Campaign Objectives (ODAX)
109
+
110
+ | Objective | Optimizes For | Typical Use |
111
+ |-----------|--------------|-------------|
112
+ | Awareness | Impressions, reach, brand recall | Branding, launches |
113
+ | Traffic | Link clicks, landing page views | Drive users to site |
114
+ | Engagement | Likes, comments, shares, messages | Social proof, WhatsApp |
115
+ | Leads | Forms, instant forms, conversations | B2B/B2C lead gen |
116
+ | App Promotion | Installs, in-app events | Mobile apps |
117
+ | Sales | Purchase, add to cart, checkout | E-commerce, conversion |
118
+
119
+ **Golden rule:** The algorithm optimizes exactly for what you ask. If you use Traffic objective, Meta finds clickers -- people who click everything but never buy. Want sales? Use Sales objective with Purchase event.
120
+
121
+ ### 2.4 Audiences
122
+
123
+ **Core Audiences:** Demographics, interests, behaviors. Many interests removed post-iOS 14.5.
124
+
125
+ **Custom Audiences:**
126
+
127
+ | Source | Window | Use |
128
+ |--------|--------|-----|
129
+ | Website visitors (Pixel) | 1-180 days | Retargeting |
130
+ | Customer list (email/phone) | N/A | Match rate ~60-70% |
131
+ | App activity | 1-180 days | Mobile retargeting |
132
+ | Video viewers | 3s, 25%, 50%, 75%, 95% | Video funnel |
133
+ | Instagram/Facebook engagers | 1-365 days | Warm audiences |
134
+ | Lead form openers | 1-90 days | Follow-up |
135
+
136
+ **Lookalike Audiences:**
137
+ - Based on Custom Audience seed. Sizes: 1% (most similar) to 10% (broadest)
138
+ - LAL 1% in Brazil = ~2.1 million people
139
+ - Post-iOS 14.5 decline: Meta recommends migrating to Advantage+ Audiences
140
+
141
+ ### 2.5 Advantage+ Suite
142
+
143
+ **Advantage+ Sales Campaigns (renamed Feb 2025, formerly Advantage+ Shopping):**
144
+ - Now supports Sales, App Installs, and Lead Generation (not just e-commerce)
145
+ - Multiple ad sets allowed (previously limited to 1), each with up to 50 ads
146
+ - Added controls: custom audience exclusion, age/gender preferences
147
+ - Many advertisers report 15-30% superior ROAS vs manual campaigns
148
+ - When NOT to use: very niche products, long-cycle B2B, complex services
149
+
150
+ **Advantage+ Audience:**
151
+ - Replaces manual targeting with algorithmic suggestions
152
+ - Value Rules (2025): influence delivery without disabling Advantage+ -- assign more value to specific segments
153
+
154
+ **Andromeda (2025 infrastructure):**
155
+ - New ad retrieval engine replacing the previous system
156
+ - Processes greater creative variety simultaneously
157
+ - May cause temporary CPM volatility during adaptation
158
+
159
+ **Advantage+ Placements:** Default recommended -- let Meta distribute across all placements.
160
+
161
+ **Advantage+ Creative:** Auto-adjustments (crop, brightness, text overlay, music). Test on/off.
162
+
163
+ ### 2.6 Pixel, CAPI, and Tracking Infrastructure
164
+
165
+ **Meta Pixel -- Standard Events:**
166
+
167
+ ```javascript
168
+ fbq('track', 'PageView');
169
+ fbq('track', 'ViewContent', { content_ids: ['SKU123'], value: 99.90, currency: 'BRL' });
170
+ fbq('track', 'AddToCart', { content_ids: ['SKU123'], value: 99.90, currency: 'BRL' });
171
+ fbq('track', 'InitiateCheckout', { value: 99.90, currency: 'BRL' });
172
+ fbq('track', 'Purchase', { content_ids: ['SKU123'], value: 99.90, currency: 'BRL' });
173
+ fbq('track', 'Lead', { content_name: 'Contact form' });
174
+ ```
175
+
176
+ **Conversions API (CAPI):**
177
+ - Server-side tracking, immune to ad blockers and iOS restrictions
178
+ - Deduplication: use identical `event_id` in Pixel and CAPI
179
+ - Implementation: Gateway (Shopify/WooCommerce plug-and-play), manual (API), or partner (Stape)
180
+ - Event Match Quality (EMQ): score 0-10. Target: EMQ > 6.0 for all events
181
+ - Critical parameters: `em` (email hash), `ph` (phone hash), `fn`/`ln` (name), `external_id`, `fbp`, `fbc`
182
+
183
+ **iOS 14.5+ Impact (ATT):**
184
+
185
+ | Area | Impact |
186
+ |------|--------|
187
+ | Attribution | Window reduced from 28d to 7d (click), 1d (view) |
188
+ | Reporting | Aggregated data, delayed up to 72h |
189
+ | Audiences | Smaller custom audiences, less precise LALs |
190
+ | Optimization | Fewer conversion signals for ML |
191
+ | Meta Revenue | ~USD 10B lost (2022 estimate) |
192
+
193
+ **2025 Attribution Changes:**
194
+ - Engaged-View: threshold reduced from 10s to 5s (or 97% of short videos)
195
+ - Incremental Attribution (April 2025): separates conversions truly caused by the ad from organic
196
+ - Recommendation: engaged-view for daily optimization, incremental for budget allocation decisions
197
+
198
+ ### 2.7 Creative Testing Framework
199
+
200
+ **Phase 1: Concept Testing**
201
+ - 3-5 different creative concepts (angles, messages, formats)
202
+ - Budget: BRL 50-100/day per concept | Duration: 3-5 days or 500 impressions per ad
203
+ - Decision metric: CTR, hook rate (3s views / impressions), CPA
204
+
205
+ **Phase 2: Iteration Testing**
206
+ - Take winning concept(s), create 3-5 variations (different hooks, CTAs, colors)
207
+ - Budget: BRL 100-200/day per variation | Duration: 5-7 days
208
+ - Metric: CPA, ROAS
209
+
210
+ **Phase 3: Scaling**
211
+ - Validated creatives enter scale campaigns
212
+ - Monitor fatigue: when frequency > 3 and CTR drops > 20%, refresh
213
+ - Creative refresh cadence: new creatives every 2-4 weeks
214
+ - Keep "evergreen winners" running while they perform
215
+
216
+ ### 2.8 Ad Formats
217
+
218
+ | Format | Specs | Best For |
219
+ |--------|-------|----------|
220
+ | Image (Feed) | 1080x1080 (1:1) or 1080x1350 (4:5) | E-commerce, awareness |
221
+ | Video (Feed) | 1080x1350 (4:5), 15-60s | Storytelling, demo |
222
+ | Reels | 1080x1920 (9:16), 15-90s | Reach, young engagement |
223
+ | Stories | 1080x1920 (9:16), 5-15s | Urgency, flash offers |
224
+ | Carousel | 1080x1080, 2-10 cards | Multi-product, sequential storytelling |
225
+ | Collection | Cover + catalog | Mobile e-commerce |
226
+ | Instant Experience | Full-screen mobile | Immersion, consideration |
227
+ | Dynamic Ads | Template + catalog | E-commerce retargeting |
228
+
229
+ ---
230
+
231
+ ## 3. Google Ads
232
+
233
+ ### 3.1 Search Ads
234
+
235
+ Google Search is the only paid media channel based on **explicit intent**. The user types what they want.
236
+
237
+ **Keyword Match Types:**
238
+
239
+ | Type | Syntax | Triggers For |
240
+ |------|--------|-------------|
241
+ | Broad Match | tenis corrida | Related terms (sapatos esportivos, calcados running) |
242
+ | Phrase Match | "tenis corrida" | Phrases containing the meaning |
243
+ | Exact Match | [tenis corrida] | Terms with same exact meaning |
244
+
245
+ **2025 best practice:** Broad Match + Smart Bidding. The algorithm only shows the ad when it estimates high conversion probability, even for broad terms.
246
+
247
+ **Negative Keywords remain essential:**
248
+ - Create shared negative lists across campaigns
249
+ - Review Search Terms Report weekly
250
+ - Negative informational terms in conversion campaigns
251
+
252
+ ### 3.2 Quality Score and Ad Rank
253
+
254
+ Quality Score (1-10) components:
255
+
256
+ | Factor | Weight | Measures |
257
+ |--------|--------|----------|
258
+ | Expected CTR | ~39% | Click probability based on history |
259
+ | Ad Relevance | ~22% | How relevant the ad is to the keyword |
260
+ | Landing Page Experience | ~39% | Quality, relevance, and speed of page |
261
+
262
+ **Ad Rank = Max CPC x Quality Score x Expected Impact of Extensions**
263
+
264
+ - QS 10 can pay 50% less per click than QS 5
265
+ - Slow landing page (>3s) destroys Quality Score
266
+ - Relevance triangle: keyword --> ad copy --> landing page
267
+
268
+ ### 3.3 Responsive Search Ads (RSAs)
269
+
270
+ Since June 2022, only RSAs are available (Expanded Text Ads discontinued):
271
+ - Up to 15 headlines (30 chars each) + 4 descriptions (90 chars each)
272
+ - Google automatically combines the best combinations
273
+ - Include keyword in headline 1 and 2 (pin if necessary)
274
+ - Vary messages: benefit, urgency, social proof, CTA
275
+ - Target Ad Strength: "Excellent"
276
+
277
+ ### 3.4 Display Network (GDN)
278
+
279
+ Reaches 90%+ of internet users via 2M+ sites, apps, and videos.
280
+
281
+ **Targeting types:** Contextual (keywords/topics), Audience (in-market, affinity, custom), Remarketing, Placement (specific sites), Demographics.
282
+
283
+ **Responsive Display Ads:** Provide images (1200x628 landscape, 1200x1200 square), logos, headlines, descriptions. Google adapts automatically.
284
+
285
+ ### 3.5 YouTube Ads
286
+
287
+ | Format | Details | Best For |
288
+ |--------|---------|----------|
289
+ | Skippable In-Stream (TrueView) | Before/during/after videos, skippable after 5s | Awareness, consideration |
290
+ | Non-Skippable In-Stream | 15-20s, not skippable, CPM | Complete short messages |
291
+ | YouTube Shorts Ads | Vertical 9:16, up to 60s, between organic Shorts | Reach (200B daily views, 2025) |
292
+ | Video Reach Campaigns (VRC) | Auto-combines formats for max reach | Reach optimization |
293
+ | Video Action Campaigns (VAC) | Optimizes for conversions, CTA overlay | Website/app conversions |
294
+
295
+ **Hook in first 5 seconds is critical** -- if not captured, user skips.
296
+
297
+ ### 3.6 Google Shopping
298
+
299
+ **Standard Shopping:** Manual bids per product/group. Use priority (High/Medium/Low) to control which campaign captures which search.
300
+
301
+ **Performance Max (PMax):**
302
+ - Automated campaign across ALL Google channels (Search, Display, YouTube, Shopping, Gmail, Discover, Maps)
303
+ - Provide: asset groups + feed + audience signals
304
+ - Negative keywords available since Jan 2025 (up to 10K per campaign since Mar 2025), applies only to Search/Shopping inventory
305
+ - Channel reporting available since Nov 2025
306
+ - When to use: e-commerce with broad catalog, sufficient conversion data
307
+ - When to avoid: long-cycle B2B, niche products, when granular control is essential
308
+
309
+ ### 3.7 Smart Bidding
310
+
311
+ | Strategy | Optimizes For | When to Use |
312
+ |----------|--------------|-------------|
313
+ | Maximize Clicks | Click volume | Initial phase, data collection |
314
+ | Maximize Conversions | Conversion volume | Fixed budget, max conversions |
315
+ | Target CPA (tCPA) | Specific CPA | When you know acceptable CPA |
316
+ | Maximize Conversion Value | Total conversion value | E-commerce without ROAS target |
317
+ | Target ROAS (tROAS) | Specific ROAS | E-commerce with return target |
318
+
319
+ **Requirements:** Minimum 30 conversions in last 30 days (ideal: 50+). Learning period: 1-2 weeks. Start tCPA/tROAS ~10-20% above current, then tighten gradually.
320
+
321
+ ### 3.8 Extensions (Assets)
322
+
323
+ | Extension | Shows | Avg CTR Impact |
324
+ |-----------|-------|---------------|
325
+ | Sitelink | Additional links to internal pages | +10-20% |
326
+ | Callout | Short benefit texts | +5-10% |
327
+ | Structured Snippet | Category/service lists | +5-10% |
328
+ | Call | Clickable phone number | +5-10% (mobile) |
329
+ | Price | Product/service prices | +10-15% |
330
+ | Promotion | Offers and discounts | +10-20% |
331
+ | Image | Image next to text | +5-15% |
332
+
333
+ **Best practice:** Add ALL relevant extensions. No downside -- Google only shows when estimated to improve performance.
334
+
335
+ ---
336
+
337
+ ## 4. TikTok Ads
338
+
339
+ ### 4.1 Platform Overview
340
+
341
+ - ~1.9 billion MAUs (Q1 2026)
342
+ - 3rd largest ad platform (behind Google and Meta)
343
+ - Projected ad revenue: USD 34.8B (2026)
344
+ - Audience aging rapidly: 25-44 is fastest growing segment
345
+
346
+ **US ownership change (2025):** Banned Jan 19, signed joint venture with Oracle/Silver Lake/MGX on Jan 22. Additional compliance for targeting parameters and audience segments. All AI-generated content (AIGC) must be flagged via in-app toggle. Political ads remain prohibited.
347
+
348
+ ### 4.2 Ad Formats
349
+
350
+ | Format | Details | Best For |
351
+ |--------|---------|----------|
352
+ | In-Feed Ads | For You Page, 9-60s vertical, CTA | Performance (must look native) |
353
+ | Spark Ads | Boost organic posts (own or creator's), keeps engagement | UGC, authenticity (CTR ~25% higher) |
354
+ | TopView | First ad on app open, up to 60s, premium CPM (USD 50-100+) | Launches, massive awareness |
355
+ | Branded Hashtag Challenge | Sponsored challenge on Discover, USD 150K+ | Virality |
356
+ | Catalog Ads (DSA) | Dynamic product ads from feed | E-commerce retargeting |
357
+
358
+ **TikTok's rule: "Don't make ads, make TikToks."**
359
+
360
+ ### 4.3 TikTok Creative Center
361
+
362
+ Free tool at creative-center.tiktok.com:
363
+ - Top Ads Dashboard (by country, industry, objective)
364
+ - Trend Discovery (hashtags, music, creators)
365
+ - Audio Library (licensed music for ads)
366
+ - Creative Templates and AI Script Generator
367
+
368
+ ### 4.4 Targeting
369
+
370
+ | Type | Details |
371
+ |------|---------|
372
+ | Demographics | Age, gender, location, language |
373
+ | Interests | Content categories consumed |
374
+ | Behaviors | Content interactions (likes, shares, follows) |
375
+ | Creator Interactions | Users who interacted with specific creator types |
376
+ | Custom Audiences | Website, customer list, app, engagement |
377
+ | Lookalike | Based on custom audiences, 1-10% |
378
+ | Smart Targeting | Broad targeting optimized by ML (equivalent to Advantage+) |
379
+
380
+ **Best practice:** Start broad and let the algorithm find the audience. The For You Page is already highly personalized.
381
+
382
+ ---
383
+
384
+ ## 5. LinkedIn Ads
385
+
386
+ ### 5.1 The B2B Channel
387
+
388
+ - 1B+ members (2025)
389
+ - CPM 3-5x more expensive than Meta/TikTok
390
+ - CPC average: USD 5-15 (vs USD 0.50-2.00 on Meta)
391
+ - CPL average B2B: USD 50-200+
392
+ - **But:** Lead quality is incomparably superior for B2B
393
+
394
+ ### 5.2 Unique B2B Targeting
395
+
396
+ | Criterion | Details |
397
+ |-----------|---------|
398
+ | Job Title | Exact title (CEO, CFO, Head of Marketing) |
399
+ | Job Function | Functional area (Marketing, Finance, Engineering) |
400
+ | Seniority | Level (Entry, Senior, Manager, Director, VP, C-suite) |
401
+ | Company Name | Specific company (Itau, Nubank, TOTVS) |
402
+ | Company Size | Employee count (1-10 to 10001+) |
403
+ | Industry | Sector (Technology, Finance, Healthcare) |
404
+ | Skills | Listed profile skills |
405
+ | Groups | Specific group members |
406
+ | Company Revenue | Company revenue (some markets) |
407
+
408
+ ### 5.3 Account-Based Marketing (ABM)
409
+
410
+ **Matched Audiences:**
411
+ 1. Company List Upload (up to 300K companies)
412
+ 2. Contact Targeting (email upload, match rate ~30-50%)
413
+ 3. Website Retargeting (Insight Tag)
414
+ 4. Engagement Retargeting
415
+
416
+ **ABM 3-tier strategy:**
417
+
418
+ | Tier | Audience | Objective | Format |
419
+ |------|----------|-----------|--------|
420
+ | 1:1 | Top 10-50 accounts | Awareness + Meeting | Personalized InMail |
421
+ | 1:Few | Clusters of 50-200 | Education + Engagement | Sponsored Content + Thought Leadership |
422
+ | 1:Many | 200-1000+ accounts | Awareness + Demand Gen | Display + Video + Lead Gen Forms |
423
+
424
+ ### 5.4 Ad Formats
425
+
426
+ | Format | Details |
427
+ |--------|---------|
428
+ | Sponsored Content | Feed posts (image, video, carousel, document, event) |
429
+ | Message Ads (InMail) | Direct inbox message, ~50% open rate, 1 per member per 45 days |
430
+ | Conversation Ads | Chatbot-style with multiple response options |
431
+ | Lead Gen Forms | Pre-filled with profile data, CVR 2-5x higher than external LP |
432
+ | Text Ads | Sidebar, very cheap (CPM USD 3-5), low CTR (<0.05%) |
433
+ | Dynamic Ads | Personalized with user photo/name |
434
+
435
+ ### 5.5 Best Practices
436
+
437
+ 1. Minimum audience: 50K+ members for proper optimization
438
+ 2. Ideal frequency: 4-6 impressions per member per month
439
+ 3. Creative refresh: every 4-6 weeks
440
+ 4. Minimum budget: USD 50/day per campaign
441
+ 5. Thought leadership ads: boost executive personal posts -- CTR 2-3x higher than company page
442
+ 6. Document ads: interactive PDFs perform well for educational content
443
+
444
+ ---
445
+
446
+ ## 6. Programmatic and DSPs
447
+
448
+ ### 6.1 RTB (Real-Time Bidding) Flow
449
+
450
+ ```
451
+ 1. User visits a web page
452
+ 2. Publisher sends bid request to ad exchange/SSP
453
+ 3. Ad exchange distributes to connected DSPs
454
+ 4. Each DSP evaluates user (cookies, device ID, context) and decides bid
455
+ 5. DSPs send bid responses with bid amount and creative
456
+ 6. Ad exchange selects winner (highest bid)
457
+ 7. Winner's ad is served to user
458
+ 8. Impression, click, and conversion tracking
459
+ ```
460
+
461
+ Total latency: 50-100ms.
462
+
463
+ ### 6.2 Ecosystem Components
464
+
465
+ | Component | Function | Examples |
466
+ |-----------|----------|----------|
467
+ | DSP | Automated buying for advertisers | DV360, The Trade Desk, Amazon DSP, Xandr |
468
+ | SSP | Automated selling for publishers | Google Ad Manager, Magnite, PubMatic |
469
+ | Ad Exchange | Marketplace for DSP/SSP transactions | Google AdX, OpenX, Xandr |
470
+ | DMP | Data aggregation for targeting (declining) | Oracle BlueKai, Lotame |
471
+ | CDP | First-party data management | Segment, RudderStack, mParticle |
472
+ | Ad Server | Serve, track, optimize creatives | Google CM360, Sizmek |
473
+ | Verification | Viewability, brand safety, fraud | IAS, DoubleVerify, MOAT |
474
+
475
+ ### 6.3 DV360 vs The Trade Desk
476
+
477
+ **DV360 (Google):**
478
+ - Access to Google inventory (YouTube, GDN) + open web
479
+ - Native integration with GA4, CM360, SA360
480
+ - Programmatic Guaranteed and Preferred Deals
481
+
482
+ **The Trade Desk (independent):**
483
+ - Unified ID 2.0 (post-cookie identity solution)
484
+ - Koa AI (proprietary ML optimization)
485
+ - Strong CTV/OTT presence (Netflix, Disney+, Peacock)
486
+ - No conflict of interest (not a publisher)
487
+
488
+ ### 6.4 Transaction Types
489
+
490
+ | Type | Price | Inventory | Use |
491
+ |------|-------|-----------|-----|
492
+ | Open Auction | Variable (auction) | Remnant | Scale and performance |
493
+ | Private Auction | Floor price | Select | Premium with competition |
494
+ | Preferred Deal | Fixed negotiated | Reserved | Publisher relationship |
495
+ | Programmatic Guaranteed | Fixed negotiated | Guaranteed | Premium guaranteed |
496
+
497
+ ### 6.5 Viewability and Brand Safety
498
+
499
+ **Viewability (MRC Standard):**
500
+ - Display: 50% of pixels visible for 1 second
501
+ - Video: 50% of pixels visible for 2 continuous seconds
502
+ - Benchmark: >70% is good
503
+
504
+ **Brand Safety:**
505
+ - Pre-bid filtering (block before bidding) vs post-bid monitoring
506
+ - Inclusion lists (safest) vs exclusion lists (more scale)
507
+ - Tools: IAS, DoubleVerify, Oracle Moat
508
+
509
+ ---
510
+
511
+ ## 7. Attribution and Measurement
512
+
513
+ ### 7.1 The Fundamental Problem
514
+
515
+ 1. Multi-touch journey: average customer interacts with 7-13 touchpoints before converting
516
+ 2. Cross-device: same user sees ads on mobile, desktop, tablet
517
+ 3. Walled gardens: each platform attributes conversions to itself
518
+ 4. Privacy restrictions: iOS 14.5, cookie limitations, GDPR/LGPD
519
+ 5. Offline-to-online: physical store visits influenced by online ads
520
+
521
+ ### 7.2 Attribution Models
522
+
523
+ | Model | Credit Distribution | Best For |
524
+ |-------|--------------------|----------|
525
+ | Last Click | 100% to last click | Simple, but biased to bottom-funnel |
526
+ | First Click | 100% to first touch | Evaluating discovery |
527
+ | Linear | Equal across all touchpoints | Democratic but unrealistic |
528
+ | Time Decay | More to recent touchpoints | Short sales cycles |
529
+ | Position-Based (U-shaped) | 40% first, 40% last, 20% middle | B2B |
530
+ | Data-Driven (DDA) | ML determines real impact | Best available (requires volume) |
531
+
532
+ ### 7.3 Media Mix Modeling (MMM)
533
+
534
+ Econometric (top-down) approach using statistical regression to determine each channel's impact.
535
+
536
+ **How it works:**
537
+ 1. Collect 12-36 months of historical spend and results per channel
538
+ 2. Include control variables: seasonality, price, competition, macro
539
+ 3. Statistical regression to isolate each channel's effect
540
+ 4. Output: response curves per channel
541
+
542
+ **Open-Source MMM tools:**
543
+ - **Meta Robyn** (R): github.com/facebookexperimental/Robyn
544
+ - **Google Meridian** (Python): github.com/google/meridian
545
+ - These democratized MMM -- previously restricted to expensive consultancies (USD 50-200K)
546
+
547
+ **Advantages:** Privacy-safe, captures offline/cross-channel effects, includes external factors.
548
+ **Disadvantages:** Requires 2-3 years of data, limited granularity (weekly/monthly).
549
+
550
+ ### 7.4 Incrementality Testing
551
+
552
+ Measures real causal effect: "Would these conversions have happened without the ad?"
553
+
554
+ **Lift Studies:**
555
+ - Split audience into test (sees ads) and control (does not)
556
+ - Compare conversions between groups. Difference = incremental effect
557
+ - Meta, Google, TikTok offer native lift studies
558
+
559
+ **Geo-Tests:**
560
+ - Choose similar regions as test and control
561
+ - Run campaign only in test regions
562
+ - More robust than audience-based (no data leakage)
563
+
564
+ **Switchback Tests:**
565
+ - Alternate on/off periods across regions
566
+ - Controls for seasonality and temporal trends
567
+
568
+ ### 7.5 Post-Cookie World (2025-2026 Update)
569
+
570
+ **Key reversal:** Google will NOT eliminate third-party cookies in Chrome. Instead, user-choice model (cookies remain enabled by default).
571
+
572
+ **Privacy Sandbox status:**
573
+ - Topics API: limited adoption (~32% of programmatic buyers, early 2025)
574
+ - Protected Audience API (ex-FLEDGE): minimal industry adoption
575
+ - October 2025: Google retired most Sandbox technologies, keeping only CHIPS, FedCM, and Private State Tokens
576
+
577
+ **Practical impact (even without formal deprecation):**
578
+ - First-party data remains the most valuable asset
579
+ - Server-side tracking (CAPI) is essential -- Safari/Firefox already block third-party cookies
580
+ - Walled gardens gain power (logged-in users)
581
+ - Contextual advertising resurges
582
+ - Industry prepared for cookieless world and is not going back
583
+
584
+ ### 7.6 UTM Strategy
585
+
586
+ ```
587
+ https://site.com/landing?
588
+ utm_source=meta&
589
+ utm_medium=paid-social&
590
+ utm_campaign=prospecting-lal1-2025q1&
591
+ utm_content=video-depoimento-30s&
592
+ utm_term=lookalike-1pct-purchasers
593
+ ```
594
+
595
+ | Parameter | Use | Example |
596
+ |-----------|-----|---------|
597
+ | utm_source | Platform | meta, google, tiktok, linkedin |
598
+ | utm_medium | Channel type | paid-social, paid-search, display |
599
+ | utm_campaign | Campaign name | prospecting-lal1-2025q1 |
600
+ | utm_content | Creative variation | video-depoimento-30s |
601
+ | utm_term | Keyword or audience | lookalike-1pct-purchasers |
602
+
603
+ **Rules:** Always lowercase, no spaces (use hyphens), consistent naming, include period/quarter, never use UTMs on internal links.
604
+
605
+ ---
606
+
607
+ ## 8. Creative Strategy
608
+
609
+ ### 8.1 Creative is the New Targeting
610
+
611
+ With automation of audiences and bidding, creative is the most important performance variable. Meta and TikTok confirm high-quality creatives can reduce CPA by 50-70%.
612
+
613
+ - Audience algorithms (Advantage+, Smart Targeting) converge to similar results between advertisers
614
+ - Automated bidding equalizes bids
615
+ - The only differentiator is what the user sees: the creative
616
+ - Platforms prioritize ads that generate engagement
617
+
618
+ ### 8.2 Ad Fatigue Indicators and Refresh Cadence
619
+
620
+ **Indicators:**
621
+ - Frequency > 3-4 (Meta), > 6-7 (LinkedIn)
622
+ - CTR dropping > 20% vs baseline
623
+ - CPA rising > 30% vs baseline
624
+
625
+ | Platform | Refresh Cadence | Reason |
626
+ |----------|----------------|--------|
627
+ | Meta (Prospecting) | 2-3 weeks | Highly dynamic feed |
628
+ | Meta (Retargeting) | 3-4 weeks | Smaller audience, faster fatigue |
629
+ | TikTok | 1-2 weeks | Trend platform, content ages fast |
630
+ | Google Search | 4-8 weeks | Intent-based, less visual |
631
+ | LinkedIn | 4-6 weeks | Less congested feed |
632
+
633
+ ### 8.3 The 3-Second Rule for Video
634
+
635
+ 65% of branding value is delivered in the first 3 seconds (Meta data).
636
+
637
+ **Effective hook types:**
638
+
639
+ | Type | Example | Mechanism |
640
+ |------|---------|-----------|
641
+ | Pattern Interrupt | Abrupt movement, quick cut, unexpected element | Breaks visual expectation |
642
+ | Bold Statement | "You're wasting 50% of your ad budget" | Shock/curiosity |
643
+ | Question | "Did you know 90% of e-commerces make this mistake?" | Cognitive engagement |
644
+ | Social Proof | "100,000 companies already use it" | Instant credibility |
645
+ | Before/After | Visual transformation result | Desire for result |
646
+ | Native/UGC | Person talking to camera like a friend | Authenticity |
647
+ | Controversy | "Google Ads doesn't work. Let me explain why." | Polarization drives clicks |
648
+
649
+ **Hook metrics:**
650
+ - **Hook Rate:** 3s video views / impressions. Benchmark: >30% good, >50% excellent
651
+ - **Hold Rate:** ThruPlays (15s or complete) / 3s views. Benchmark: >25%
652
+
653
+ ### 8.4 UGC (User-Generated Content)
654
+
655
+ Highest performing format in paid social (Meta and TikTok):
656
+ - 92% of consumers trust "real people" recommendations over advertising (Nielsen, 2023)
657
+ - CPA typically 30-50% lower than polished creatives
658
+
659
+ **UGC types for ads:**
660
+ 1. Testimonial: real customer sharing experience
661
+ 2. Unboxing: reaction to receiving product
662
+ 3. Tutorial/How-to: usage demonstration
663
+ 4. Day-in-my-life: product integrated into routine
664
+ 5. Comparison: before/after or vs competitor
665
+ 6. Problem-Agitate-Solution: presents pain, amplifies, shows solution
666
+
667
+ **Where to source UGC:** Trend.io, Billo, JoinBrands, Social Cat, ambassador programs, micro-influencers (1K-10K followers).
668
+
669
+ ### 8.5 Ad Copywriting Frameworks
670
+
671
+ **AIDA (Attention, Interest, Desire, Action):**
672
+ ```
673
+ [A] Stop wasting money on ads that don't convert.
674
+ [I] 73% of Brazilian advertisers spend R$5K+/month without measuring real ROAS.
675
+ [D] With our method, clients reduce CPA by 40% in the first 30 days.
676
+ [A] Schedule your free audit --> link
677
+ ```
678
+
679
+ **PAS (Problem, Agitate, Solution):**
680
+ ```
681
+ [P] Your cost per lead rising every month?
682
+ [A] While you spend more, competitors pay half for the same lead.
683
+ [S] Our platform optimizes your campaigns automatically with AI. Free 14-day trial.
684
+ ```
685
+
686
+ **BAB (Before, After, Bridge):**
687
+ ```
688
+ [B] Before, company X spent R$30K/month on ads with 2x ROAS.
689
+ [A] Today, same budget, ROAS is 6x -- tripled revenue.
690
+ [B] The secret? Data-driven campaign structure + weekly creative testing.
691
+ ```
692
+
693
+ ### 8.6 Creative-Landing Page Congruence
694
+
695
+ **Congruence principle:**
696
+ - Ad headline = landing page headline (or very similar)
697
+ - Ad image = landing page hero image
698
+ - Ad offer = landing page offer (no bait and switch)
699
+ - Ad CTA = landing page CTA
700
+ - Ad tone/voice = landing page tone/voice
701
+
702
+ Higher Message Match Score = higher conversion rate + better Quality Score (Google).
703
+
704
+ ---
705
+
706
+ ## 9. CRO and Landing Pages
707
+
708
+ ### 9.1 CRO Impact on Paid Media
709
+
710
+ ```
711
+ CPA = CPC / CVR
712
+ If CPC = R$2.00 and CVR = 5% --> CPA = R$40
713
+ If CPC = R$2.00 and CVR = 10% --> CPA = R$20
714
+ Doubling CVR = half the CPA
715
+ ```
716
+
717
+ ### 9.2 High-Converting Landing Page Anatomy
718
+
719
+ **Above the Fold:**
720
+
721
+ | Element | Function | Best Practice |
722
+ |---------|----------|---------------|
723
+ | Headline | Capture attention, communicate value | Main benefit in <10 words |
724
+ | Sub-headline | Expand headline | How the product delivers the benefit |
725
+ | Hero image/video | Visualize the result | Product in use or visible result |
726
+ | Primary CTA | Desired action | Contrasting button, action text ("Start free" not "Submit") |
727
+ | Social proof | Immediate credibility | Client logos, user count, rating |
728
+
729
+ **Below the Fold:**
730
+
731
+ | Section | Function |
732
+ |---------|----------|
733
+ | Benefits (3-5) | Expand value proposition with icons |
734
+ | How it works | 3 simple steps to demystify |
735
+ | Testimonials | Real cases with photo, name, title, numeric result |
736
+ | FAQ | Eliminate objections (price, guarantee, timeline, support) |
737
+ | Secondary CTA | Repeat CTA (same button and offer) |
738
+ | Trust badges | Security seals, guarantee, payment methods |
739
+
740
+ ### 9.3 Page Speed Impact
741
+
742
+ | Load Time | Bounce Rate Increase |
743
+ |-----------|---------------------|
744
+ | 1-3 seconds | +32% |
745
+ | 1-5 seconds | +90% |
746
+ | 1-6 seconds | +106% |
747
+ | 1-10 seconds | +123% |
748
+
749
+ **Critical optimizations:**
750
+ - Compress images (WebP instead of PNG/JPEG)
751
+ - Lazy loading for below-fold elements
752
+ - Minimize JavaScript and CSS
753
+ - Use CDN (Cloudflare, Vercel Edge)
754
+ - Core Web Vitals: LCP < 2.5s, FID < 100ms, CLS < 0.1
755
+
756
+ ### 9.4 A/B Testing Priority (by impact)
757
+
758
+ 1. **Offer** -- what you are offering (highest impact)
759
+ 2. **Headline** -- the main promise
760
+ 3. **Hero image/video** -- dominant visual
761
+ 4. **CTA** -- button text and color
762
+ 5. **Social proof** -- type and position
763
+ 6. **Layout** -- element organization
764
+ 7. **Form length** -- number of fields (fewer = more conversions)
765
+ 8. **Pricing** -- presentation of pricing
766
+
767
+ **Valid test requirements:**
768
+ - Calculate sample size before starting
769
+ - Minimum statistical significance: 95% (p-value < 0.05)
770
+ - Run for at least 1-2 weeks (capture weekly variation)
771
+ - Change ONE variable per test
772
+ - Do not end test prematurely based on "trend"
773
+
774
+ ### 9.5 Form Optimization
775
+
776
+ - Fewer fields = more conversions. Each additional field reduces CVR by 5-10%
777
+ - Submit button with action text ("Receive proposal" vs "Submit")
778
+ - Multi-step forms: CVR typically 20-30% higher than single long form
779
+ - Step 1: low friction (email, name)
780
+ - Step 2+: qualification (title, company, budget)
781
+ - Real-time validation, autofill compatible
782
+
783
+ ### 9.6 Landing Page Tools
784
+
785
+ | Tool | Focus | Price (monthly) | Highlight |
786
+ |------|-------|-----------------|-----------|
787
+ | Unbounce | LPs + popups | USD 99-625 | Smart Traffic (AI routing) |
788
+ | Instapage | Enterprise LPs | USD 199+ | Post-click optimization, AdMap |
789
+ | Leadpages | SMB LPs | USD 49-99 | Templates, ease of use |
790
+ | ClickFunnels | Complete funnels | USD 97-297 | Infoproducts focus |
791
+ | Webflow | Design + dev | USD 14-39 | Full customization, native SEO |
792
+ | Carrd | Single-page sites | USD 9-49/year | Ultra simple, fast |
793
+
794
+ ---
795
+
796
+ ## 10. Audiences and Segmentation
797
+
798
+ ### 10.1 First-Party Data Strategy
799
+
800
+ | Source | Data Type | Paid Media Use |
801
+ |--------|-----------|----------------|
802
+ | Website | Pages visited, time, events | Custom Audiences, remarketing |
803
+ | App | In-app behavior, purchases | Custom Audiences, app retargeting |
804
+ | CRM | Email, phone, purchase history | Customer Match, LALs |
805
+ | Email | Opens, clicks, engagement | Engagement segmentation |
806
+ | POS/Checkout | Transactions, products, LTV | High-value LALs |
807
+ | Forms | Leads, declared interest | Nurturing audiences |
808
+ | Chat/Support | Conversations, tickets | Satisfaction segmentation |
809
+
810
+ ### 10.2 CDP Options
811
+
812
+ | CDP | Focus | Price | Highlight |
813
+ |-----|-------|-------|-----------|
814
+ | Segment (Twilio) | Real-time data | USD 120+/mo | Developer-friendly, broad integrations |
815
+ | RudderStack | Open-source first | Free + USD 500+/mo | Self-hosted, warehouse-native |
816
+ | mParticle | Enterprise mobile | Enterprise | Mobile-first |
817
+ | Klaviyo | E-commerce + email | USD 20+/mo | Email + SMS + CDP integrated |
818
+
819
+ ### 10.3 Retargeting by Funnel Stage
820
+
821
+ | Stage | Audience | Message | Format |
822
+ |-------|----------|---------|--------|
823
+ | Top (Awareness) | Video viewers (25%+) | Educational, storytelling | Video ads |
824
+ | Middle (Consideration) | Site visitors (no conversion) | Benefits, social proof, cases | Carousel, testimonials |
825
+ | Bottom (Decision) | Cart abandoners, form starters | Urgency, discount, guarantee | Dynamic product ads |
826
+ | Post-Purchase | Recent buyers | Upsell, cross-sell, review | Product recommendations |
827
+
828
+ **Retargeting windows:**
829
+
830
+ | Window | Use |
831
+ |--------|-----|
832
+ | 1-3 days | Cart abandoners (max urgency) |
833
+ | 7 days | Recent site visitors (high intent) |
834
+ | 14-30 days | Cooler engagers (awareness refresh) |
835
+ | 60-90 days | Re-engagement (special offer) |
836
+ | 180 days | Winback (reactivate inactive) |
837
+
838
+ ### 10.4 Funnel-Based Audience Architecture
839
+
840
+ ```
841
+ TOFU (Cold audiences)
842
+ - LAL 1% of purchasers
843
+ - LAL 1% of high-LTV customers
844
+ - Interest-based audiences
845
+ - Broad targeting (Advantage+)
846
+ - Contextual/keyword targeting
847
+
848
+ MOFU (Warm audiences)
849
+ - Video viewers (25%+)
850
+ - Instagram/Facebook engagers
851
+ - Website visitors (7-30 days, no conversion)
852
+ - Blog readers / lead magnet downloaders
853
+
854
+ BOFU (Hot audiences)
855
+ - Cart abandoners (1-7 days)
856
+ - Product page viewers (1-14 days)
857
+ - Form starters (not completed)
858
+ - Free trial users (not converted)
859
+ - Past purchasers (cross-sell)
860
+ ```
861
+
862
+ ### 10.5 Exclusion Lists
863
+
864
+ | Exclusion List | Why |
865
+ |----------------|-----|
866
+ | Current customers (in prospecting) | Don't spend on who already bought |
867
+ | Recent purchasers (last 7-14 days) | Avoid "buyer's remorse" feeling |
868
+ | Employees and internal team | Don't inflate metrics falsely |
869
+ | Leads already in pipeline (CRM) | Avoid confusion with sales |
870
+ | Users who clicked "hide ad" | Respect preference, protect brand |
871
+ | Bot/click fraud exclusions | Protect budget |
872
+
873
+ ---
874
+
875
+ ## 11. Budget and Bidding
876
+
877
+ ### 11.1 Budget Allocation by Funnel
878
+
879
+ **Growth-stage company (acquisition):**
880
+
881
+ | Funnel | % Budget | Objective |
882
+ |--------|----------|-----------|
883
+ | TOFU | 60-70% | Prospecting, new audiences |
884
+ | MOFU | 15-20% | Nurturing, engagement |
885
+ | BOFU | 10-20% | Retargeting, conversion |
886
+
887
+ **Established company (profitability):**
888
+
889
+ | Funnel | % Budget | Objective |
890
+ |--------|----------|-----------|
891
+ | TOFU | 30-40% | Pipeline renewal |
892
+ | MOFU | 20-30% | Qualification |
893
+ | BOFU | 30-40% | Conversion and retention |
894
+
895
+ ### 11.2 Diminishing Returns
896
+
897
+ ```
898
+ Budget R$5K --> CPA R$30 (first leads are cheap)
899
+ Budget R$10K --> CPA R$35 (still efficient)
900
+ Budget R$20K --> CPA R$45 (starting to saturate)
901
+ Budget R$50K --> CPA R$70 (audience saturated)
902
+ Budget R$100K --> CPA R$120 (severe diminishing returns)
903
+ ```
904
+
905
+ **How to find the optimal point:**
906
+ - Plot CPA vs Budget curve incrementally
907
+ - When marginal CPA > acceptable CPA, redirect to another channel or audience
908
+ - Diversify across platforms before scaling vertically
909
+ - Use MMM to model response curves per channel
910
+
911
+ ### 11.3 Pacing and Dayparting
912
+
913
+ **Pacing:**
914
+ - Standard (distributed): budget spread evenly throughout the day. Recommended for most cases.
915
+ - Accelerated: spends as fast as possible. For flash sales and urgency.
916
+
917
+ **Dayparting:**
918
+ - Analyze conversion data by hour and day of week
919
+ - B2B: focus Mon-Fri 8am-6pm. E-commerce: 24/7 with budget concentrated on peaks
920
+ - Caution: reduces total data volume, may hurt algorithm learning
921
+
922
+ ### 11.4 Geo-Targeting Strategies
923
+
924
+ - **National:** E-commerce with national delivery, SaaS
925
+ - **Regional:** Local services, franchises, physical stores
926
+ - **Radius:** Around specific addresses (store, event, competitor)
927
+ - **Metro/DMA:** Metropolitan areas (SP, RJ, BH, POA)
928
+ - **Bid adjustments by region:** Increase bids in higher-converting regions
929
+ - **Region exclusion:** Unserved areas or high-CPA regions
930
+
931
+ ### 11.5 Portfolio Bidding (Google)
932
+
933
+ Apply a single bid strategy across multiple campaigns:
934
+ - Algorithm optimizes between campaigns (reallocates from high to low CPA)
935
+ - Shared conversion data improves learning
936
+ - Use when campaigns have similar objectives but insufficient individual conversion volume
937
+
938
+ ---
939
+
940
+ ## 12. Analytics and Reporting
941
+
942
+ ### 12.1 Metrics That Matter
943
+
944
+ **Vanity metrics (avoid as primary KPI):** Impressions, Reach, CTR (alone), CPC (alone), Engagement.
945
+
946
+ **Result metrics (real KPIs):**
947
+
948
+ | Metric | Measures | Formula |
949
+ |--------|----------|---------|
950
+ | CPA | Cost per client/lead | Cost / Conversions |
951
+ | ROAS | Return on ad spend | Ad Revenue / Ad Cost |
952
+ | CAC | Total acquisition cost | (Ads + Time + Tools + Agency) / Clients |
953
+ | LTV:CAC | Acquisition sustainability | LTV / CAC. Ideal: >3:1 |
954
+ | MER | Total marketing efficiency | Total Revenue / Total Marketing Cost |
955
+ | Blended CPA | Average CPA across all channels | Total Cost / Total Conversions |
956
+ | Payback Period | Time to recover CAC | CAC / Monthly revenue per client |
957
+ | Contribution Margin | Profit after variable costs | Revenue - COGS - Ads - Shipping - Payment |
958
+
959
+ ### 12.2 MER (Marketing Efficiency Ratio)
960
+
961
+ ```
962
+ MER = Total Business Revenue / Total Marketing Cost
963
+
964
+ Example:
965
+ Monthly revenue: R$500,000
966
+ Total marketing cost: R$100,000
967
+ MER = 5.0x
968
+
969
+ If MER rises when you increase budget --> marketing is working
970
+ If MER falls --> diminishing returns or non-incremental marketing
971
+ ```
972
+
973
+ Advantages: no channel attribution dependency, captures cross-effects, simple, less manipulable.
974
+
975
+ ### 12.3 GA4 Attribution
976
+
977
+ - **Data-Driven Attribution (DDA):** Default. ML determines touchpoint weight. Requires minimum volume.
978
+ - Click-through window: 30 days (default), configurable up to 90 days
979
+ - Engaged view window: 3 days (for video ads)
980
+ - Always compare GA4 attribution with platform data (they always diverge)
981
+
982
+ ### 12.4 Dashboard Tools
983
+
984
+ | Tool | Focus | Price | Highlight |
985
+ |------|-------|-------|-----------|
986
+ | Looker Studio | Free BI | Free | Native Google connectors |
987
+ | Supermetrics | Data pipeline | EUR 39-299/mo | 100+ source connectors |
988
+ | Funnel.io | Marketing data warehouse | EUR 300+/mo | Auto normalization/cleaning |
989
+ | Triple Whale | E-commerce analytics | USD 100-500/mo | Own pixel, attribution, benchmarks |
990
+ | Northbeam | Multi-touch attribution | USD 500+/mo | MMM-lite, incrementality |
991
+ | Hyros | Call tracking attribution | USD 199+/mo | Server-side, call attribution |
992
+
993
+ ### 12.5 Weekly Report Template
994
+
995
+ ```
996
+ 1. Overview: Budget spent vs planned, blended ROAS, blended CPA, MER
997
+ 2. By channel: Meta, Google, TikTok, LinkedIn -- spend, ROAS, CPA, CVR
998
+ 3. Top performers: Top 5 creatives by CPA/ROAS
999
+ 4. Losers: Bottom 5 creatives (pause or iterate)
1000
+ 5. Audiences: Performance by audience/funnel stage
1001
+ 6. Actions: What was done this week + what will be done next
1002
+ 7. Budget: Reallocation proposals based on performance
1003
+ ```
1004
+
1005
+ ---
1006
+
1007
+ ## 13. AI and Automation
1008
+
1009
+ ### 13.1 AI in Paid Media (2025-2026)
1010
+
1011
+ **Content creation:**
1012
+ - Copy: ChatGPT, Claude, Jasper for headlines, ad copy, video scripts
1013
+ - Images: Midjourney, DALL-E 3, Adobe Firefly
1014
+ - Video: Runway, Pika, HeyGen, Synthesia
1015
+ - Audio: ElevenLabs for voiceovers, Suno for jingles
1016
+
1017
+ **Meta Generative Ad Model (GEM) -- 2026 horizon:**
1018
+ - Advertiser provides product URL, budget, and basic prompt
1019
+ - AI generates complete campaign (images, copy, headlines, animations)
1020
+ - Expected end of 2026: AI generates ad, image, video, text with specific budget recommendations
1021
+
1022
+ **Google AI Max for Search (2025-2026):**
1023
+ - New campaign type applying AI automation directly to Search campaigns
1024
+ - Text guidelines beta expanded globally Feb 2026 for AI Max and PMax
1025
+
1026
+ **Limitations:** AI generates volume but not guaranteed quality. "AI slop" is saturating feeds. The differentiator is not using AI, but using AI with unique strategy and brand voice.
1027
+
1028
+ ### 13.2 Automated Bidding Across Platforms
1029
+
1030
+ | Platform | Tool | Function |
1031
+ |----------|------|----------|
1032
+ | Google | Smart Bidding (tCPA, tROAS, Max Conversions) | Real-time bid adjustment per auction |
1033
+ | Meta | Advantage Campaign Budget + Cost Cap/ROAS Cap | Budget distribution and bid adjustment |
1034
+ | TikTok | Smart Performance Campaign | Fully automated campaign |
1035
+ | LinkedIn | Maximum Delivery + Target Cost | Delivery optimization |
1036
+
1037
+ **Trend:** Human role shifts from "bid operator" to "input strategist" (creatives, data, audience signals).
1038
+
1039
+ ### 13.3 DCO (Dynamic Creative Optimization)
1040
+
1041
+ 1. Advertiser provides elements (images, headlines, CTAs, colors)
1042
+ 2. Platform/tool combines elements automatically
1043
+ 3. ML optimizes combinations per user/segment
1044
+ 4. Personalized creative at scale
1045
+
1046
+ **Tools:** Meta Dynamic Creative (native), Google Responsive Ads (native), Celtra, Flashtalking, Innovid, Marpipe.
1047
+
1048
+ ### 13.4 AI Ad Copy Workflow
1049
+
1050
+ 1. **Human brief:** Define angle, tone, audience, offer, constraints
1051
+ 2. **AI generation:** Request 10-20 headline and copy variations
1052
+ 3. **Human curation:** Select best, edit for brand voice
1053
+ 4. **Test:** Run variants as A/B test on platform
1054
+ 5. **Feedback loop:** Feed AI with results to improve future generations
1055
+
1056
+ **Effective prompt template:**
1057
+ ```
1058
+ Create 10 headlines (max 30 characters each) for a Google Search ad.
1059
+ Product: [product]
1060
+ Audience: [persona]
1061
+ Main benefit: [benefit]
1062
+ Differentiator: [differentiator]
1063
+ Tone: [professional/casual/urgent]
1064
+ Include: [mandatory keyword]
1065
+ Avoid: [cliches, unproven superlatives]
1066
+ ```
1067
+
1068
+ ---
1069
+
1070
+ ## 14. Brazilian Context
1071
+
1072
+ ### 14.1 Market Overview
1073
+
1074
+ | Metric | Value |
1075
+ |--------|-------|
1076
+ | Digital ad investment (2025) | ~BRL 42B (IAB Brasil) / ~USD 17.3B |
1077
+ | YoY growth | ~11-18% |
1078
+ | Digital share of total ad spend | ~65% (surpassed TV in 2023) |
1079
+ | Largest platform | Google (~40% share) |
1080
+ | Second largest | Meta (~25% share) |
1081
+ | Fastest growing | TikTok, CTV |
1082
+ | Internet users | ~185M (~87% of population) |
1083
+ | Mobile-first | ~80% of traffic is mobile |
1084
+
1085
+ ### 14.2 CPM Benchmarks Brazil
1086
+
1087
+ | Platform | Avg CPM Brazil (BRL) | Avg CPM USA (USD) |
1088
+ |----------|---------------------|-------------------|
1089
+ | Meta (Feed) | R$15-40 | $10-25 |
1090
+ | Meta (Reels) | R$10-25 | $8-18 |
1091
+ | Google Search | R$5-30 (per click) | $2-15 (per click) |
1092
+ | Google Display | R$3-10 | $2-8 |
1093
+ | YouTube | R$15-35 | $10-30 |
1094
+ | TikTok | R$8-25 | $6-20 |
1095
+ | LinkedIn | R$40-120 | $30-80 |
1096
+
1097
+ ### 14.3 PIX Checkout Impact
1098
+
1099
+ PIX launched November 2020 by the Central Bank, now the most popular payment method in Brazil.
1100
+
1101
+ **Impact on paid media:**
1102
+ - Checkout with PIX has CVR ~15-25% higher than credit card
1103
+ - Processing cost: 0% (vs 2-5% for cards)
1104
+ - Instant confirmation (vs days for boleto/card approval)
1105
+ - "PIX discount" strategy: offer 5-10% discount for PIX payment
1106
+
1107
+ **Best practices for ads with PIX:**
1108
+ - Mention "PIX com desconto" in ad copy
1109
+ - Highlight "pagamento instantaneo" on landing page
1110
+ - A/B test landing pages with PIX vs card as primary option
1111
+ - Retarget cart abandoners mentioning PIX as alternative
1112
+
1113
+ ### 14.4 Tax on Ad Spend (Nota Fiscal)
1114
+
1115
+ **International platforms (Meta, Google, TikTok):**
1116
+ - Charge in BRL via credit card or boleto
1117
+ - Issue invoice, not Brazilian nota fiscal
1118
+ - Advertiser needs fictional exchange operation for accounting
1119
+ - IOF unified at 3.5% on all international credit/debit/prepaid transactions since 2025
1120
+
1121
+ **Brazilian agencies as intermediaries:**
1122
+ - Resell platform inventory, issue Brazilian nota fiscal
1123
+ - Typical markup: 10-20% on investment
1124
+ - Advantage: fiscal simplification. Disadvantage: additional cost
1125
+
1126
+ ### 14.5 WhatsApp Click-to-Message Ads
1127
+
1128
+ WhatsApp is the most used app in Brazil (99% of smartphones).
1129
+
1130
+ **Click-to-WhatsApp Ads:**
1131
+ - Ad in Feed/Stories/Reels with CTA "Send message"
1132
+ - Opens direct conversation on business WhatsApp
1133
+ - Ideal for: local services, real estate, education, health, automotive
1134
+ - CPA typically 40-60% lower than traditional forms in Brazil
1135
+ - Integration with WhatsApp Business API for response automation
1136
+
1137
+ **Best practices:**
1138
+ - Automated welcome message (don't leave user waiting)
1139
+ - Chatbot qualification before passing to human
1140
+ - Track via CAPI (conversation start event)
1141
+ - Segment by business hours (team available to respond)
1142
+
1143
+ ### 14.6 Seasonality Calendar
1144
+
1145
+ | Period | Event | Impact on Ads |
1146
+ |--------|-------|---------------|
1147
+ | January | Holidays, back to school | Low CPMs, low purchase intent |
1148
+ | March | Consumer Day (03/15) | E-commerce peak, CPMs rise |
1149
+ | May | Mother's Day | Largest sales date after Christmas |
1150
+ | June | Valentine's Day BR (06/12), Festas Juninas | Gifts + celebrations |
1151
+ | August | Father's Day | Moderate peak |
1152
+ | September | Semana do Brasil | "Brazilian Black Friday" attempt |
1153
+ | October | Children's Day (10/12) | Toys and children's peak |
1154
+ | November | Black Friday (last Friday) | LARGEST CPM and volume peak |
1155
+ | December | Christmas + New Year | Absolute sales peak |
1156
+
1157
+ **Budget implications:**
1158
+ - Reserve 30-40% of annual budget for Q4 (October-December)
1159
+ - CPMs can rise 50-200% during Black Friday vs annual average
1160
+ - Plan Black Friday creatives 60+ days in advance
1161
+ - Test audiences and creatives in September-October to scale in November
1162
+
1163
+ ### 14.7 Regulation: CONAR and Legislation
1164
+
1165
+ **CONAR** (Conselho Nacional de Autorregulamentacao Publicitaria): self-regulatory body. Not legally binding but widely respected.
1166
+
1167
+ **Rules relevant to digital ads:**
1168
+ - Advertising must be clearly identified (influencer disclosure required)
1169
+ - Deceptive or abusive advertising prohibited
1170
+ - Child-targeted advertising has severe restrictions (CDC + ECA)
1171
+ - Alcoholic beverages: time and age-targeting restrictions
1172
+ - Medications: prescription advertising prohibited, OTC restricted
1173
+ - Financial services: mandatory risk disclaimers
1174
+
1175
+ **Legal framework:**
1176
+ - **CDC** (Consumer Defense Code): basis for deceptive/abusive advertising
1177
+ - **LGPD**: consent for collection and use of personal data in targeting
1178
+ - **Marco Civil da Internet**: neutrality and privacy principles
1179
+ - **CONAR Resolution on influencers**: mandatory disclosure (#publi, #ad)
1180
+
1181
+ ### 14.8 Brazilian Agency Landscape
1182
+
1183
+ **Global holdings:** WPP (GroupM), Publicis Groupe, Dentsu, IPG.
1184
+
1185
+ **Notable Brazilian independent agencies:** Raccoon (S4 Capital), Cadastra, GhFly (Keyrus), V4 Company (franchise model).
1186
+
1187
+ **Compensation models:**
1188
+
1189
+ | Model | How It Works | When to Use |
1190
+ |-------|-------------|-------------|
1191
+ | Fixed fee | Monthly value regardless of results | Predictable scope |
1192
+ | % of investment | 10-20% of media budget | Market standard |
1193
+ | Performance fee | Bonus for results (CPA, ROAS) | Incentive alignment |
1194
+ | Hybrid | Fixed fee + performance | Most balanced |
1195
+
1196
+ ---
1197
+
1198
+ ## 15. Checklists
1199
+
1200
+ ### 15.1 Campaign Launch Checklist
1201
+
1202
+ - [ ] Objective aligned with business goal (not vanity metrics)
1203
+ - [ ] Pixel/CAPI installed and firing correctly (EMQ > 6.0)
1204
+ - [ ] Conversion events configured and tested
1205
+ - [ ] Audiences defined (TOFU/MOFU/BOFU)
1206
+ - [ ] Exclusion lists configured (customers, employees, recent buyers)
1207
+ - [ ] Budget allocated by funnel stage
1208
+ - [ ] Creatives meet platform specs (dimensions, duration, file size)
1209
+ - [ ] Ad copy reviewed (no policy violations, clear CTA)
1210
+ - [ ] Landing page live, fast (<3s load), mobile-optimized
1211
+ - [ ] Landing page matches ad creative (message match)
1212
+ - [ ] UTMs configured and tested
1213
+ - [ ] GA4 goals/events tracking confirmed
1214
+ - [ ] Negative keywords added (Google Search)
1215
+ - [ ] Extensions/assets added (Google)
1216
+ - [ ] A/B test plan documented
1217
+ - [ ] Bid strategy selected with rationale
1218
+ - [ ] Geo-targeting configured correctly
1219
+ - [ ] Schedule/dayparting set (if applicable)
1220
+
1221
+ ### 15.2 Weekly Optimization Checklist
1222
+
1223
+ - [ ] Review Search Terms Report (Google) -- add negatives
1224
+ - [ ] Check frequency by ad/ad set -- pause fatigued creatives (frequency > 3-4)
1225
+ - [ ] Compare CPA/ROAS by audience -- reallocate budget
1226
+ - [ ] Review top and bottom performing creatives
1227
+ - [ ] Check landing page performance (CVR, bounce rate, load time)
1228
+ - [ ] Verify pixel/CAPI event firing and EMQ scores
1229
+ - [ ] Review budget pacing vs plan
1230
+ - [ ] Check for audience overlap between ad sets
1231
+ - [ ] Update exclusion lists with new customers/leads
1232
+ - [ ] Plan next creative batch if refresh is due
1233
+ - [ ] Document insights in weekly report
1234
+
1235
+ ### 15.3 Creative Brief Checklist
1236
+
1237
+ - [ ] Target audience/persona clearly defined
1238
+ - [ ] Main benefit/value proposition stated
1239
+ - [ ] Specific angle/message (not generic)
1240
+ - [ ] Hook strategy defined (first 3 seconds for video)
1241
+ - [ ] CTA specified (what action, what words)
1242
+ - [ ] Platform and format specified (specs included)
1243
+ - [ ] Brand guidelines referenced (logo, colors, fonts, tone)
1244
+ - [ ] Competitor examples reviewed
1245
+ - [ ] Success metrics defined (hook rate, CTR, CPA target)
1246
+ - [ ] Variations planned (2-3 hooks, 2-3 CTAs minimum)
1247
+
1248
+ ### 15.4 CAPI Implementation Checklist
1249
+
1250
+ - [ ] Server-side events sending correctly (test events tool)
1251
+ - [ ] Event deduplication configured (matching event_id in Pixel + CAPI)
1252
+ - [ ] User parameters included: em (email hash), ph (phone hash)
1253
+ - [ ] Additional parameters: fn, ln, external_id, fbp, fbc
1254
+ - [ ] Event Match Quality > 6.0 for all key events
1255
+ - [ ] All standard events covered: PageView, ViewContent, AddToCart, Purchase, Lead
1256
+ - [ ] Custom events configured if needed
1257
+ - [ ] Gateway or API integration documented
1258
+ - [ ] Monitoring/alerting set up for event drops
1259
+
1260
+ ### 15.5 Attribution Readiness Checklist
1261
+
1262
+ - [ ] GA4 properly configured with all conversion events
1263
+ - [ ] UTMs standardized across all campaigns and platforms
1264
+ - [ ] Cross-platform reporting dashboard built (Looker Studio or equivalent)
1265
+ - [ ] MER tracking in place (total revenue / total marketing cost)
1266
+ - [ ] Blended CPA tracked alongside per-channel CPA
1267
+ - [ ] Incrementality test plan documented (at least 1 per quarter)
1268
+ - [ ] First-party data strategy defined (CDP or manual)
1269
+ - [ ] Server-side tracking active (CAPI for Meta, enhanced conversions for Google)
1270
+ - [ ] Attribution model selected with rationale documented
1271
+
1272
+ ---
1273
+
1274
+ ## Key References
1275
+
1276
+ ### Books
1277
+
1278
+ | Book | Author | Key Takeaway |
1279
+ |------|--------|-------------|
1280
+ | Scientific Advertising | Claude Hopkins (1923) | Foundation of response-based advertising |
1281
+ | Breakthrough Advertising | Eugene Schwartz (1966) | 5 levels of consumer awareness for ad copy |
1282
+ | Influence | Robert Cialdini (1984) | 6 persuasion triggers for ads |
1283
+ | Ultimate Guide to Google Ads | Perry Marshall (2020) | Comprehensive Google Ads reference |
1284
+ | $100M Offers | Alex Hormozi (2021) | Creating irresistible offers |
1285
+ | $100M Leads | Alex Hormozi (2023) | Complete lead generation framework |
1286
+ | Cashvertising | Drew Eric Whitman (2008) | 21 psychological ad principles |
1287
+
1288
+ ### Open-Source Tools
1289
+
1290
+ - **Meta Robyn** (R): github.com/facebookexperimental/Robyn -- MMM
1291
+ - **Google Meridian** (Python): github.com/google/meridian -- MMM
1292
+ - **TikTok Creative Center**: creative-center.tiktok.com -- trends and templates
1293
+
1294
+ ### Learning Channels
1295
+
1296
+ | Resource | Format | Focus |
1297
+ |----------|--------|-------|
1298
+ | Google Skillshop | Free certifications | Google Ads official |
1299
+ | Meta Blueprint | Free certifications | Meta Ads official |
1300
+ | Solutions 8 (YouTube) | Video tutorials | Advanced Google Ads |
1301
+ | Ben Heath (YouTube) | Video tutorials | Meta Ads |
1302
+ | Jon Loomer | Blog | Advanced Facebook Ads |
1303
+ | Foxwell Founders | Private community | Facebook/Instagram Ads practitioners |
1304
+ | Search Engine Land | News + analysis | Search marketing |
1305
+
1306
+ ---
1307
+
1308
+ *Source: MS-005 Paid Traffic Master System. Research by @analyst (Scope), verified by @research-orqx (Prism). Last updated: 2026-04-07.*