agileflow 3.4.3 → 4.0.0-alpha.2

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 (762) hide show
  1. package/CHANGELOG.md +238 -473
  2. package/README.md +22 -114
  3. package/bin/agileflow.js +15 -0
  4. package/bin/hooks/pre-bash.js +35 -0
  5. package/bin/hooks/pre-compact.js +34 -0
  6. package/bin/hooks/pre-edit.js +32 -0
  7. package/bin/hooks/pre-write.js +32 -0
  8. package/bin/hooks/session-start.js +42 -0
  9. package/bin/hooks/stop.js +34 -0
  10. package/content/plugins/ads/plugin.yaml +14 -0
  11. package/content/plugins/audit/plugin.yaml +14 -0
  12. package/content/plugins/core/hooks/babysit-mentor-injector.js +55 -0
  13. package/content/plugins/core/hooks/context-loader.js +169 -0
  14. package/content/plugins/core/hooks/damage-control-bash.js +78 -0
  15. package/content/plugins/core/hooks/damage-control-edit.js +76 -0
  16. package/content/plugins/core/hooks/damage-control-patterns.yaml +100 -0
  17. package/content/plugins/core/hooks/damage-control-write.js +72 -0
  18. package/content/plugins/core/hooks/pre-compact-state.js +90 -0
  19. package/content/plugins/core/hooks/session-welcome.js +19 -0
  20. package/content/plugins/core/plugin.yaml +82 -0
  21. package/content/plugins/core/skills/agileflow-adr/SKILL.md +179 -0
  22. package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +144 -0
  23. package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +179 -0
  24. package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +132 -0
  25. package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +200 -0
  26. package/content/plugins/council/plugin.yaml +14 -0
  27. package/content/plugins/seo/plugin.yaml +14 -0
  28. package/package.json +29 -49
  29. package/src/cli/commands/doctor.js +159 -0
  30. package/src/cli/commands/hook.js +80 -0
  31. package/src/cli/commands/setup.js +292 -0
  32. package/src/cli/commands/status.js +47 -0
  33. package/src/cli/commands/update.js +83 -0
  34. package/src/cli/index.js +73 -0
  35. package/src/cli/wizard/behaviors-picker.js +108 -0
  36. package/src/cli/wizard/ide-picker.js +57 -0
  37. package/src/cli/wizard/personalization.js +64 -0
  38. package/src/cli/wizard/plugin-picker.js +106 -0
  39. package/src/lib/hash.js +41 -0
  40. package/src/runtime/config/defaults.js +61 -0
  41. package/src/runtime/config/loader.js +117 -0
  42. package/src/runtime/config/schema.json +99 -0
  43. package/src/runtime/config/writer.js +55 -0
  44. package/src/runtime/hooks/aggregator.js +157 -0
  45. package/src/runtime/hooks/chain.js +93 -0
  46. package/src/runtime/hooks/logger.js +68 -0
  47. package/src/runtime/hooks/manifest-loader.js +228 -0
  48. package/src/runtime/hooks/orchestrator.js +322 -0
  49. package/src/runtime/ide/capabilities.js +111 -0
  50. package/src/runtime/ide/claude-code-settings.js +234 -0
  51. package/src/runtime/ide/claude-code-skills.js +202 -0
  52. package/src/runtime/installer/file-index.js +112 -0
  53. package/src/runtime/installer/install.js +329 -0
  54. package/src/runtime/installer/stash.js +61 -0
  55. package/src/runtime/installer/sync-engine.js +205 -0
  56. package/src/runtime/plugins/registry.js +132 -0
  57. package/src/runtime/plugins/resolver.js +138 -0
  58. package/src/runtime/plugins/validator.js +196 -0
  59. package/src/runtime/skills/validator.js +335 -0
  60. package/lib/README.md +0 -178
  61. package/lib/api-routes.js +0 -625
  62. package/lib/api-server.js +0 -278
  63. package/lib/cache-provider.js +0 -155
  64. package/lib/codebase-indexer.js +0 -819
  65. package/lib/colors.generated.js +0 -117
  66. package/lib/colors.js +0 -341
  67. package/lib/consent.js +0 -232
  68. package/lib/content-sanitizer.js +0 -464
  69. package/lib/correlation.js +0 -277
  70. package/lib/drivers/claude-driver.ts +0 -312
  71. package/lib/drivers/codex-driver.ts +0 -464
  72. package/lib/drivers/driver-manager.ts +0 -159
  73. package/lib/drivers/gemini-driver.ts +0 -498
  74. package/lib/drivers/index.ts +0 -17
  75. package/lib/error-codes.js +0 -590
  76. package/lib/errors.js +0 -670
  77. package/lib/feature-flags.js +0 -171
  78. package/lib/feedback.js +0 -595
  79. package/lib/file-cache.js +0 -541
  80. package/lib/flag-detection.js +0 -344
  81. package/lib/format-error.js +0 -156
  82. package/lib/gate-runner.js +0 -282
  83. package/lib/generator-factory.js +0 -333
  84. package/lib/git-operations.js +0 -266
  85. package/lib/lazy-require.js +0 -59
  86. package/lib/lock-file.js +0 -144
  87. package/lib/logger.js +0 -106
  88. package/lib/merge-operations.js +0 -1006
  89. package/lib/path-resolver.js +0 -544
  90. package/lib/path-utils.js +0 -49
  91. package/lib/paths.js +0 -291
  92. package/lib/placeholder-registry.js +0 -822
  93. package/lib/process-executor.js +0 -214
  94. package/lib/progress.js +0 -334
  95. package/lib/protocol/driver.ts +0 -354
  96. package/lib/protocol/index.ts +0 -12
  97. package/lib/protocol/ir.ts +0 -271
  98. package/lib/registry-cache.js +0 -80
  99. package/lib/registry-di.js +0 -358
  100. package/lib/result-schema.js +0 -363
  101. package/lib/result.js +0 -210
  102. package/lib/session-display.js +0 -331
  103. package/lib/session-operations.js +0 -611
  104. package/lib/session-registry.js +0 -484
  105. package/lib/session-state-machine.js +0 -465
  106. package/lib/session-switching.js +0 -191
  107. package/lib/skill-loader.js +0 -213
  108. package/lib/smart-json-file.js +0 -682
  109. package/lib/state-machine.js +0 -286
  110. package/lib/table-formatter.js +0 -519
  111. package/lib/template-loader.js +0 -143
  112. package/lib/transient-status.js +0 -374
  113. package/lib/ui-manager.js +0 -612
  114. package/lib/validate-args.js +0 -213
  115. package/lib/validate-commands.js +0 -308
  116. package/lib/validate-names.js +0 -143
  117. package/lib/validate-paths.js +0 -434
  118. package/lib/validate.js +0 -134
  119. package/lib/worktree-operations.js +0 -201
  120. package/lib/yaml-utils.js +0 -164
  121. package/scripts/README.md +0 -267
  122. package/scripts/af +0 -34
  123. package/scripts/agent-loop.js +0 -879
  124. package/scripts/agileflow-configure.js +0 -368
  125. package/scripts/agileflow-statusline.sh +0 -857
  126. package/scripts/agileflow-welcome.js +0 -2246
  127. package/scripts/api-server-runner.js +0 -177
  128. package/scripts/archive-completed-stories.sh +0 -308
  129. package/scripts/auto-self-improve.js +0 -326
  130. package/scripts/automation-run-due.js +0 -128
  131. package/scripts/babysit-clear-restore.js +0 -154
  132. package/scripts/babysit-context-restore.js +0 -89
  133. package/scripts/backfill-ideation-status.js +0 -128
  134. package/scripts/batch-pmap-loop.js +0 -551
  135. package/scripts/check-sessions.js +0 -116
  136. package/scripts/check-update.js +0 -282
  137. package/scripts/ci-summary.js +0 -294
  138. package/scripts/claude-smart.sh +0 -85
  139. package/scripts/claude-tmux.sh +0 -737
  140. package/scripts/claude-watchdog.sh +0 -225
  141. package/scripts/clear-active-command.js +0 -48
  142. package/scripts/compress-status.sh +0 -116
  143. package/scripts/context-loader.js +0 -310
  144. package/scripts/damage-control/bash-tool-damage-control.js +0 -22
  145. package/scripts/damage-control/edit-tool-damage-control.js +0 -19
  146. package/scripts/damage-control/patterns.yaml +0 -227
  147. package/scripts/damage-control/write-tool-damage-control.js +0 -19
  148. package/scripts/damage-control-bash.js +0 -51
  149. package/scripts/damage-control-edit.js +0 -48
  150. package/scripts/damage-control-multi-agent.js +0 -231
  151. package/scripts/damage-control-write.js +0 -48
  152. package/scripts/dependency-check.js +0 -311
  153. package/scripts/document-repl.js +0 -793
  154. package/scripts/expertise-metrics.sh +0 -264
  155. package/scripts/generate-all.sh +0 -77
  156. package/scripts/generate-colors.js +0 -314
  157. package/scripts/generators/agent-registry.js +0 -183
  158. package/scripts/generators/command-registry.js +0 -166
  159. package/scripts/generators/index.js +0 -85
  160. package/scripts/generators/inject-babysit.js +0 -191
  161. package/scripts/generators/inject-help.js +0 -125
  162. package/scripts/generators/inject-readme.js +0 -166
  163. package/scripts/generators/skill-registry.js +0 -188
  164. package/scripts/get-env.js +0 -225
  165. package/scripts/init.sh +0 -76
  166. package/scripts/lib/README-portable-tasks.md +0 -424
  167. package/scripts/lib/ac-test-matcher.js +0 -452
  168. package/scripts/lib/audit-cleanup.js +0 -250
  169. package/scripts/lib/audit-registry.js +0 -340
  170. package/scripts/lib/automation-registry.js +0 -544
  171. package/scripts/lib/automation-runner.js +0 -476
  172. package/scripts/lib/browser-qa-evidence.js +0 -409
  173. package/scripts/lib/browser-qa-status.js +0 -192
  174. package/scripts/lib/bus-utils.js +0 -473
  175. package/scripts/lib/colors.generated.sh +0 -82
  176. package/scripts/lib/colors.sh +0 -46
  177. package/scripts/lib/command-prereqs.js +0 -280
  178. package/scripts/lib/concurrency-limiter.js +0 -511
  179. package/scripts/lib/configure-detect.js +0 -596
  180. package/scripts/lib/configure-features.js +0 -1927
  181. package/scripts/lib/configure-repair.js +0 -327
  182. package/scripts/lib/configure-utils.js +0 -114
  183. package/scripts/lib/context-formatter.js +0 -1158
  184. package/scripts/lib/context-loader.js +0 -840
  185. package/scripts/lib/counter.js +0 -103
  186. package/scripts/lib/damage-control-utils.js +0 -619
  187. package/scripts/lib/feature-catalog.js +0 -332
  188. package/scripts/lib/file-lock.js +0 -392
  189. package/scripts/lib/file-tracking.js +0 -735
  190. package/scripts/lib/frontmatter-parser.js +0 -133
  191. package/scripts/lib/gate-enforcer.js +0 -295
  192. package/scripts/lib/hook-metrics.js +0 -324
  193. package/scripts/lib/ideation-index.js +0 -1205
  194. package/scripts/lib/json-utils.sh +0 -162
  195. package/scripts/lib/lifecycle-detector.js +0 -125
  196. package/scripts/lib/model-profiles.js +0 -118
  197. package/scripts/lib/portable-tasks-cli.js +0 -274
  198. package/scripts/lib/portable-tasks.js +0 -479
  199. package/scripts/lib/process-cleanup.js +0 -527
  200. package/scripts/lib/quality-gates.js +0 -788
  201. package/scripts/lib/scale-detector.js +0 -396
  202. package/scripts/lib/sessionRegistry.js +0 -678
  203. package/scripts/lib/signal-detectors.js +0 -867
  204. package/scripts/lib/skill-catalog.js +0 -557
  205. package/scripts/lib/skill-recommender.js +0 -311
  206. package/scripts/lib/state-migrator.js +0 -353
  207. package/scripts/lib/status-task-bridge.js +0 -522
  208. package/scripts/lib/status-writer.js +0 -255
  209. package/scripts/lib/story-claiming.js +0 -704
  210. package/scripts/lib/story-state-machine.js +0 -437
  211. package/scripts/lib/sync-ideation-status.js +0 -291
  212. package/scripts/lib/task-registry-cache.js +0 -490
  213. package/scripts/lib/task-registry.js +0 -1191
  214. package/scripts/lib/task-sync.js +0 -230
  215. package/scripts/lib/tdd-phase-manager.js +0 -455
  216. package/scripts/lib/team-events.js +0 -510
  217. package/scripts/lib/tmux-audit-monitor.js +0 -612
  218. package/scripts/lib/tmux-group-colors.js +0 -113
  219. package/scripts/lib/tool-registry.yaml +0 -241
  220. package/scripts/lib/tool-shed.js +0 -441
  221. package/scripts/lib/validation-registry.js +0 -177
  222. package/scripts/messaging-bridge.js +0 -561
  223. package/scripts/migrate-ideation-index.js +0 -553
  224. package/scripts/native-team-observer.js +0 -219
  225. package/scripts/obtain-context.js +0 -272
  226. package/scripts/pre-push-check.sh +0 -46
  227. package/scripts/precompact-context.sh +0 -306
  228. package/scripts/query-codebase.js +0 -543
  229. package/scripts/ralph-loop.js +0 -1278
  230. package/scripts/resume-session.sh +0 -121
  231. package/scripts/screenshot-verifier.js +0 -215
  232. package/scripts/session-boundary.js +0 -138
  233. package/scripts/session-coordinator.sh +0 -232
  234. package/scripts/session-manager.js +0 -546
  235. package/scripts/smart-detect.js +0 -449
  236. package/scripts/spawn-audit-sessions.js +0 -877
  237. package/scripts/spawn-parallel.js +0 -751
  238. package/scripts/strip-ai-attribution.js +0 -63
  239. package/scripts/task-completed-gate.js +0 -237
  240. package/scripts/team-manager.js +0 -596
  241. package/scripts/team-status-display.js +0 -200
  242. package/scripts/teammate-idle-gate.js +0 -237
  243. package/scripts/test-session-boundary.js +0 -80
  244. package/scripts/tmux-close-windows.sh +0 -180
  245. package/scripts/tmux-restore-window.sh +0 -67
  246. package/scripts/tmux-save-closed-window.sh +0 -35
  247. package/scripts/tui/App.js +0 -151
  248. package/scripts/tui/Dashboard.js +0 -277
  249. package/scripts/tui/blessed/data/watcher.js +0 -180
  250. package/scripts/tui/blessed/index.js +0 -244
  251. package/scripts/tui/blessed/panels/output.js +0 -101
  252. package/scripts/tui/blessed/panels/sessions.js +0 -150
  253. package/scripts/tui/blessed/panels/trace.js +0 -97
  254. package/scripts/tui/blessed/ui/help.js +0 -77
  255. package/scripts/tui/blessed/ui/screen.js +0 -52
  256. package/scripts/tui/blessed/ui/statusbar.js +0 -47
  257. package/scripts/tui/blessed/ui/tabbar.js +0 -99
  258. package/scripts/tui/index.js +0 -70
  259. package/scripts/tui/lib/crashRecovery.js +0 -304
  260. package/scripts/tui/lib/eventStream.js +0 -309
  261. package/scripts/tui/lib/keyboard.js +0 -261
  262. package/scripts/tui/lib/loopControl.js +0 -371
  263. package/scripts/tui/panels/OutputPanel.js +0 -240
  264. package/scripts/tui/panels/SessionPanel.js +0 -170
  265. package/scripts/tui/panels/TracePanel.js +0 -298
  266. package/scripts/tui/simple-tui.js +0 -510
  267. package/scripts/validate-expertise.sh +0 -263
  268. package/scripts/validate-tokens.sh +0 -73
  269. package/scripts/validators/README.md +0 -143
  270. package/scripts/validators/component-validator.js +0 -239
  271. package/scripts/validators/json-schema-validator.js +0 -186
  272. package/scripts/validators/markdown-validator.js +0 -152
  273. package/scripts/validators/migration-validator.js +0 -129
  274. package/scripts/validators/security-validator.js +0 -380
  275. package/scripts/validators/story-format-validator.js +0 -197
  276. package/scripts/validators/test-result-validator.js +0 -114
  277. package/scripts/validators/workflow-validator.js +0 -247
  278. package/scripts/welcome-deferred.js +0 -437
  279. package/scripts/worktree-create.sh +0 -111
  280. package/src/core/agents/a11y-analyzer-aria.md +0 -155
  281. package/src/core/agents/a11y-analyzer-forms.md +0 -162
  282. package/src/core/agents/a11y-analyzer-keyboard.md +0 -175
  283. package/src/core/agents/a11y-analyzer-semantic.md +0 -153
  284. package/src/core/agents/a11y-analyzer-visual.md +0 -158
  285. package/src/core/agents/a11y-consensus.md +0 -248
  286. package/src/core/agents/accessibility.md +0 -515
  287. package/src/core/agents/adr-writer.md +0 -463
  288. package/src/core/agents/ads-audit-budget.md +0 -181
  289. package/src/core/agents/ads-audit-compliance.md +0 -169
  290. package/src/core/agents/ads-audit-creative.md +0 -164
  291. package/src/core/agents/ads-audit-google.md +0 -226
  292. package/src/core/agents/ads-audit-meta.md +0 -183
  293. package/src/core/agents/ads-audit-tracking.md +0 -197
  294. package/src/core/agents/ads-consensus.md +0 -396
  295. package/src/core/agents/ads-generate.md +0 -145
  296. package/src/core/agents/ads-performance-tracker.md +0 -197
  297. package/src/core/agents/analytics.md +0 -617
  298. package/src/core/agents/api-quality-analyzer-conventions.md +0 -148
  299. package/src/core/agents/api-quality-analyzer-docs.md +0 -176
  300. package/src/core/agents/api-quality-analyzer-errors.md +0 -183
  301. package/src/core/agents/api-quality-analyzer-pagination.md +0 -171
  302. package/src/core/agents/api-quality-analyzer-versioning.md +0 -143
  303. package/src/core/agents/api-quality-consensus.md +0 -214
  304. package/src/core/agents/api-validator.md +0 -183
  305. package/src/core/agents/api.md +0 -665
  306. package/src/core/agents/arch-analyzer-circular.md +0 -148
  307. package/src/core/agents/arch-analyzer-complexity.md +0 -171
  308. package/src/core/agents/arch-analyzer-coupling.md +0 -146
  309. package/src/core/agents/arch-analyzer-layering.md +0 -151
  310. package/src/core/agents/arch-analyzer-patterns.md +0 -162
  311. package/src/core/agents/arch-consensus.md +0 -227
  312. package/src/core/agents/brainstorm-analyzer-features.md +0 -169
  313. package/src/core/agents/brainstorm-analyzer-growth.md +0 -161
  314. package/src/core/agents/brainstorm-analyzer-integration.md +0 -172
  315. package/src/core/agents/brainstorm-analyzer-market.md +0 -147
  316. package/src/core/agents/brainstorm-analyzer-ux.md +0 -167
  317. package/src/core/agents/brainstorm-consensus.md +0 -237
  318. package/src/core/agents/browser-qa.md +0 -328
  319. package/src/core/agents/ci.md +0 -511
  320. package/src/core/agents/code-reviewer.md +0 -288
  321. package/src/core/agents/codebase-query.md +0 -266
  322. package/src/core/agents/completeness-analyzer-api.md +0 -190
  323. package/src/core/agents/completeness-analyzer-conditional.md +0 -201
  324. package/src/core/agents/completeness-analyzer-handlers.md +0 -159
  325. package/src/core/agents/completeness-analyzer-imports.md +0 -159
  326. package/src/core/agents/completeness-analyzer-routes.md +0 -182
  327. package/src/core/agents/completeness-analyzer-state.md +0 -188
  328. package/src/core/agents/completeness-analyzer-stubs.md +0 -198
  329. package/src/core/agents/completeness-consensus.md +0 -286
  330. package/src/core/agents/compliance.md +0 -509
  331. package/src/core/agents/council-advocate.md +0 -206
  332. package/src/core/agents/council-analyst.md +0 -252
  333. package/src/core/agents/council-optimist.md +0 -170
  334. package/src/core/agents/database.md +0 -601
  335. package/src/core/agents/datamigration.md +0 -699
  336. package/src/core/agents/design.md +0 -525
  337. package/src/core/agents/devops.md +0 -720
  338. package/src/core/agents/documentation.md +0 -504
  339. package/src/core/agents/epic-planner.md +0 -480
  340. package/src/core/agents/error-analyzer.md +0 -201
  341. package/src/core/agents/integrations.md +0 -603
  342. package/src/core/agents/legal-analyzer-a11y.md +0 -110
  343. package/src/core/agents/legal-analyzer-ai.md +0 -117
  344. package/src/core/agents/legal-analyzer-consumer.md +0 -108
  345. package/src/core/agents/legal-analyzer-content.md +0 -113
  346. package/src/core/agents/legal-analyzer-international.md +0 -115
  347. package/src/core/agents/legal-analyzer-licensing.md +0 -115
  348. package/src/core/agents/legal-analyzer-privacy.md +0 -108
  349. package/src/core/agents/legal-analyzer-security.md +0 -112
  350. package/src/core/agents/legal-analyzer-terms.md +0 -111
  351. package/src/core/agents/legal-consensus.md +0 -242
  352. package/src/core/agents/logic-analyzer-edge.md +0 -170
  353. package/src/core/agents/logic-analyzer-flow.md +0 -253
  354. package/src/core/agents/logic-analyzer-invariant.md +0 -206
  355. package/src/core/agents/logic-analyzer-race.md +0 -266
  356. package/src/core/agents/logic-analyzer-type.md +0 -217
  357. package/src/core/agents/logic-consensus.md +0 -253
  358. package/src/core/agents/mentor.md +0 -654
  359. package/src/core/agents/mobile.md +0 -501
  360. package/src/core/agents/monitoring.md +0 -537
  361. package/src/core/agents/multi-expert.md +0 -311
  362. package/src/core/agents/orchestrator.md +0 -749
  363. package/src/core/agents/perf-analyzer-assets.md +0 -174
  364. package/src/core/agents/perf-analyzer-bundle.md +0 -165
  365. package/src/core/agents/perf-analyzer-caching.md +0 -160
  366. package/src/core/agents/perf-analyzer-compute.md +0 -165
  367. package/src/core/agents/perf-analyzer-memory.md +0 -182
  368. package/src/core/agents/perf-analyzer-network.md +0 -157
  369. package/src/core/agents/perf-analyzer-queries.md +0 -155
  370. package/src/core/agents/perf-analyzer-rendering.md +0 -156
  371. package/src/core/agents/perf-consensus.md +0 -280
  372. package/src/core/agents/performance.md +0 -492
  373. package/src/core/agents/product.md +0 -535
  374. package/src/core/agents/qa.md +0 -765
  375. package/src/core/agents/readme-updater.md +0 -579
  376. package/src/core/agents/refactor.md +0 -558
  377. package/src/core/agents/research.md +0 -453
  378. package/src/core/agents/rlm-subcore.md +0 -207
  379. package/src/core/agents/schema-validator.md +0 -454
  380. package/src/core/agents/security-analyzer-api.md +0 -199
  381. package/src/core/agents/security-analyzer-auth.md +0 -160
  382. package/src/core/agents/security-analyzer-authz.md +0 -168
  383. package/src/core/agents/security-analyzer-deps.md +0 -147
  384. package/src/core/agents/security-analyzer-infra.md +0 -176
  385. package/src/core/agents/security-analyzer-injection.md +0 -148
  386. package/src/core/agents/security-analyzer-input.md +0 -191
  387. package/src/core/agents/security-analyzer-secrets.md +0 -175
  388. package/src/core/agents/security-consensus.md +0 -276
  389. package/src/core/agents/security.md +0 -486
  390. package/src/core/agents/seo-analyzer-content.md +0 -167
  391. package/src/core/agents/seo-analyzer-images.md +0 -187
  392. package/src/core/agents/seo-analyzer-performance.md +0 -206
  393. package/src/core/agents/seo-analyzer-schema.md +0 -176
  394. package/src/core/agents/seo-analyzer-sitemap.md +0 -172
  395. package/src/core/agents/seo-analyzer-technical.md +0 -144
  396. package/src/core/agents/seo-consensus.md +0 -289
  397. package/src/core/agents/team-coordinator.md +0 -333
  398. package/src/core/agents/team-lead.md +0 -171
  399. package/src/core/agents/test-analyzer-assertions.md +0 -181
  400. package/src/core/agents/test-analyzer-coverage.md +0 -183
  401. package/src/core/agents/test-analyzer-fragility.md +0 -185
  402. package/src/core/agents/test-analyzer-integration.md +0 -155
  403. package/src/core/agents/test-analyzer-maintenance.md +0 -173
  404. package/src/core/agents/test-analyzer-mocking.md +0 -178
  405. package/src/core/agents/test-analyzer-patterns.md +0 -189
  406. package/src/core/agents/test-analyzer-structure.md +0 -177
  407. package/src/core/agents/test-consensus.md +0 -294
  408. package/src/core/agents/testing.md +0 -527
  409. package/src/core/agents/ui-validator.md +0 -331
  410. package/src/core/agents/ui.md +0 -1227
  411. package/src/core/commands/adr/list.md +0 -191
  412. package/src/core/commands/adr/update.md +0 -258
  413. package/src/core/commands/adr/view.md +0 -274
  414. package/src/core/commands/adr.md +0 -394
  415. package/src/core/commands/ads/audit.md +0 -453
  416. package/src/core/commands/ads/budget.md +0 -97
  417. package/src/core/commands/ads/competitor.md +0 -112
  418. package/src/core/commands/ads/creative.md +0 -85
  419. package/src/core/commands/ads/generate.md +0 -238
  420. package/src/core/commands/ads/google.md +0 -112
  421. package/src/core/commands/ads/health.md +0 -327
  422. package/src/core/commands/ads/landing.md +0 -119
  423. package/src/core/commands/ads/linkedin.md +0 -112
  424. package/src/core/commands/ads/meta.md +0 -91
  425. package/src/core/commands/ads/microsoft.md +0 -115
  426. package/src/core/commands/ads/plan.md +0 -321
  427. package/src/core/commands/ads/test-plan.md +0 -317
  428. package/src/core/commands/ads/tiktok.md +0 -129
  429. package/src/core/commands/ads/track.md +0 -288
  430. package/src/core/commands/ads/youtube.md +0 -124
  431. package/src/core/commands/ads.md +0 -140
  432. package/src/core/commands/agent.md +0 -256
  433. package/src/core/commands/api.md +0 -267
  434. package/src/core/commands/assign.md +0 -369
  435. package/src/core/commands/audit.md +0 -531
  436. package/src/core/commands/auto.md +0 -556
  437. package/src/core/commands/automate.md +0 -415
  438. package/src/core/commands/babysit.md +0 -643
  439. package/src/core/commands/baseline.md +0 -743
  440. package/src/core/commands/batch.md +0 -551
  441. package/src/core/commands/blockers.md +0 -602
  442. package/src/core/commands/board.md +0 -509
  443. package/src/core/commands/browser-qa.md +0 -240
  444. package/src/core/commands/changelog.md +0 -582
  445. package/src/core/commands/choose.md +0 -430
  446. package/src/core/commands/ci.md +0 -330
  447. package/src/core/commands/code/accessibility.md +0 -363
  448. package/src/core/commands/code/api.md +0 -313
  449. package/src/core/commands/code/architecture.md +0 -313
  450. package/src/core/commands/code/completeness.md +0 -519
  451. package/src/core/commands/code/legal.md +0 -509
  452. package/src/core/commands/code/logic.md +0 -432
  453. package/src/core/commands/code/performance.md +0 -506
  454. package/src/core/commands/code/security.md +0 -509
  455. package/src/core/commands/code/test.md +0 -505
  456. package/src/core/commands/compress.md +0 -408
  457. package/src/core/commands/configure.md +0 -1159
  458. package/src/core/commands/context/export.md +0 -296
  459. package/src/core/commands/context/full.md +0 -353
  460. package/src/core/commands/context/note.md +0 -380
  461. package/src/core/commands/council.md +0 -592
  462. package/src/core/commands/debt.md +0 -491
  463. package/src/core/commands/deploy.md +0 -864
  464. package/src/core/commands/deps.md +0 -728
  465. package/src/core/commands/diagnose.md +0 -404
  466. package/src/core/commands/docs.md +0 -469
  467. package/src/core/commands/epic/edit.md +0 -213
  468. package/src/core/commands/epic/list.md +0 -190
  469. package/src/core/commands/epic/view.md +0 -267
  470. package/src/core/commands/epic.md +0 -477
  471. package/src/core/commands/export.md +0 -238
  472. package/src/core/commands/feedback.md +0 -603
  473. package/src/core/commands/handoff.md +0 -386
  474. package/src/core/commands/help.md +0 -194
  475. package/src/core/commands/ideate/brief.md +0 -363
  476. package/src/core/commands/ideate/discover.md +0 -399
  477. package/src/core/commands/ideate/features.md +0 -497
  478. package/src/core/commands/ideate/history.md +0 -403
  479. package/src/core/commands/ideate/new.md +0 -900
  480. package/src/core/commands/impact.md +0 -407
  481. package/src/core/commands/install.md +0 -529
  482. package/src/core/commands/learn/explain.md +0 -118
  483. package/src/core/commands/learn/glossary.md +0 -135
  484. package/src/core/commands/learn/patterns.md +0 -138
  485. package/src/core/commands/learn/tour.md +0 -126
  486. package/src/core/commands/maintain.md +0 -558
  487. package/src/core/commands/metrics.md +0 -844
  488. package/src/core/commands/migrate/codemods.md +0 -151
  489. package/src/core/commands/migrate/plan.md +0 -131
  490. package/src/core/commands/migrate/scan.md +0 -114
  491. package/src/core/commands/migrate/validate.md +0 -119
  492. package/src/core/commands/multi-expert.md +0 -447
  493. package/src/core/commands/packages.md +0 -535
  494. package/src/core/commands/pr.md +0 -337
  495. package/src/core/commands/readme-sync.md +0 -329
  496. package/src/core/commands/research/analyze.md +0 -798
  497. package/src/core/commands/research/ask.md +0 -864
  498. package/src/core/commands/research/import.md +0 -1025
  499. package/src/core/commands/research/list.md +0 -273
  500. package/src/core/commands/research/synthesize.md +0 -928
  501. package/src/core/commands/research/view.md +0 -323
  502. package/src/core/commands/retro.md +0 -795
  503. package/src/core/commands/review.md +0 -694
  504. package/src/core/commands/rlm.md +0 -446
  505. package/src/core/commands/roadmap/analyze.md +0 -400
  506. package/src/core/commands/rpi.md +0 -633
  507. package/src/core/commands/seo/audit.md +0 -444
  508. package/src/core/commands/seo/competitor.md +0 -174
  509. package/src/core/commands/seo/content.md +0 -107
  510. package/src/core/commands/seo/geo.md +0 -229
  511. package/src/core/commands/seo/hreflang.md +0 -140
  512. package/src/core/commands/seo/images.md +0 -96
  513. package/src/core/commands/seo/page.md +0 -198
  514. package/src/core/commands/seo/plan.md +0 -163
  515. package/src/core/commands/seo/programmatic.md +0 -131
  516. package/src/core/commands/seo/references/cwv-thresholds.md +0 -64
  517. package/src/core/commands/seo/references/eeat-framework.md +0 -110
  518. package/src/core/commands/seo/references/quality-gates.md +0 -91
  519. package/src/core/commands/seo/references/schema-types.md +0 -102
  520. package/src/core/commands/seo/schema.md +0 -183
  521. package/src/core/commands/seo/sitemap.md +0 -97
  522. package/src/core/commands/seo/technical.md +0 -100
  523. package/src/core/commands/seo.md +0 -107
  524. package/src/core/commands/session/cleanup.md +0 -452
  525. package/src/core/commands/session/end.md +0 -865
  526. package/src/core/commands/session/history.md +0 -293
  527. package/src/core/commands/session/init.md +0 -210
  528. package/src/core/commands/session/new.md +0 -827
  529. package/src/core/commands/session/resume.md +0 -291
  530. package/src/core/commands/session/spawn.md +0 -205
  531. package/src/core/commands/session/status.md +0 -274
  532. package/src/core/commands/skill/list.md +0 -139
  533. package/src/core/commands/skill/recommend.md +0 -216
  534. package/src/core/commands/sprint.md +0 -714
  535. package/src/core/commands/status/undo.md +0 -191
  536. package/src/core/commands/status.md +0 -423
  537. package/src/core/commands/story/edit.md +0 -204
  538. package/src/core/commands/story/list.md +0 -199
  539. package/src/core/commands/story/view.md +0 -312
  540. package/src/core/commands/story-validate.md +0 -491
  541. package/src/core/commands/story.md +0 -465
  542. package/src/core/commands/tdd-next.md +0 -238
  543. package/src/core/commands/tdd.md +0 -211
  544. package/src/core/commands/team/guide.md +0 -688
  545. package/src/core/commands/team/list.md +0 -59
  546. package/src/core/commands/team/start.md +0 -130
  547. package/src/core/commands/team/status.md +0 -66
  548. package/src/core/commands/team/stop.md +0 -78
  549. package/src/core/commands/template.md +0 -644
  550. package/src/core/commands/tests.md +0 -731
  551. package/src/core/commands/update.md +0 -591
  552. package/src/core/commands/validate-expertise.md +0 -305
  553. package/src/core/commands/velocity.md +0 -630
  554. package/src/core/commands/verify.md +0 -534
  555. package/src/core/commands/whats-new.md +0 -201
  556. package/src/core/commands/workflow.md +0 -449
  557. package/src/core/council/sessions/.gitkeep +0 -0
  558. package/src/core/council/shared_reasoning.template.md +0 -106
  559. package/src/core/experts/README.md +0 -236
  560. package/src/core/experts/_core-expertise.yaml +0 -105
  561. package/src/core/experts/accessibility/expertise.yaml +0 -115
  562. package/src/core/experts/accessibility/question.md +0 -41
  563. package/src/core/experts/accessibility/self-improve.md +0 -45
  564. package/src/core/experts/accessibility/workflow.md +0 -59
  565. package/src/core/experts/adr-writer/expertise.yaml +0 -138
  566. package/src/core/experts/adr-writer/question.md +0 -56
  567. package/src/core/experts/adr-writer/self-improve.md +0 -106
  568. package/src/core/experts/adr-writer/workflow.md +0 -184
  569. package/src/core/experts/analytics/expertise.yaml +0 -119
  570. package/src/core/experts/analytics/question.md +0 -74
  571. package/src/core/experts/analytics/self-improve.md +0 -163
  572. package/src/core/experts/analytics/workflow.md +0 -272
  573. package/src/core/experts/api/expertise.yaml +0 -124
  574. package/src/core/experts/api/question.md +0 -74
  575. package/src/core/experts/api/self-improve.md +0 -122
  576. package/src/core/experts/api/workflow.md +0 -248
  577. package/src/core/experts/ci/expertise.yaml +0 -106
  578. package/src/core/experts/ci/question.md +0 -69
  579. package/src/core/experts/ci/self-improve.md +0 -100
  580. package/src/core/experts/ci/workflow.md +0 -145
  581. package/src/core/experts/codebase-query/expertise.yaml +0 -121
  582. package/src/core/experts/codebase-query/question.md +0 -73
  583. package/src/core/experts/codebase-query/self-improve.md +0 -105
  584. package/src/core/experts/compliance/expertise.yaml +0 -101
  585. package/src/core/experts/compliance/question.md +0 -56
  586. package/src/core/experts/compliance/self-improve.md +0 -106
  587. package/src/core/experts/compliance/workflow.md +0 -184
  588. package/src/core/experts/database/expertise.yaml +0 -109
  589. package/src/core/experts/database/question.md +0 -74
  590. package/src/core/experts/database/self-improve.md +0 -121
  591. package/src/core/experts/database/workflow.md +0 -234
  592. package/src/core/experts/datamigration/expertise.yaml +0 -141
  593. package/src/core/experts/datamigration/question.md +0 -56
  594. package/src/core/experts/datamigration/self-improve.md +0 -106
  595. package/src/core/experts/datamigration/workflow.md +0 -184
  596. package/src/core/experts/design/expertise.yaml +0 -116
  597. package/src/core/experts/design/question.md +0 -56
  598. package/src/core/experts/design/self-improve.md +0 -106
  599. package/src/core/experts/design/workflow.md +0 -184
  600. package/src/core/experts/devops/expertise.yaml +0 -116
  601. package/src/core/experts/devops/question.md +0 -68
  602. package/src/core/experts/devops/self-improve.md +0 -102
  603. package/src/core/experts/devops/workflow.md +0 -142
  604. package/src/core/experts/documentation/expertise.yaml +0 -126
  605. package/src/core/experts/documentation/question.md +0 -41
  606. package/src/core/experts/documentation/self-improve.md +0 -45
  607. package/src/core/experts/documentation/workflow.md +0 -55
  608. package/src/core/experts/epic-planner/expertise.yaml +0 -144
  609. package/src/core/experts/epic-planner/question.md +0 -56
  610. package/src/core/experts/epic-planner/self-improve.md +0 -106
  611. package/src/core/experts/epic-planner/workflow.md +0 -184
  612. package/src/core/experts/integrations/expertise.yaml +0 -113
  613. package/src/core/experts/integrations/question.md +0 -74
  614. package/src/core/experts/integrations/self-improve.md +0 -151
  615. package/src/core/experts/integrations/workflow.md +0 -246
  616. package/src/core/experts/mentor/expertise.yaml +0 -125
  617. package/src/core/experts/mentor/question.md +0 -56
  618. package/src/core/experts/mentor/self-improve.md +0 -106
  619. package/src/core/experts/mentor/workflow.md +0 -184
  620. package/src/core/experts/mobile/expertise.yaml +0 -136
  621. package/src/core/experts/mobile/question.md +0 -72
  622. package/src/core/experts/mobile/self-improve.md +0 -140
  623. package/src/core/experts/mobile/workflow.md +0 -240
  624. package/src/core/experts/monitoring/expertise.yaml +0 -132
  625. package/src/core/experts/monitoring/question.md +0 -76
  626. package/src/core/experts/monitoring/self-improve.md +0 -150
  627. package/src/core/experts/monitoring/workflow.md +0 -264
  628. package/src/core/experts/performance/expertise.yaml +0 -68
  629. package/src/core/experts/performance/question.md +0 -41
  630. package/src/core/experts/performance/self-improve.md +0 -45
  631. package/src/core/experts/performance/workflow.md +0 -61
  632. package/src/core/experts/product/expertise.yaml +0 -143
  633. package/src/core/experts/product/question.md +0 -56
  634. package/src/core/experts/product/self-improve.md +0 -106
  635. package/src/core/experts/product/workflow.md +0 -184
  636. package/src/core/experts/qa/expertise.yaml +0 -110
  637. package/src/core/experts/qa/question.md +0 -56
  638. package/src/core/experts/qa/self-improve.md +0 -106
  639. package/src/core/experts/qa/workflow.md +0 -184
  640. package/src/core/experts/readme-updater/expertise.yaml +0 -141
  641. package/src/core/experts/readme-updater/question.md +0 -56
  642. package/src/core/experts/readme-updater/self-improve.md +0 -106
  643. package/src/core/experts/readme-updater/workflow.md +0 -184
  644. package/src/core/experts/refactor/expertise.yaml +0 -135
  645. package/src/core/experts/refactor/question.md +0 -41
  646. package/src/core/experts/refactor/self-improve.md +0 -45
  647. package/src/core/experts/refactor/workflow.md +0 -57
  648. package/src/core/experts/research/expertise.yaml +0 -143
  649. package/src/core/experts/research/question.md +0 -56
  650. package/src/core/experts/research/self-improve.md +0 -106
  651. package/src/core/experts/research/workflow.md +0 -184
  652. package/src/core/experts/security/expertise.yaml +0 -117
  653. package/src/core/experts/security/question.md +0 -77
  654. package/src/core/experts/security/self-improve.md +0 -102
  655. package/src/core/experts/security/workflow.md +0 -152
  656. package/src/core/experts/templates/expertise-template.yaml +0 -67
  657. package/src/core/experts/templates/question-template.md +0 -56
  658. package/src/core/experts/templates/self-improve-template.md +0 -106
  659. package/src/core/experts/templates/workflow-template.md +0 -184
  660. package/src/core/experts/testing/expertise.yaml +0 -112
  661. package/src/core/experts/testing/question.md +0 -68
  662. package/src/core/experts/testing/self-improve.md +0 -102
  663. package/src/core/experts/testing/workflow.md +0 -143
  664. package/src/core/experts/ui/expertise.yaml +0 -133
  665. package/src/core/experts/ui/question.md +0 -74
  666. package/src/core/experts/ui/self-improve.md +0 -122
  667. package/src/core/experts/ui/workflow.md +0 -262
  668. package/src/core/knowledge/ads/ad-audit-checklist-scoring.md +0 -424
  669. package/src/core/knowledge/ads/ad-optimization-logic.md +0 -590
  670. package/src/core/knowledge/ads/ad-technical-specifications.md +0 -385
  671. package/src/core/knowledge/ads/definitive-advertising-reference-2026.md +0 -506
  672. package/src/core/knowledge/ads/paid-advertising-research-2026.md +0 -445
  673. package/src/core/profiles/COMPARISON.md +0 -170
  674. package/src/core/profiles/README.md +0 -178
  675. package/src/core/profiles/claude-code.yaml +0 -111
  676. package/src/core/profiles/codex.yaml +0 -103
  677. package/src/core/profiles/cursor.yaml +0 -134
  678. package/src/core/profiles/examples.js +0 -250
  679. package/src/core/profiles/loader.js +0 -235
  680. package/src/core/profiles/windsurf.yaml +0 -159
  681. package/src/core/skills/_learnings/README.md +0 -91
  682. package/src/core/skills/_learnings/_template.yaml +0 -106
  683. package/src/core/skills/_learnings/code-review.yaml +0 -118
  684. package/src/core/skills/_learnings/commit.yaml +0 -69
  685. package/src/core/skills/_learnings/story-writer.yaml +0 -71
  686. package/src/core/teams/backend.json +0 -41
  687. package/src/core/teams/builder-validator.json +0 -51
  688. package/src/core/teams/code-review.json +0 -41
  689. package/src/core/teams/frontend.json +0 -41
  690. package/src/core/teams/fullstack.json +0 -41
  691. package/src/core/teams/logic-audit.json +0 -53
  692. package/src/core/teams/perf-audit.json +0 -71
  693. package/src/core/teams/qa.json +0 -41
  694. package/src/core/teams/security-audit.json +0 -71
  695. package/src/core/teams/solo.json +0 -35
  696. package/src/core/teams/test-audit.json +0 -71
  697. package/src/core/templates/CONTEXT.md.example +0 -49
  698. package/src/core/templates/README-template.md +0 -16
  699. package/src/core/templates/adr-template.md +0 -28
  700. package/src/core/templates/agent-coordination-pattern.md +0 -38
  701. package/src/core/templates/agent-profile-template.md +0 -51
  702. package/src/core/templates/agileflow-metadata.json +0 -150
  703. package/src/core/templates/browser-qa-spec.yaml +0 -94
  704. package/src/core/templates/ci-workflow.yml +0 -74
  705. package/src/core/templates/claude-settings.advanced.example.json +0 -75
  706. package/src/core/templates/claude-settings.example.json +0 -26
  707. package/src/core/templates/command-documentation.md +0 -187
  708. package/src/core/templates/command-prerequisites.yaml +0 -169
  709. package/src/core/templates/comms-note-template.md +0 -24
  710. package/src/core/templates/damage-control-patterns.yaml +0 -243
  711. package/src/core/templates/environment.json +0 -18
  712. package/src/core/templates/epic-template.md +0 -27
  713. package/src/core/templates/plan-template.md +0 -125
  714. package/src/core/templates/preserve-rules-common.md +0 -107
  715. package/src/core/templates/preserve-rules.json +0 -42
  716. package/src/core/templates/proactive-action-spec.md +0 -29
  717. package/src/core/templates/product-brief.md +0 -136
  718. package/src/core/templates/quality-gate-priorities.md +0 -34
  719. package/src/core/templates/research-template.md +0 -44
  720. package/src/core/templates/session-harness-protocol.md +0 -128
  721. package/src/core/templates/session-state.json +0 -56
  722. package/src/core/templates/story-lifecycle.md +0 -213
  723. package/src/core/templates/story-template.md +0 -92
  724. package/src/core/templates/tdd-test-template.js +0 -241
  725. package/src/core/templates/worktrees-guide.md +0 -231
  726. package/tools/agileflow-npx.js +0 -52
  727. package/tools/cli/agileflow-cli.js +0 -72
  728. package/tools/cli/commands/config.js +0 -285
  729. package/tools/cli/commands/doctor.js +0 -496
  730. package/tools/cli/commands/list.js +0 -385
  731. package/tools/cli/commands/session.js +0 -1176
  732. package/tools/cli/commands/setup.js +0 -255
  733. package/tools/cli/commands/status.js +0 -101
  734. package/tools/cli/commands/tui.js +0 -56
  735. package/tools/cli/commands/uninstall.js +0 -155
  736. package/tools/cli/commands/update.js +0 -299
  737. package/tools/cli/installers/core/installer.js +0 -892
  738. package/tools/cli/installers/ide/_base-ide.js +0 -518
  739. package/tools/cli/installers/ide/_interface.js +0 -238
  740. package/tools/cli/installers/ide/claude-code.js +0 -432
  741. package/tools/cli/installers/ide/codex.js +0 -426
  742. package/tools/cli/installers/ide/cursor.js +0 -217
  743. package/tools/cli/installers/ide/manager.js +0 -222
  744. package/tools/cli/installers/ide/windsurf.js +0 -282
  745. package/tools/cli/lib/command-context.js +0 -382
  746. package/tools/cli/lib/config-manager.js +0 -446
  747. package/tools/cli/lib/content-injector.js +0 -969
  748. package/tools/cli/lib/content-transformer.js +0 -496
  749. package/tools/cli/lib/docs-setup.js +0 -464
  750. package/tools/cli/lib/error-handler.js +0 -165
  751. package/tools/cli/lib/ide-error-factory.js +0 -421
  752. package/tools/cli/lib/ide-errors.js +0 -367
  753. package/tools/cli/lib/ide-generator.js +0 -357
  754. package/tools/cli/lib/ide-health-monitor.js +0 -364
  755. package/tools/cli/lib/ide-registry.js +0 -297
  756. package/tools/cli/lib/npm-utils.js +0 -103
  757. package/tools/cli/lib/self-update.js +0 -148
  758. package/tools/cli/lib/ui.js +0 -211
  759. package/tools/cli/lib/utils.js +0 -87
  760. package/tools/cli/lib/validation-middleware.js +0 -491
  761. package/tools/cli/lib/version-checker.js +0 -95
  762. package/tools/postinstall.js +0 -190
@@ -1,590 +0,0 @@
1
- # Algorithmic Ad Optimization Protocol 2026: Technical Decision Architectures, Bidding Logic, and Capital Allocation Frameworks
2
-
3
- ---
4
-
5
- ## 1. Introduction: The Deterministic to Probabilistic Shift
6
-
7
- The digital advertising landscape of February 2026 operates on a fundamentally different substrate than the keyword-centric models of the previous decade. We have transitioned from a deterministic era -- characterized by cookie-based tracking, exact-match keyword reliance, and manual bid adjustments -- to a probabilistic, signal-based ecosystem governed by predictive artificial intelligence. The depreciation of third-party cookies, completed in late 2025, alongside the maturation of privacy-preserving frameworks like the Privacy Sandbox and Apple's SKAdNetwork 5.0, has necessitated a total architectural overhaul of advertising logic.<sup>1</sup>
8
-
9
- For automated optimization engines such as claude-ads, general marketing advice is operational noise. Success in 2026 requires rigid, conditional logic trees rooted in statistical significance and algorithmic behaviorism. Advertisers no longer purchase "clicks" or "impressions"; they purchase conversion probabilities calculated in real-time auctions. The decision engines driving Google's Smart Bidding and Meta's Andromeda algorithm optimize for outcomes based on thousands of data points -- device telemetry, semantic intent, user value prediction, and cross-platform journey mapping -- far beyond human processing capacity.
10
-
11
- This report serves as the technical specification for an automated decision engine. It rejects heuristic "best practices" in favor of numeric thresholds, failsafe protocols, and exact "IF/THEN" logic required to programmatically manage ad spend. It delineates the specific conditions under which bidding strategies must be deployed, the mathematical relationships governing budget allocation across ten distinct business verticals, and the server-side infrastructure required to feed these algorithms the "truth data" they require to function.
12
-
13
- ---
14
-
15
- ## 2. SECTION 1: GOOGLE ADS BIDDING DECISION ENGINE (2026)
16
-
17
- In the 2026 ecosystem, Google Ads bidding is strictly a function of data density and conversion confidence. The granularity of the 2010s -- where advertisers manually bid on individual keywords -- is obsolete. The "Simplified Aggregation" structure is now the gold standard, designed to consolidate data signals to feed Smart Bidding algorithms.<sup>2</sup> With the deprecation of Enhanced CPC (eCPC) in March 2025, the middle ground between manual control and full automation has vanished, forcing a binary choice: manual constraint or algorithmic freedom.<sup>3</sup>
18
-
19
- ### 2.1 Maximize Clicks
20
-
21
- **Strategy Name:** Maximize Clicks
22
-
23
- **Algorithmic Logic:**
24
-
25
- The algorithm utilizes a "lowest-cost-first" auction theory. It scans available inventory within the targeted parameters (keywords, audiences) and bids to secure the maximum volume of traffic that fits within the daily budget cap. It assigns a conversion probability of zero to all users; a user likely to bounce is valued identically to a user likely to purchase, provided the cost of the click is equal.
26
-
27
- **Minimum Requirements:**
28
-
29
- - **Conversion Volume:** 0 conversions required.
30
- - **Campaign Age:** 0 days (Day 1 viable).
31
- - **Data Volume:** None.
32
-
33
- **When to Use (Specific Conditions):**
34
-
35
- 1. **Cold Start Protocol:** New accounts with **< 15 conversions in the last 30 days**.<sup>4</sup> The algorithm builds traffic baselines required to populate remarketing lists (Minimum List Size: 1,000 active users).
36
- 2. **Low-Volume B2B Niche:** Keywords with search volume < 100/month where Smart Bidding effectively "throttles" impressions due to lack of conversion signal.
37
- 3. **Traffic Arbitrage:** Models relying on ad revenue or page views rather than transactional conversions.
38
-
39
- **When NOT to Use (Anti-Patterns):**
40
-
41
- - **Conversion Volume > 30/month:** Using Max Clicks here is mathematically inefficient; it ignores the purchase intent signal accrued by the pixel.
42
- - **Broad Match Keywords:** This combination is a "budget suicide" vector. Max Clicks will find the cheapest, lowest-intent queries (e.g., "free [product]") to fill the budget.
43
- - **Strict Profitability Goals:** If ROAS is the primary KPI, this strategy will fail as it does not discriminate between high-value and low-value users.
44
-
45
- **Expected Learning Phase:**
46
-
47
- - **Duration:** 3--5 Days.
48
- - **Exit Trigger:** Stabilization of CPC and Impression Share.
49
-
50
- **Ramp-Up Protocol:**
51
-
52
- - **Constraint:** ALWAYS set a "Maximum CPC Bid Limit." Calculation:
53
-
54
- $$\text{Max CPC} = \frac{\text{Target CPA}}{\text{Estimated CVR} \times 1.5}$$
55
-
56
- Without this, the algorithm may pay exorbitant amounts ($50+) for single clicks in thin auctions.
57
-
58
- **Danger Signals (Failure Thresholds):**
59
-
60
- - **Bounce Rate Spike:** > 80% bounce rate (or 20% higher than historical average).
61
- - **Conversion Rate (CVR) Crash:** CVR drops below 0.5% for > 7 consecutive days.
62
- - **Traffic Quality:** Search Term Report shows > 40% "Close Variant" matches that are irrelevant.
63
-
64
- ---
65
-
66
- ### 2.2 Maximize Conversions (No Target)
67
-
68
- **Strategy Name:** Maximize Conversions
69
-
70
- **Algorithmic Logic:**
71
-
72
- The algorithm operates on a "budget exhaustion" principle combined with "conversion probability." It aims to spend 100% of the daily budget. Within that constraint, it bids on users with the highest predicted CVR. It does *not* respect a cost cap; it will pay $500 for a conversion if it believes that conversion is the only one available to satisfy the "spend budget" directive.
73
-
74
- **Minimum Requirements:**
75
-
76
- - **Conversion Volume:** 15 conversions in the last 30 days (Recommended: 30+).<sup>5</sup>
77
- - **Campaign Age:** > 2 weeks.
78
-
79
- **When to Use (Specific Conditions):**
80
-
81
- 1. **Transition Phase:** Moving from Max Clicks/Manual CPC once 15+ conversions are recorded but data is too volatile for a specific tCPA.
82
- 2. **Budget Constrained:** Campaigns flagged as "Limited by Budget" (Impression Share Lost to Budget > 20%). The algorithm ensures efficiency within the scarcity of the cap.
83
- 3. **Volume Priority:** When volume is prioritized over efficiency, and the advertiser is willing to accept fluctuating CPAs to maximize lead flow.
84
-
85
- **When NOT to Use:**
86
-
87
- - **Uncapped Budgets:** If the daily budget is significantly higher than actual spend capability, the algorithm will aggressively raise bids to spend the money, driving CPA to unsustainable levels.
88
- - **Fixed Margin Models:** Lead generation with strict $50 margins cannot risk the volatility of "No Target" bidding.
89
-
90
- **Expected Learning Phase:**
91
-
92
- - **Duration:** 7--14 Days.
93
- - **Conversion Count:** Needs ~15-30 events to stabilize.<sup>4</sup>
94
-
95
- **Ramp-Up Protocol:**
96
-
97
- - **Transition:** Run for 14 days to establish a baseline CPA.
98
- - **Next Step:** Once CPA stabilizes (Standard Deviation < 20%), apply a Target CPA (tCPA) to cap costs.
99
-
100
- **Danger Signals:**
101
-
102
- - **CPA Inflation:** CPA exceeds historical average by > 30% for 3 consecutive days.
103
- - **CPC Decoupling:** CPC rises while CVR remains flat.
104
-
105
- ---
106
-
107
- ### 2.3 Target CPA (tCPA)
108
-
109
- **Strategy Name:** Target Cost Per Action (tCPA)
110
-
111
- **Algorithmic Logic:** This is a "portfolio-based" probability engine. It sets unique bids for every single auction based on the likelihood of conversion. The target is an *average* over 30 days. It will bid 3x the target for a high-probability user and 0.1x for a low-probability user, aiming to settle at the weighted average.<sup>4</sup>
112
-
113
- **Minimum Requirements:**
114
-
115
- - **Strict Threshold:** 30 conversions in the last 30 days at the campaign level.<sup>4</sup>
116
- - **Ideal Threshold:** 50+ conversions/month for stability.
117
-
118
- **When to Use:**
119
-
120
- - **Lead Generation:** The standard for service businesses, SaaS (Demo/Trial), and B2B where value is binary (Lead vs. No Lead).<sup>2</sup>
121
- - **Scale with Efficiency:** When the goal is to uncap the budget but maintain unit economics.
122
-
123
- **When NOT to Use:**
124
-
125
- - **Data Scarcity:** < 15 conversions/month (Algorithm enters "Guessing Mode," leading to 0 impressions).
126
- - **Low Budget:** If Daily Budget < 2x Target CPA. (The algorithm needs room to fail; a budget tighter than 2 conversions restricts learning).
127
-
128
- **Target Setting Protocol (Numeric):**
129
-
130
- - **Initial Target:** Set at **1.1x to 1.2x** of the *historical* 30-day average CPA.<sup>6</sup>
131
- - *Logic:* If historical CPA is $50, set tCPA to $55 or $60. Setting it to $40 (aspirational) will cause the algorithm to filter out 80% of auctions, killing volume.
132
- - **Adjustment Increments:** Change targets by max **10% every 14 days**.
133
-
134
- **Danger Signals:**
135
-
136
- - **Impression Crash:** Impressions drop > 20% week-over-week (Target is too low).
137
- - **Zero Conversion Days:** 3 consecutive days with 0 conversions (Signal loss or technical tracking failure).
138
-
139
- ---
140
-
141
- ### 2.4 Target ROAS (tROAS)
142
-
143
- **Strategy Name:** Target Return on Ad Spend
144
-
145
- **Algorithmic Logic:**
146
-
147
- The algorithm predicts two variables: Conversion Probability ($P(c)$) and Predicted Conversion Value ($V_p$).
148
-
149
- $$\text{Bid} = P(c) \times V_p \times \frac{1}{\text{Target ROAS}}$$
150
-
151
- It aggressively bids on users likely to spend *more* (High AOV) and ignores users likely to spend little, even if they convert.
152
-
153
- **Minimum Requirements:**
154
-
155
- - **Strict Threshold:** 50 conversions in the last 30 days.<sup>5</sup>
156
- - **Value Requirement:** Must pass dynamic conversion values (e.g., checkout total) or varied static values (Lead = $50, Call = $20).
157
-
158
- **When to Use:**
159
-
160
- - **E-commerce:** Standard for Shopping and Performance Max.
161
- - **B2B with Offline Data:** Uploading "Closed Won" deal values to optimize for revenue rather than leads.<sup>7</sup>
162
-
163
- **When NOT to Use:**
164
-
165
- - **Homogenous Value:** If every conversion is worth exactly $100, tROAS is mathematically identical to tCPA but with higher data requirements. Use tCPA instead.
166
-
167
- **Target Setting Protocol:**
168
-
169
- - **Initial Target:** Set at the **exact historical ROAS** of the last 30 days.<sup>4</sup>
170
- - *Example:* If Last 30 Day ROAS = 450%, Set Target = 450%.
171
- - **Scaling:** To scale volume, *lower* the ROAS target (e.g., 450% -> 420%). To increase efficiency, *raise* it (450% -> 480%).
172
-
173
- **Danger Signals:**
174
-
175
- - **Zero Spend:** If tROAS is set unrealistically high (e.g., 800% when historical is 400%), the campaign will cease spending immediately.
176
-
177
- ---
178
-
179
- ### 2.5 Target Impression Share
180
-
181
- **Strategy Name:** Target Impression Share
182
-
183
- **Algorithmic Logic:** A rule-based bidding system designed to achieve visibility, not performance. It ignores conversion data entirely. Bids are calculated solely to beat the Ad Rank of competitors for specific slots (Absolute Top, Top of Page, Anywhere).<sup>8</sup>
184
-
185
- **Minimum Requirements:**
186
-
187
- - None (Can be used Day 1).
188
-
189
- **When to Use:**
190
-
191
- 1. **Brand Protection:** Target "Absolute Top of Page" at 95-100% Share on Brand Keywords to block competitors.
192
- 2. **Local Dominance:** Local service businesses forcing visibility in a specific radius for "near me" terms.
193
- 3. **Conquesting:** Bidding on competitor brand names (Expect high CPCs/Low QS).
194
-
195
- **When NOT to Use:**
196
-
197
- - **Direct Response:** Never use for generic keywords if ROI is the goal. CPCs will often be 3-4x higher than necessary to convert.
198
-
199
- **Danger Signals:**
200
-
201
- - **CPC Spike:** Average CPC exceeds 300% of account average.
202
- - **IS Lost (Budget):** If budget runs out by 10 AM, the target % is too high for the daily cap.
203
-
204
- ---
205
-
206
- ### 2.6 Manual CPC
207
-
208
- **Strategy Name:** Manual CPC
209
-
210
- **Algorithmic Logic:**
211
-
212
- Deterministic bidding. The advertiser sets a static Max CPC. This bid is the ceiling. Auction eligibility is determined solely by Bid x Quality Score.
213
-
214
- **Status 2026:**
215
-
216
- - Enhanced CPC (eCPC) was deprecated in March 2025. Manual CPC is now "naked" -- no algorithmic adjustment for conversion probability.<sup>3</sup>
217
-
218
- **When to Use:**
219
-
220
- 1. **Data Poverty:** < 15 conversions/month where Smart Bidding fails.
221
- 2. **Portfolio Control:** Advertisers who require granular control over specific keyword profitability.
222
- 3. **Display/Video:** Controlling inventory costs on placements.
223
-
224
- **When NOT to Use:**
225
-
226
- - **Broad Match:** Manual CPC + Broad Match is dangerous because the bid is static while the query intent varies wildly.
227
-
228
- **Danger Signals:**
229
-
230
- - **Falling Impression Share:** Competitors using Smart Bidding will outbid Manual strategies for the *best* users, leaving Manual campaigns with "remnant" inventory (low-propensity users).
231
-
232
- ---
233
-
234
- ### 2.7 Portfolio Bid Strategies (The 2026 Control Layer)
235
-
236
- **Strategy Name:** Portfolio Strategies
237
-
238
- **Function:** A wrapper that applies a single bidding logic (tCPA, tROAS) across multiple campaigns.<sup>10</sup>
239
-
240
- **Critical 2026 Use Case:**
241
-
242
- - **The CPC Cap Hack:** In 2026, standard Smart Bidding strategies do *not* allow CPC caps. Portfolio Strategies are the **only** way to set a "Maximum Bid Limit" on tCPA or tROAS.<sup>4</sup>
243
- - **Logic:** IF (Using tCPA) AND (Fear of $50+ Clicks) THEN (Apply Portfolio Strategy with Max CPC Cap = $15).
244
-
245
- **When to Use:**
246
-
247
- - Aggregating data: Grouping 5 low-volume regional campaigns into one Portfolio allows them to share conversion data, hitting the 30-conversion threshold faster.
248
-
249
- ---
250
-
251
- ## 3. SECTION 2: META ADS BIDDING DECISION ENGINE
252
-
253
- Meta's "Andromeda" algorithm (2026) operates on a "Total Value" equation:
254
-
255
- $$\text{Total Value} = \text{Bid} \times \text{Estimated Action Rate (EAR)} + \text{User Value (Quality)}$$
256
-
257
- Success depends on maximizing EAR through creative freshness and server-side signal density.<sup>11</sup> The "Learning Phase" is strictly defined as **50 conversions per week per ad set**.<sup>12</sup>
258
-
259
- ### 3.1 Bidding Strategy Logic
260
-
261
- #### Lowest Cost (Highest Volume)
262
-
263
- - **Logic:** Automatic bidding to clear the budget. Meta enters every auction it can afford, starting with the cheapest users. As budget scales, it moves to more expensive (higher marginal cost) users.
264
- - **When to Use:**
265
- - **Baseline:** 90% of campaigns.
266
- - **Cold Start:** New Ad Accounts with no pixel history.
267
- - **Consistently Spending:** When daily full budget utilization is the priority over strict cost controls.
268
- - **Risk:** Cost instability. CPA will fluctuate daily based on auction competition (CPM).
269
-
270
- #### Cost Cap
271
-
272
- - **Logic:** "Get as many conversions as possible *without* exceeding an average cost of $X."
273
- - **Constraint:** Limits delivery. If the auction price for a user > Cost Cap, Meta will **not** bid.
274
- - **When to Use:**
275
- - **Profit Protection:** When margins are thin (e.g., Dropshipping, Low-margin SaaS).
276
- - **Scaling:** Setting a floor for efficiency while increasing budget.
277
- - **Threshold:** Set Cost Cap at **1.2x - 1.5x** of the target CPA initially. Setting it *at* the target often throttles delivery to zero because the algorithm includes a "pacing buffer".<sup>11</sup>
278
-
279
- #### Bid Cap
280
-
281
- - **Logic:** "Do not bid more than $Y in any single auction." This controls the *input* (Bid), whereas Cost Cap controls the *output* (CPA).
282
- - **When to Use:**
283
- - **Advanced Sniper:** Targeting specific high-value users in competitive niches (e.g., Q4 Black Friday).
284
- - **Retargeting:** Preventing overpaying for warm audiences.
285
- - **Threshold:** Start with Bid Cap **2x-3x** the target CPA. (You must bid high to win high-quality users; paying $50 for a click is fine if that user converts at 50%).
286
-
287
- #### ROAS Goal (Minimum ROAS)
288
-
289
- - **Logic:** "Only enter auctions where Predicted Value / Cost > X."
290
- - **When to Use:**
291
- - **Catalog Sales:** E-commerce with high SKU variance ($20 socks vs. $500 jackets).
292
- - **Requirement:** Accurate Value passing via CAPI.
293
-
294
- #### Highest Value
295
-
296
- - **Logic:** Spend budget to maximize total revenue (User Value). Does not guarantee a specific ROAS.
297
- - **When to Use:** Default for Advantage+ Shopping Campaigns (ASC).
298
-
299
- ### 3.2 Budget Architecture: CBO vs. ABO Logic
300
-
301
- The CBO (Advantage+ Campaign Budget) vs. ABO (Ad Set Budget Optimization) decision is purely a function of **budget density** and **testing stage**.<sup>13</sup>
302
-
303
- **Decision Tree:**
304
-
305
- 1. **Check Budget Level:**
306
- - **IF** Daily Budget < **$100**:
307
- - **THEN**: Use **ABO**.
308
- - **Reason:** CBO requires "fluidity." With <$100, CBO will identify one "early winner" (often a false positive) and starve other ad sets, preventing statistical significance.
309
- - **IF** Daily Budget > **$500**:
310
- - **THEN**: Use **CBO**.
311
- - **Reason:** At high volume, the algorithm's real-time liquidity allocation outperforms manual shifts.
312
- 2. **Check Campaign Phase:**
313
- - **IF** Goal = **Creative Testing**:
314
- - **THEN**: Use **ABO** (or CBO with Min/Max Spend Limits).
315
- - **Logic:** You must force spend to new creatives to prove them valid. CBO will ignore new creatives in favor of historical winners.
316
- - **IF** Goal = **Scaling**:
317
- - **THEN**: Use **CBO**.
318
- - **Logic:** Group 3-5 winning ad sets/creatives. Allow CBO to auto-allocate based on daily auction fluctuations.
319
-
320
- ### 3.3 Learning Phase Protocol
321
-
322
- - **Exact Count: 50 conversions per week per ad set** (approx. 7-8/day).<sup>12</sup>
323
- - **Implication:** If budget cannot support 50 conversions/week (e.g., CPA is $50, Weekly Budget is $1,000 = 20 conversions), you **must** consolidate ad sets. Running 5 ad sets with 4 conversions each keeps *all* of them in "Learning Limited," degrading performance by ~20-40%.
324
- - **Reset Triggers (The "Do Not Touch" List):**
325
- - **Budget:** Changing budget by > **20%** in 24 hours.<sup>14</sup>
326
- - **Targeting:** Any change to audience.
327
- - **Creative:** Editing any active ad (headline, image, text).
328
- - **Bid:** Changing Cost Cap/Bid Cap amounts.
329
-
330
- ---
331
-
332
- ## 4. SECTION 3: BUDGET ALLOCATION FRAMEWORKS
333
-
334
- Allocation in 2026 is governed by **Time-to-Profitability** (cash flow cycles) and **Unit Economics**.
335
-
336
- ### 4.1 Platform Selection Matrix (2026)
337
-
338
- | Business Type | Recommended Split (2026) | Min. Viable Budget | Primary KPI | Time to Profit |
339
- |---|---|---|---|---|
340
- | **SaaS (B2B)** | LinkedIn (40%), Google Search (30%), Meta (20%), Other (10%) | $5,000/mo | Pipeline Value / SQL Cost | 3--6 Months |
341
- | **E-commerce** | Meta (50%), Google PMax (30%), TikTok (15%), Email (5%) | $3,000/mo | MER / ROAS | 0--2 Months |
342
- | **Local Service** | Google LSA/Search (60%), Meta (30%), Bing (10%) | $1,500/mo | Cost Per Lead (CPL) | 1 Month |
343
- | **B2B Enterprise** | LinkedIn (60%), Google Search (20%), ABM Display (20%) | $10,000/mo | Cost Per Account | 6--12 Months |
344
- | **Info Products** | YouTube (40%), Meta (40%), Email (20%) | $2,000/mo | ROAS / Funnel ROI | 1--3 Months |
345
- | **Mobile App** | Apple Search Ads (30%), Google App (30%), Meta/TikTok (40%) | $5,000/mo | CPI / LTV | 3--6 Months |
346
- | **Real Estate** | Meta Lead Forms (50%), Google Search (40%), LinkedIn (10%) | $2,500/mo | CPL / Appt Set | 2--4 Months |
347
- | **Healthcare** | Google Search (70%), Meta Remarketing (30%) | $4,000/mo | CPL / Patient Value | 2--5 Months |
348
- | **Finance** | Google Search (50%), Affiliate/Native (30%), LinkedIn (20%) | $8,000/mo | CAC / Deposit Value | 4--8 Months |
349
- | **Agency** | LinkedIn (50%), Meta (30%), Google (20%) | $1,500/mo | CPL / MQL | 1--3 Months |
350
-
351
- Sources:<sup>15</sup>
352
-
353
- ### 4.2 Budget Scaling Decision Tree
354
-
355
- **Inputs:** Current\_CPA, Target\_CPA, Impression\_Share\_Lost, Frequency.
356
-
357
- 1. **Scaling Logic (The "20% Rule"):**
358
- - **IF** Current\_CPA < Target\_CPA (by > 10%) **AND** (Impression\_Share\_Lost\_to\_Budget > 10% [Google] OR Frequency < 2.0 [Meta]):
359
- - **THEN:** Increase Daily Budget by **20%**.
360
- - **WAIT:** 72 Hours (3 Days) to monitor CPA stability. Do not scale again until 72 hours pass.<sup>14</sup>
361
- - **IF** CPA remains stable: Repeat.
362
- 2. **Kill Logic (The "3x Rule"):**
363
- - **IF** Ad Spend > **3x Target CPA** AND Conversions = 0:
364
- - **THEN: KILL** (Pause Ad/Ad Set immediately).
365
- - **IF** Ad Spend > **1x Target CPA** AND Clicks = 0 (or CTR < 0.2%):
366
- - **THEN:** Check Creative/Technical (Broken Link?).
367
- 3. **Decreasing Logic:**
368
- - **IF** Current\_CPA > Target\_CPA (by > 20%) for 7 days:
369
- - **THEN:** Decrease Budget by 20% to force algorithm efficiency.
370
- 4. **Diversification Logic:**
371
- - **IF** Frequency > 4.0 (Meta) OR Impression\_Share > 80% (Google):
372
- - **THEN:** Channel is saturated. Allocate next marginal dollar to a *new* platform (e.g., Scale to TikTok or Bing).
373
-
374
- ### 4.3 Cross-Platform Logic: MER & Incrementality
375
-
376
- **MER (Marketing Efficiency Ratio):**
377
-
378
- $$\text{MER} = \frac{\text{Total Revenue (All Channels)}}{\text{Total Ad Spend (All Channels)}}$$
379
-
380
- - **Methodology:** See formula above.
381
- - **2026 Standard:** Use MER as the "North Star" for total budget. Use Platform ROAS for day-to-day bidding.
382
- - **Threshold:** A healthy E-com MER is **3.0 - 5.0**.<sup>19</sup> If MER < 3.0, stop scaling.
383
-
384
- **Incrementality Testing (Geo-Lift):**
385
-
386
- - **Protocol:** Select a "Holdout" region (e.g., exclude California, representing ~10% of market). Run ads everywhere else.
387
- - **Duration:** Minimum **2--4 weeks**.<sup>20</sup>
388
- - **Analysis:** Compare organic sales lift in "Ad-On" regions vs. "Holdout" region.
389
-
390
- $$\text{Incremental ROAS} = \frac{\text{Revenue(Test)} - \text{Revenue(Control)}}{\text{Ad Spend}}$$
391
-
392
- - **Diminishing Returns Signal:** If doubling spend in "Test" region yields 0% lift over "Control," the channel has hit saturation.
393
-
394
- **Seasonal Adjustments:**
395
-
396
- - **Q4 (BFCM):** Plan for CPM increases of 30-50%. Reduce "ROAS Targets" by 20% to maintain volume against higher competition.
397
- - **Q1 (Jan):** Reset MER targets. "Correction" period where efficiency often improves as CPMs drop.<sup>21</sup>
398
-
399
- ---
400
-
401
- ## 5. SECTION 4: CONVERSION TRACKING SETUP REQUIREMENTS
402
-
403
- In 2026, client-side pixels are "lossy" (capturing ~60-70% of data). Server-side tracking is the primary source of truth.
404
-
405
- ### 5.1 Google Ads Infrastructure
406
-
407
- - **Minimum (Must Have):**
408
- - **Google Tag (gtag.js)**: Base installation.
409
- - **Enhanced Conversions**: Enabled in Google Ads > Settings. **Requirement:** Capture hashed Email (SHA256), Phone, or Address on form submit/checkout.<sup>22</sup>
410
- - **Consent Mode v2**: Mandatory for EEA. Must pass ad\_user\_data and ad\_personalization signals ("granted/denied").<sup>23</sup>
411
- - **Ideal (Should Have):**
412
- - **Server-Side GTM**: Google Ads Conversion Tag firing from a server container (stape.io or Google Cloud) to bypass ITP.
413
-
414
- ### 5.2 Meta Ads Infrastructure
415
-
416
- - **Minimum (Must Have):**
417
- - **Meta Pixel**: Client-side base code.
418
- - **Conversions API (CAPI)**: Server-to-server. Use partner integration (Shopify/WooCommerce) or CAPI Gateway.<sup>24</sup>
419
- - **Event Deduplication**: **Critical.** Must send unique event\_id in both Pixel and CAPI payloads. If event\_id matches, Meta discards the Pixel event and keeps the Server event.
420
- - **Ideal (Should Have):**
421
- - **Event Match Quality (EMQ)** score > 6.0/10. Pass extended user parameters: Email, Phone, IP Address, User Agent, fbp (Browser ID), fbc (Click ID).<sup>14</sup>
422
- - **Domain Verification**: Required for Aggregated Event Measurement.
423
-
424
- ### 5.3 TikTok Ads Infrastructure
425
-
426
- - **Minimum (Must Have):**
427
- - **TikTok Pixel**.
428
- - **Events API**: Server-side tracking.
429
- - **Ideal (Should Have):**
430
- - **Advanced Matching**: Pass hashed email/phone.
431
- - **ttclid**: Ensure this click ID parameter is captured in the URL, stored in a cookie, and passed back via API.<sup>26</sup>
432
-
433
- ### 5.4 LinkedIn Ads Infrastructure
434
-
435
- - **Minimum (Must Have):**
436
- - **Insight Tag**: Client-side.
437
- - **Conversions API**: Essential for 2026 B2B attribution.<sup>27</sup>
438
- - **Ideal (Should Have):**
439
- - **Offline Conversions**: Upload "Deal Created" and "Closed Won" stages from CRM (HubSpot/Salesforce) via API to optimize for revenue, not just leads.
440
-
441
- ### 5.5 Microsoft Ads Infrastructure
442
-
443
- - **Minimum (Must Have):**
444
- - **UET Tag**: Universal Event Tracking.
445
- - **Enhanced Conversions**: Check "Turn on Enhanced Conversions" in goal settings. Requires hashed email/phone.<sup>28</sup>
446
- - **Ideal (Should Have):**
447
- - **Offline Conversion Import**: For reconciling lead quality.
448
-
449
- ---
450
-
451
- ## 6. SECTION 5: ATTRIBUTION MODELS
452
-
453
- ### 6.1 Default Models (2026)
454
-
455
- - **Google: Data-Driven Attribution (DDA)**. This is the default. It uses machine learning to assign credit based on how each touchpoint changed the *probability* of conversion. It is mandatory for efficient Smart Bidding.<sup>30</sup>
456
- - **Meta: 7-day click, 1-day view**. This is the optimization window. Meta optimizes for users who convert within this timeframe.
457
-
458
- ### 6.2 Cross-Platform Logic (Handling Disagreements)
459
-
460
- Attribution disagreements are mathematically guaranteed because platforms claim credit based on *their* touchpoints, ignoring others.
461
-
462
- **Handling Logic:**
463
-
464
- 1. **Hierarchy of Truth:**
465
- - **Tier 1 (Ultimate Truth):** Backend/CRM Sales Data (Cash in bank).
466
- - **Tier 2 (Macro View):** MER (Total Revenue / Total Spend).
467
- - **Tier 3 (Optimization View):** Platform Data (Google/Meta Dashboards).
468
- 2. **Decision Rule:**
469
- - **IF** Google reports 10 sales AND Meta reports 10 sales BUT CRM reports 15 total sales:
470
- - **THEN**: 5 sales were multi-touch (User clicked both).
471
- - **Action**: Do NOT reduce budgets based on "double counting." Use **MER** (3.0-5.0 target) to validate total spend. Use **Platform ROAS** to optimize *intra-platform* bids (e.g., Move budget from Meta Ad Set A to B).
472
-
473
- ### 6.3 Lookback Windows
474
-
475
- - **View-Through:**
476
- - **Meta**: 1-day view (Standard).
477
- - **Google Display/YouTube**: 3-day view. (Standard is often 30, but 30-day view-through claims too much organic credit. Reduce to 3 days for accuracy).
478
- - **Click-Through:**
479
- - **High Impulse (E-com < $50):** 7-day click.
480
- - **High Consideration (B2B/SaaS > $500):** 30-day or 90-day click.
481
-
482
- ---
483
-
484
- ## 7. Worked Examples
485
-
486
- ### Scenario A: $5,000/mo Budget (E-commerce)
487
-
488
- - **Goal:** Maximize ROAS (Target 3.0+).
489
- - **Platform Split:** Meta ($3,500 - 70%), Google PMax ($1,500 - 30%).
490
- - **Google Strategy:**
491
- - **Campaign:** 1 PMax (Feed Only).
492
- - **Bidding:** Maximize Conversion Value (No Target initially).
493
- - **Asset:** Product Feed + Merchant Center.
494
- - **Meta Strategy:**
495
- - **Campaign:** 1 CBO Campaign ("Scaling").
496
- - **Ad Sets:** 3 Ad Sets (Broad, Interest Stack, Lookalike 1%).
497
- - **Bidding:** Lowest Cost (Highest Volume).
498
- - **Scaling:** Increase Meta budget by 20% if MER > 4.0.
499
-
500
- ### Scenario B: $20,000/mo Budget (B2B SaaS)
501
-
502
- - **Goal:** SQLs at < $150.
503
- - **Platform Split:** LinkedIn ($8,000), Google Search ($8,000), Meta Retargeting ($4,000).
504
- - **Google Strategy:**
505
- - **Campaigns:** Brand Search (Manual CPC), Non-Brand "High Intent" (tCPA).
506
- - **Bidding:** Portfolio Strategy on Non-Brand to cap Max CPC at $15. Target CPA set to $150.
507
- - **LinkedIn Strategy:**
508
- - **Format:** Sponsored Content (Single Image/Video).
509
- - **Bidding:** Manual Bidding (Cost Per Click). Start low ($8) and inch up.
510
- - **Meta Strategy:**
511
- - **Type:** Retargeting (Website Visitors 30D).
512
- - **Bidding:** Cost Cap set to $100 (Aggressive efficiency).
513
-
514
- ### Scenario C: $100,000/mo Budget (Omni-Channel Brand)
515
-
516
- - **Goal:** Market Share & MER 4.0.
517
- - **Platform Split:** Meta (40%), Google (30%), TikTok (10%), YouTube (10%), TV/Audio (10%).
518
- - **Strategy:**
519
- - **Measurement:** MER is the primary gauge.
520
- - **Incrementality:** Quarterly Geo-Lift tests (Holdout 10% of geos) to validate TikTok/YouTube lift.
521
- - **Bidding:** tROAS on Google/Meta (Portfolio strategies). Bid Caps on TikTok to manage volatility.
522
- - **Data Stack:** Server-Side GTM + CAPI Gateway + Data Warehouse (Snowflake) for custom attribution modeling.
523
-
524
- ---
525
-
526
- **Report End.**
527
-
528
- ---
529
-
530
- ## Works Cited
531
-
532
- 1. In Google Ads automation, everything is a signal in 2026 - Search Engine Land, accessed February 10, 2026, [https://searchengineland.com/in-google-ads-automation-everything-is-a-signal-in-2026-468218](https://searchengineland.com/in-google-ads-automation-everything-is-a-signal-in-2026-468218)
533
-
534
- 2. Smart Bidding Secrets for Google Ads in 2026 India, accessed February 10, 2026, [https://mountwebtech.com/smart-bidding-strategies-that-win-in-google-ads-2026/](https://mountwebtech.com/smart-bidding-strategies-that-win-in-google-ads-2026/)
535
-
536
- 3. Your guide to Smart Bidding - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/11095984?hl=en](https://support.google.com/google-ads/answer/11095984?hl=en)
537
-
538
- 4. Target CPA Bidding in Google Ads (2026) - Store Growers, accessed February 10, 2026, [https://www.storegrowers.com/target-cpa/](https://www.storegrowers.com/target-cpa/)
539
-
540
- 5. Automated vs Manual Bidding in Google Ads: 2026 Guide - YeezyPay Blog, accessed February 10, 2026, [https://yeezypay.io/blog/automated-vs-manual-bidding-in-google-ads-2026-gui](https://yeezypay.io/blog/automated-vs-manual-bidding-in-google-ads-2026-gui)
541
-
542
- 6. About Target ROAS bidding - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/6268637?hl=en](https://support.google.com/google-ads/answer/6268637?hl=en)
543
-
544
- 7. It's 2026, what's one piece of Google ads advice you'd give if you had 26 seconds to think of it? : r/googleads - Reddit, accessed February 10, 2026, [https://www.reddit.com/r/googleads/comments/1gaoyec/its_2026_whats_one_piece_of_google_ads_advice/](https://www.reddit.com/r/googleads/comments/1gaoyec/its_2026_whats_one_piece_of_google_ads_advice/)
545
-
546
- 8. About Target impression share bidding - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/9121108?hl=en](https://support.google.com/google-ads/answer/9121108?hl=en)
547
-
548
- 9. About Enhanced CPC (ECPC) - Google Ads Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/2464964?hl=en](https://support.google.com/google-ads/answer/2464964?hl=en)
549
-
550
- 10. Portfolio and Standard Bidding Strategies | Google Ads API, accessed February 10, 2026, [https://developers.google.com/google-ads/api/docs/campaigns/bidding/assign-strategies](https://developers.google.com/google-ads/api/docs/campaigns/bidding/assign-strategies)
551
-
552
- 11. Meta Ads Bidding Strategies 2026 | Maximize ROAS on Facebook & Instagram, accessed February 10, 2026, [https://spintadigital.com/blog/meta-ads-bidding-strategies-2026/](https://spintadigital.com/blog/meta-ads-bidding-strategies-2026/)
553
-
554
- 12. Conversion Count and First Conversion Optimization - Jon Loomer Digital, accessed February 10, 2026, [https://www.jonloomer.com/conversion-count-first-conversion-optimization/](https://www.jonloomer.com/conversion-count-first-conversion-optimization/)
555
-
556
- 13. I analyzed advertisers spending £45/day to $45K/month - here's when CBO vs ABO actually wins : r/FacebookAds - Reddit, accessed February 10, 2026, [https://www.reddit.com/r/FacebookAds/comments/1qhska5/i_analyzed_advertisers_spending_45day_to_45kmonth/](https://www.reddit.com/r/FacebookAds/comments/1qhska5/i_analyzed_advertisers_spending_45day_to_45kmonth/)
557
-
558
- 14. Meta Ads Checklist 2026 - Setup the Conversions API - PixelFlow, accessed February 10, 2026, [https://pixelflow.so/blog/meta-ads-checklist-2026](https://pixelflow.so/blog/meta-ads-checklist-2026)
559
-
560
- 15. B2B Marketing Budget Benchmarks for 2026 Planning - SpotOn Digital Media, accessed February 10, 2026, [https://www.spotondigitalmedia.com/blog/b2b-marketing-budget-benchmarks-for-2026-planning](https://www.spotondigitalmedia.com/blog/b2b-marketing-budget-benchmarks-for-2026-planning)
561
-
562
- 16. How to Allocate Your SaaS Marketing Budget for 2026 - Aimers Blog, accessed February 10, 2026, [https://aimers.io/blog/how-to-allocate-your-saas-marketing-budget](https://aimers.io/blog/how-to-allocate-your-saas-marketing-budget)
563
-
564
- 17. The 2026 Blueprint for Scalable B2B SaaS Marketing - Directive Consulting, accessed February 10, 2026, [https://directiveconsulting.com/blog/blog-b2b-saas-marketing-guide-2026/](https://directiveconsulting.com/blog/blog-b2b-saas-marketing-guide-2026/)
565
-
566
- 18. SaaS Marketing Budget & Allocation Guide (2026) - Roketto, accessed February 10, 2026, [https://www.helloroketto.com/articles/saas-marketing-budget](https://www.helloroketto.com/articles/saas-marketing-budget)
567
-
568
- 19. What is a good marketing efficiency ratio (MER)? - Keen Decision Systems, accessed February 10, 2026, [https://keends.com/blog/marketing-efficiency-ratio/](https://keends.com/blog/marketing-efficiency-ratio/)
569
-
570
- 20. What is Incrementality Testing? A Comprehensive Guide | Z2A Digital, accessed February 10, 2026, [https://www.z2adigital.com/blog-content/incrementality-testing-guide](https://www.z2adigital.com/blog-content/incrementality-testing-guide)
571
-
572
- 21. Marketing Efficiency Ratio (MER): Definition, Benchmarks, and How it Differs from ROAS, accessed February 10, 2026, [https://www.northbeam.io/blog/marketing-efficiency-ratio-mer-roas](https://www.northbeam.io/blog/marketing-efficiency-ratio-mer-roas)
573
-
574
- 22. Set up enhanced conversions for web using the Google tag, accessed February 10, 2026, [https://support.google.com/google-ads/answer/13258081?hl=en](https://support.google.com/google-ads/answer/13258081?hl=en)
575
-
576
- 23. How to set up Enhanced Conversions for Google Ads and GA4 - Stape, accessed February 10, 2026, [https://stape.io/blog/ga4-and-google-ads-enhanced-conversions-tracking-setup-guide](https://stape.io/blog/ga4-and-google-ads-enhanced-conversions-tracking-setup-guide)
577
-
578
- 24. Meta Conversions API Extension Overview | Adobe Data Collection - Experience League, accessed February 10, 2026, [https://experienceleague.adobe.com/en/docs/experience-platform/tags/extensions/server/meta/overview](https://experienceleague.adobe.com/en/docs/experience-platform/tags/extensions/server/meta/overview)
579
-
580
- 25. Conversion API Setup Guide: Track Ads Accurately 2026 - Cometly, accessed February 10, 2026, [https://www.cometly.com/post/conversion-api-setup-guide](https://www.cometly.com/post/conversion-api-setup-guide)
581
-
582
- 26. TikTok Events API -- a complete install guide for Shopify stores [2026] - OmegaTheme, accessed February 10, 2026, [https://www.omegatheme.com/blogs/set-up-tiktok-pixels-to-track-events-with-events-api-server-side-tracking-for-tiktok-ads](https://www.omegatheme.com/blogs/set-up-tiktok-pixels-to-track-events-with-events-api-server-side-tracking-for-tiktok-ads)
583
-
584
- 27. How to set up the LinkedIn Conversions API? - Hightouch, accessed February 10, 2026, [https://hightouch.com/blog/how-to-set-up-linkedin-conversions-api](https://hightouch.com/blog/how-to-set-up-linkedin-conversions-api)
585
-
586
- 28. Set up UET tags using Google Tag Manager - Microsoft Advertising Help Center, accessed February 10, 2026, [https://help.ads.microsoft.com/apex/index/3/en/56894](https://help.ads.microsoft.com/apex/index/3/en/56894)
587
-
588
- 29. Enhanced conversions and other updates for February - Microsoft Advertising, accessed February 10, 2026, [https://about.ads.microsoft.com/en/blog/post/february-2024/enhanced-conversions-and-other-updates-for-february](https://about.ads.microsoft.com/en/blog/post/february-2024/enhanced-conversions-and-other-updates-for-february)
589
-
590
- 30. GA4 vs Attribuly: Best Multi-Touch Models for Shopify (2026), accessed February 10, 2026, [https://attribuly.com/blogs/ga4-vs-attribuly-multi-touch-attribution-shopify-2026/](https://attribuly.com/blogs/ga4-vs-attribuly-multi-touch-attribution-shopify-2026/)