agileflow 3.4.2 → 4.0.0-alpha.1

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 (766) hide show
  1. package/CHANGELOG.md +235 -494
  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/session-welcome.js +19 -0
  13. package/content/plugins/core/plugin.yaml +34 -0
  14. package/content/plugins/core/skills/agileflow-adr/SKILL.md +179 -0
  15. package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +144 -0
  16. package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +179 -0
  17. package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +132 -0
  18. package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +200 -0
  19. package/content/plugins/council/plugin.yaml +14 -0
  20. package/content/plugins/seo/plugin.yaml +14 -0
  21. package/package.json +29 -49
  22. package/src/cli/commands/doctor.js +159 -0
  23. package/src/cli/commands/hook.js +80 -0
  24. package/src/cli/commands/setup.js +254 -0
  25. package/src/cli/commands/status.js +47 -0
  26. package/src/cli/commands/update.js +82 -0
  27. package/src/cli/index.js +73 -0
  28. package/src/cli/wizard/ide-picker.js +57 -0
  29. package/src/cli/wizard/personalization.js +64 -0
  30. package/src/cli/wizard/plugin-picker.js +106 -0
  31. package/src/lib/hash.js +41 -0
  32. package/src/runtime/config/defaults.js +45 -0
  33. package/src/runtime/config/loader.js +118 -0
  34. package/src/runtime/config/schema.json +76 -0
  35. package/src/runtime/config/writer.js +54 -0
  36. package/src/runtime/hooks/aggregator.js +133 -0
  37. package/src/runtime/hooks/chain.js +93 -0
  38. package/src/runtime/hooks/logger.js +68 -0
  39. package/src/runtime/hooks/manifest-loader.js +228 -0
  40. package/src/runtime/hooks/orchestrator.js +322 -0
  41. package/src/runtime/ide/capabilities.js +111 -0
  42. package/src/runtime/ide/claude-code-settings.js +234 -0
  43. package/src/runtime/ide/claude-code-skills.js +202 -0
  44. package/src/runtime/installer/file-index.js +112 -0
  45. package/src/runtime/installer/install.js +306 -0
  46. package/src/runtime/installer/stash.js +61 -0
  47. package/src/runtime/installer/sync-engine.js +205 -0
  48. package/src/runtime/plugins/registry.js +132 -0
  49. package/src/runtime/plugins/resolver.js +138 -0
  50. package/src/runtime/plugins/validator.js +196 -0
  51. package/src/runtime/skills/validator.js +335 -0
  52. package/lib/README.md +0 -178
  53. package/lib/api-routes.js +0 -625
  54. package/lib/api-server.js +0 -278
  55. package/lib/cache-provider.js +0 -155
  56. package/lib/claude-cli-bridge.js +0 -215
  57. package/lib/codebase-indexer.js +0 -819
  58. package/lib/colors.generated.js +0 -117
  59. package/lib/colors.js +0 -341
  60. package/lib/consent.js +0 -232
  61. package/lib/content-sanitizer.js +0 -464
  62. package/lib/correlation.js +0 -277
  63. package/lib/dashboard-automations.js +0 -130
  64. package/lib/dashboard-git.js +0 -254
  65. package/lib/dashboard-inbox.js +0 -64
  66. package/lib/dashboard-protocol.js +0 -605
  67. package/lib/dashboard-server.js +0 -1296
  68. package/lib/dashboard-session.js +0 -136
  69. package/lib/dashboard-status.js +0 -72
  70. package/lib/dashboard-terminal.js +0 -354
  71. package/lib/dashboard-websocket.js +0 -88
  72. package/lib/drivers/claude-driver.ts +0 -312
  73. package/lib/drivers/codex-driver.ts +0 -464
  74. package/lib/drivers/driver-manager.ts +0 -159
  75. package/lib/drivers/gemini-driver.ts +0 -498
  76. package/lib/drivers/index.ts +0 -17
  77. package/lib/error-codes.js +0 -590
  78. package/lib/errors.js +0 -670
  79. package/lib/feature-flags.js +0 -171
  80. package/lib/feedback.js +0 -595
  81. package/lib/file-cache.js +0 -541
  82. package/lib/flag-detection.js +0 -344
  83. package/lib/format-error.js +0 -156
  84. package/lib/gate-runner.js +0 -282
  85. package/lib/generator-factory.js +0 -333
  86. package/lib/git-operations.js +0 -266
  87. package/lib/lazy-require.js +0 -59
  88. package/lib/lock-file.js +0 -144
  89. package/lib/logger.js +0 -106
  90. package/lib/merge-operations.js +0 -1006
  91. package/lib/path-resolver.js +0 -544
  92. package/lib/path-utils.js +0 -49
  93. package/lib/paths.js +0 -291
  94. package/lib/placeholder-registry.js +0 -822
  95. package/lib/process-executor.js +0 -214
  96. package/lib/progress.js +0 -334
  97. package/lib/protocol/driver.ts +0 -354
  98. package/lib/protocol/index.ts +0 -12
  99. package/lib/protocol/ir.ts +0 -271
  100. package/lib/registry-cache.js +0 -80
  101. package/lib/registry-di.js +0 -358
  102. package/lib/result-schema.js +0 -363
  103. package/lib/result.js +0 -210
  104. package/lib/session-display.js +0 -331
  105. package/lib/session-operations.js +0 -611
  106. package/lib/session-registry.js +0 -484
  107. package/lib/session-state-machine.js +0 -465
  108. package/lib/session-switching.js +0 -191
  109. package/lib/skill-loader.js +0 -213
  110. package/lib/smart-json-file.js +0 -682
  111. package/lib/state-machine.js +0 -286
  112. package/lib/table-formatter.js +0 -519
  113. package/lib/template-loader.js +0 -143
  114. package/lib/transient-status.js +0 -374
  115. package/lib/ui-manager.js +0 -612
  116. package/lib/validate-args.js +0 -213
  117. package/lib/validate-commands.js +0 -308
  118. package/lib/validate-names.js +0 -143
  119. package/lib/validate-paths.js +0 -434
  120. package/lib/validate.js +0 -134
  121. package/lib/worktree-operations.js +0 -201
  122. package/lib/yaml-utils.js +0 -164
  123. package/scripts/README.md +0 -267
  124. package/scripts/af +0 -34
  125. package/scripts/agent-loop.js +0 -819
  126. package/scripts/agileflow-configure.js +0 -368
  127. package/scripts/agileflow-statusline.sh +0 -857
  128. package/scripts/agileflow-welcome.js +0 -2246
  129. package/scripts/api-server-runner.js +0 -177
  130. package/scripts/archive-completed-stories.sh +0 -308
  131. package/scripts/auto-self-improve.js +0 -326
  132. package/scripts/automation-run-due.js +0 -128
  133. package/scripts/babysit-clear-restore.js +0 -154
  134. package/scripts/babysit-context-restore.js +0 -89
  135. package/scripts/backfill-ideation-status.js +0 -128
  136. package/scripts/batch-pmap-loop.js +0 -551
  137. package/scripts/check-update.js +0 -282
  138. package/scripts/ci-summary.js +0 -294
  139. package/scripts/claude-smart.sh +0 -85
  140. package/scripts/claude-tmux.sh +0 -737
  141. package/scripts/claude-watchdog.sh +0 -225
  142. package/scripts/clear-active-command.js +0 -48
  143. package/scripts/compress-status.sh +0 -116
  144. package/scripts/context-loader.js +0 -310
  145. package/scripts/damage-control/bash-tool-damage-control.js +0 -22
  146. package/scripts/damage-control/edit-tool-damage-control.js +0 -19
  147. package/scripts/damage-control/patterns.yaml +0 -227
  148. package/scripts/damage-control/write-tool-damage-control.js +0 -19
  149. package/scripts/damage-control-bash.js +0 -51
  150. package/scripts/damage-control-edit.js +0 -48
  151. package/scripts/damage-control-multi-agent.js +0 -231
  152. package/scripts/damage-control-write.js +0 -48
  153. package/scripts/dashboard-serve.js +0 -336
  154. package/scripts/dependency-check.js +0 -311
  155. package/scripts/document-repl.js +0 -793
  156. package/scripts/expertise-metrics.sh +0 -264
  157. package/scripts/generate-all.sh +0 -77
  158. package/scripts/generate-colors.js +0 -314
  159. package/scripts/generators/agent-registry.js +0 -183
  160. package/scripts/generators/command-registry.js +0 -166
  161. package/scripts/generators/index.js +0 -85
  162. package/scripts/generators/inject-babysit.js +0 -191
  163. package/scripts/generators/inject-help.js +0 -125
  164. package/scripts/generators/inject-readme.js +0 -166
  165. package/scripts/generators/skill-registry.js +0 -188
  166. package/scripts/get-env.js +0 -225
  167. package/scripts/init.sh +0 -76
  168. package/scripts/lib/README-portable-tasks.md +0 -424
  169. package/scripts/lib/ac-test-matcher.js +0 -452
  170. package/scripts/lib/audit-cleanup.js +0 -250
  171. package/scripts/lib/audit-registry.js +0 -340
  172. package/scripts/lib/automation-registry.js +0 -544
  173. package/scripts/lib/automation-runner.js +0 -476
  174. package/scripts/lib/browser-qa-evidence.js +0 -409
  175. package/scripts/lib/browser-qa-status.js +0 -192
  176. package/scripts/lib/bus-utils.js +0 -473
  177. package/scripts/lib/colors.generated.sh +0 -82
  178. package/scripts/lib/colors.sh +0 -46
  179. package/scripts/lib/command-prereqs.js +0 -280
  180. package/scripts/lib/concurrency-limiter.js +0 -511
  181. package/scripts/lib/configure-detect.js +0 -596
  182. package/scripts/lib/configure-features.js +0 -1927
  183. package/scripts/lib/configure-repair.js +0 -327
  184. package/scripts/lib/configure-utils.js +0 -114
  185. package/scripts/lib/context-formatter.js +0 -1158
  186. package/scripts/lib/context-loader.js +0 -840
  187. package/scripts/lib/counter.js +0 -103
  188. package/scripts/lib/damage-control-utils.js +0 -619
  189. package/scripts/lib/feature-catalog.js +0 -332
  190. package/scripts/lib/file-lock.js +0 -392
  191. package/scripts/lib/file-tracking.js +0 -735
  192. package/scripts/lib/frontmatter-parser.js +0 -133
  193. package/scripts/lib/gate-enforcer.js +0 -295
  194. package/scripts/lib/hook-metrics.js +0 -324
  195. package/scripts/lib/ideation-index.js +0 -1205
  196. package/scripts/lib/json-utils.sh +0 -162
  197. package/scripts/lib/lifecycle-detector.js +0 -125
  198. package/scripts/lib/model-profiles.js +0 -118
  199. package/scripts/lib/portable-tasks-cli.js +0 -274
  200. package/scripts/lib/portable-tasks.js +0 -479
  201. package/scripts/lib/process-cleanup.js +0 -527
  202. package/scripts/lib/quality-gates.js +0 -761
  203. package/scripts/lib/scale-detector.js +0 -396
  204. package/scripts/lib/sessionRegistry.js +0 -678
  205. package/scripts/lib/signal-detectors.js +0 -880
  206. package/scripts/lib/skill-catalog.js +0 -557
  207. package/scripts/lib/skill-recommender.js +0 -311
  208. package/scripts/lib/state-migrator.js +0 -353
  209. package/scripts/lib/status-task-bridge.js +0 -522
  210. package/scripts/lib/status-writer.js +0 -255
  211. package/scripts/lib/story-claiming.js +0 -704
  212. package/scripts/lib/story-state-machine.js +0 -437
  213. package/scripts/lib/sync-ideation-status.js +0 -291
  214. package/scripts/lib/task-registry-cache.js +0 -490
  215. package/scripts/lib/task-registry.js +0 -1191
  216. package/scripts/lib/task-sync.js +0 -230
  217. package/scripts/lib/tdd-phase-manager.js +0 -455
  218. package/scripts/lib/team-events.js +0 -510
  219. package/scripts/lib/tmux-audit-monitor.js +0 -611
  220. package/scripts/lib/tmux-group-colors.js +0 -113
  221. package/scripts/lib/tool-registry.yaml +0 -241
  222. package/scripts/lib/tool-shed.js +0 -441
  223. package/scripts/lib/validation-registry.js +0 -177
  224. package/scripts/messaging-bridge.js +0 -561
  225. package/scripts/migrate-ideation-index.js +0 -553
  226. package/scripts/native-team-observer.js +0 -219
  227. package/scripts/obtain-context.js +0 -272
  228. package/scripts/pre-push-check.sh +0 -46
  229. package/scripts/precompact-context.sh +0 -306
  230. package/scripts/query-codebase.js +0 -543
  231. package/scripts/ralph-loop.js +0 -1278
  232. package/scripts/resume-session.sh +0 -121
  233. package/scripts/screenshot-verifier.js +0 -215
  234. package/scripts/session-boundary.js +0 -138
  235. package/scripts/session-coordinator.sh +0 -232
  236. package/scripts/session-manager.js +0 -546
  237. package/scripts/smart-detect.js +0 -449
  238. package/scripts/spawn-audit-sessions.js +0 -877
  239. package/scripts/spawn-parallel.js +0 -751
  240. package/scripts/strip-ai-attribution.js +0 -63
  241. package/scripts/task-completed-gate.js +0 -237
  242. package/scripts/team-manager.js +0 -596
  243. package/scripts/team-status-display.js +0 -200
  244. package/scripts/teammate-idle-gate.js +0 -237
  245. package/scripts/test-session-boundary.js +0 -80
  246. package/scripts/tmux-close-windows.sh +0 -180
  247. package/scripts/tmux-restore-window.sh +0 -67
  248. package/scripts/tmux-save-closed-window.sh +0 -35
  249. package/scripts/tui/App.js +0 -151
  250. package/scripts/tui/Dashboard.js +0 -277
  251. package/scripts/tui/blessed/data/watcher.js +0 -180
  252. package/scripts/tui/blessed/index.js +0 -244
  253. package/scripts/tui/blessed/panels/output.js +0 -101
  254. package/scripts/tui/blessed/panels/sessions.js +0 -150
  255. package/scripts/tui/blessed/panels/trace.js +0 -97
  256. package/scripts/tui/blessed/ui/help.js +0 -77
  257. package/scripts/tui/blessed/ui/screen.js +0 -52
  258. package/scripts/tui/blessed/ui/statusbar.js +0 -47
  259. package/scripts/tui/blessed/ui/tabbar.js +0 -99
  260. package/scripts/tui/index.js +0 -70
  261. package/scripts/tui/lib/crashRecovery.js +0 -304
  262. package/scripts/tui/lib/eventStream.js +0 -309
  263. package/scripts/tui/lib/keyboard.js +0 -261
  264. package/scripts/tui/lib/loopControl.js +0 -371
  265. package/scripts/tui/panels/OutputPanel.js +0 -240
  266. package/scripts/tui/panels/SessionPanel.js +0 -170
  267. package/scripts/tui/panels/TracePanel.js +0 -298
  268. package/scripts/tui/simple-tui.js +0 -510
  269. package/scripts/validate-expertise.sh +0 -263
  270. package/scripts/validate-tokens.sh +0 -73
  271. package/scripts/validators/README.md +0 -143
  272. package/scripts/validators/component-validator.js +0 -239
  273. package/scripts/validators/json-schema-validator.js +0 -186
  274. package/scripts/validators/markdown-validator.js +0 -152
  275. package/scripts/validators/migration-validator.js +0 -129
  276. package/scripts/validators/security-validator.js +0 -380
  277. package/scripts/validators/story-format-validator.js +0 -197
  278. package/scripts/validators/test-result-validator.js +0 -114
  279. package/scripts/validators/workflow-validator.js +0 -247
  280. package/scripts/welcome-deferred.js +0 -437
  281. package/scripts/worktree-create.sh +0 -111
  282. package/src/core/agents/a11y-analyzer-aria.md +0 -155
  283. package/src/core/agents/a11y-analyzer-forms.md +0 -162
  284. package/src/core/agents/a11y-analyzer-keyboard.md +0 -175
  285. package/src/core/agents/a11y-analyzer-semantic.md +0 -153
  286. package/src/core/agents/a11y-analyzer-visual.md +0 -158
  287. package/src/core/agents/a11y-consensus.md +0 -248
  288. package/src/core/agents/accessibility.md +0 -515
  289. package/src/core/agents/adr-writer.md +0 -463
  290. package/src/core/agents/ads-audit-budget.md +0 -181
  291. package/src/core/agents/ads-audit-compliance.md +0 -169
  292. package/src/core/agents/ads-audit-creative.md +0 -164
  293. package/src/core/agents/ads-audit-google.md +0 -226
  294. package/src/core/agents/ads-audit-meta.md +0 -183
  295. package/src/core/agents/ads-audit-tracking.md +0 -197
  296. package/src/core/agents/ads-consensus.md +0 -396
  297. package/src/core/agents/ads-generate.md +0 -145
  298. package/src/core/agents/ads-performance-tracker.md +0 -197
  299. package/src/core/agents/analytics.md +0 -617
  300. package/src/core/agents/api-quality-analyzer-conventions.md +0 -148
  301. package/src/core/agents/api-quality-analyzer-docs.md +0 -176
  302. package/src/core/agents/api-quality-analyzer-errors.md +0 -183
  303. package/src/core/agents/api-quality-analyzer-pagination.md +0 -171
  304. package/src/core/agents/api-quality-analyzer-versioning.md +0 -143
  305. package/src/core/agents/api-quality-consensus.md +0 -214
  306. package/src/core/agents/api-validator.md +0 -183
  307. package/src/core/agents/api.md +0 -665
  308. package/src/core/agents/arch-analyzer-circular.md +0 -148
  309. package/src/core/agents/arch-analyzer-complexity.md +0 -171
  310. package/src/core/agents/arch-analyzer-coupling.md +0 -146
  311. package/src/core/agents/arch-analyzer-layering.md +0 -151
  312. package/src/core/agents/arch-analyzer-patterns.md +0 -162
  313. package/src/core/agents/arch-consensus.md +0 -227
  314. package/src/core/agents/brainstorm-analyzer-features.md +0 -169
  315. package/src/core/agents/brainstorm-analyzer-growth.md +0 -161
  316. package/src/core/agents/brainstorm-analyzer-integration.md +0 -172
  317. package/src/core/agents/brainstorm-analyzer-market.md +0 -147
  318. package/src/core/agents/brainstorm-analyzer-ux.md +0 -167
  319. package/src/core/agents/brainstorm-consensus.md +0 -237
  320. package/src/core/agents/browser-qa.md +0 -328
  321. package/src/core/agents/ci.md +0 -511
  322. package/src/core/agents/code-reviewer.md +0 -288
  323. package/src/core/agents/codebase-query.md +0 -266
  324. package/src/core/agents/completeness-analyzer-api.md +0 -190
  325. package/src/core/agents/completeness-analyzer-conditional.md +0 -201
  326. package/src/core/agents/completeness-analyzer-handlers.md +0 -159
  327. package/src/core/agents/completeness-analyzer-imports.md +0 -159
  328. package/src/core/agents/completeness-analyzer-routes.md +0 -182
  329. package/src/core/agents/completeness-analyzer-state.md +0 -188
  330. package/src/core/agents/completeness-analyzer-stubs.md +0 -198
  331. package/src/core/agents/completeness-consensus.md +0 -286
  332. package/src/core/agents/compliance.md +0 -509
  333. package/src/core/agents/council-advocate.md +0 -206
  334. package/src/core/agents/council-analyst.md +0 -252
  335. package/src/core/agents/council-optimist.md +0 -170
  336. package/src/core/agents/database.md +0 -601
  337. package/src/core/agents/datamigration.md +0 -699
  338. package/src/core/agents/design.md +0 -525
  339. package/src/core/agents/devops.md +0 -720
  340. package/src/core/agents/documentation.md +0 -504
  341. package/src/core/agents/epic-planner.md +0 -480
  342. package/src/core/agents/error-analyzer.md +0 -201
  343. package/src/core/agents/integrations.md +0 -603
  344. package/src/core/agents/legal-analyzer-a11y.md +0 -110
  345. package/src/core/agents/legal-analyzer-ai.md +0 -117
  346. package/src/core/agents/legal-analyzer-consumer.md +0 -108
  347. package/src/core/agents/legal-analyzer-content.md +0 -113
  348. package/src/core/agents/legal-analyzer-international.md +0 -115
  349. package/src/core/agents/legal-analyzer-licensing.md +0 -115
  350. package/src/core/agents/legal-analyzer-privacy.md +0 -108
  351. package/src/core/agents/legal-analyzer-security.md +0 -112
  352. package/src/core/agents/legal-analyzer-terms.md +0 -111
  353. package/src/core/agents/legal-consensus.md +0 -242
  354. package/src/core/agents/logic-analyzer-edge.md +0 -170
  355. package/src/core/agents/logic-analyzer-flow.md +0 -253
  356. package/src/core/agents/logic-analyzer-invariant.md +0 -206
  357. package/src/core/agents/logic-analyzer-race.md +0 -266
  358. package/src/core/agents/logic-analyzer-type.md +0 -217
  359. package/src/core/agents/logic-consensus.md +0 -253
  360. package/src/core/agents/mentor.md +0 -654
  361. package/src/core/agents/mobile.md +0 -501
  362. package/src/core/agents/monitoring.md +0 -537
  363. package/src/core/agents/multi-expert.md +0 -311
  364. package/src/core/agents/orchestrator.md +0 -749
  365. package/src/core/agents/perf-analyzer-assets.md +0 -174
  366. package/src/core/agents/perf-analyzer-bundle.md +0 -165
  367. package/src/core/agents/perf-analyzer-caching.md +0 -160
  368. package/src/core/agents/perf-analyzer-compute.md +0 -165
  369. package/src/core/agents/perf-analyzer-memory.md +0 -182
  370. package/src/core/agents/perf-analyzer-network.md +0 -157
  371. package/src/core/agents/perf-analyzer-queries.md +0 -155
  372. package/src/core/agents/perf-analyzer-rendering.md +0 -156
  373. package/src/core/agents/perf-consensus.md +0 -280
  374. package/src/core/agents/performance.md +0 -492
  375. package/src/core/agents/product.md +0 -535
  376. package/src/core/agents/qa.md +0 -765
  377. package/src/core/agents/readme-updater.md +0 -579
  378. package/src/core/agents/refactor.md +0 -558
  379. package/src/core/agents/research.md +0 -453
  380. package/src/core/agents/rlm-subcore.md +0 -207
  381. package/src/core/agents/schema-validator.md +0 -454
  382. package/src/core/agents/security-analyzer-api.md +0 -199
  383. package/src/core/agents/security-analyzer-auth.md +0 -160
  384. package/src/core/agents/security-analyzer-authz.md +0 -168
  385. package/src/core/agents/security-analyzer-deps.md +0 -147
  386. package/src/core/agents/security-analyzer-infra.md +0 -176
  387. package/src/core/agents/security-analyzer-injection.md +0 -148
  388. package/src/core/agents/security-analyzer-input.md +0 -191
  389. package/src/core/agents/security-analyzer-secrets.md +0 -175
  390. package/src/core/agents/security-consensus.md +0 -276
  391. package/src/core/agents/security.md +0 -486
  392. package/src/core/agents/seo-analyzer-content.md +0 -167
  393. package/src/core/agents/seo-analyzer-images.md +0 -187
  394. package/src/core/agents/seo-analyzer-performance.md +0 -206
  395. package/src/core/agents/seo-analyzer-schema.md +0 -176
  396. package/src/core/agents/seo-analyzer-sitemap.md +0 -172
  397. package/src/core/agents/seo-analyzer-technical.md +0 -144
  398. package/src/core/agents/seo-consensus.md +0 -289
  399. package/src/core/agents/team-coordinator.md +0 -333
  400. package/src/core/agents/team-lead.md +0 -171
  401. package/src/core/agents/test-analyzer-assertions.md +0 -181
  402. package/src/core/agents/test-analyzer-coverage.md +0 -183
  403. package/src/core/agents/test-analyzer-fragility.md +0 -185
  404. package/src/core/agents/test-analyzer-integration.md +0 -155
  405. package/src/core/agents/test-analyzer-maintenance.md +0 -173
  406. package/src/core/agents/test-analyzer-mocking.md +0 -178
  407. package/src/core/agents/test-analyzer-patterns.md +0 -189
  408. package/src/core/agents/test-analyzer-structure.md +0 -177
  409. package/src/core/agents/test-consensus.md +0 -294
  410. package/src/core/agents/testing.md +0 -527
  411. package/src/core/agents/ui-validator.md +0 -331
  412. package/src/core/agents/ui.md +0 -1227
  413. package/src/core/commands/adr/list.md +0 -191
  414. package/src/core/commands/adr/update.md +0 -258
  415. package/src/core/commands/adr/view.md +0 -274
  416. package/src/core/commands/adr.md +0 -394
  417. package/src/core/commands/ads/audit.md +0 -437
  418. package/src/core/commands/ads/budget.md +0 -97
  419. package/src/core/commands/ads/competitor.md +0 -112
  420. package/src/core/commands/ads/creative.md +0 -85
  421. package/src/core/commands/ads/generate.md +0 -238
  422. package/src/core/commands/ads/google.md +0 -112
  423. package/src/core/commands/ads/health.md +0 -327
  424. package/src/core/commands/ads/landing.md +0 -119
  425. package/src/core/commands/ads/linkedin.md +0 -112
  426. package/src/core/commands/ads/meta.md +0 -91
  427. package/src/core/commands/ads/microsoft.md +0 -115
  428. package/src/core/commands/ads/plan.md +0 -321
  429. package/src/core/commands/ads/test-plan.md +0 -317
  430. package/src/core/commands/ads/tiktok.md +0 -129
  431. package/src/core/commands/ads/track.md +0 -288
  432. package/src/core/commands/ads/youtube.md +0 -124
  433. package/src/core/commands/ads.md +0 -140
  434. package/src/core/commands/agent.md +0 -256
  435. package/src/core/commands/api.md +0 -267
  436. package/src/core/commands/assign.md +0 -369
  437. package/src/core/commands/audit.md +0 -531
  438. package/src/core/commands/auto.md +0 -556
  439. package/src/core/commands/automate.md +0 -415
  440. package/src/core/commands/babysit.md +0 -643
  441. package/src/core/commands/baseline.md +0 -743
  442. package/src/core/commands/batch.md +0 -551
  443. package/src/core/commands/blockers.md +0 -602
  444. package/src/core/commands/board.md +0 -509
  445. package/src/core/commands/browser-qa.md +0 -240
  446. package/src/core/commands/changelog.md +0 -582
  447. package/src/core/commands/choose.md +0 -430
  448. package/src/core/commands/ci.md +0 -330
  449. package/src/core/commands/code/accessibility.md +0 -347
  450. package/src/core/commands/code/api.md +0 -297
  451. package/src/core/commands/code/architecture.md +0 -297
  452. package/src/core/commands/code/completeness.md +0 -503
  453. package/src/core/commands/code/legal.md +0 -493
  454. package/src/core/commands/code/logic.md +0 -416
  455. package/src/core/commands/code/performance.md +0 -490
  456. package/src/core/commands/code/security.md +0 -493
  457. package/src/core/commands/code/test.md +0 -489
  458. package/src/core/commands/compress.md +0 -408
  459. package/src/core/commands/configure.md +0 -1159
  460. package/src/core/commands/context/export.md +0 -296
  461. package/src/core/commands/context/full.md +0 -353
  462. package/src/core/commands/context/note.md +0 -380
  463. package/src/core/commands/council.md +0 -592
  464. package/src/core/commands/debt.md +0 -491
  465. package/src/core/commands/deploy.md +0 -864
  466. package/src/core/commands/deps.md +0 -728
  467. package/src/core/commands/diagnose.md +0 -404
  468. package/src/core/commands/docs.md +0 -469
  469. package/src/core/commands/epic/edit.md +0 -213
  470. package/src/core/commands/epic/list.md +0 -190
  471. package/src/core/commands/epic/view.md +0 -267
  472. package/src/core/commands/epic.md +0 -477
  473. package/src/core/commands/export.md +0 -238
  474. package/src/core/commands/feedback.md +0 -603
  475. package/src/core/commands/handoff.md +0 -386
  476. package/src/core/commands/help.md +0 -194
  477. package/src/core/commands/ideate/brief.md +0 -363
  478. package/src/core/commands/ideate/discover.md +0 -399
  479. package/src/core/commands/ideate/features.md +0 -496
  480. package/src/core/commands/ideate/history.md +0 -403
  481. package/src/core/commands/ideate/new.md +0 -899
  482. package/src/core/commands/impact.md +0 -407
  483. package/src/core/commands/install.md +0 -529
  484. package/src/core/commands/learn/explain.md +0 -118
  485. package/src/core/commands/learn/glossary.md +0 -135
  486. package/src/core/commands/learn/patterns.md +0 -138
  487. package/src/core/commands/learn/tour.md +0 -126
  488. package/src/core/commands/maintain.md +0 -558
  489. package/src/core/commands/metrics.md +0 -844
  490. package/src/core/commands/migrate/codemods.md +0 -151
  491. package/src/core/commands/migrate/plan.md +0 -131
  492. package/src/core/commands/migrate/scan.md +0 -114
  493. package/src/core/commands/migrate/validate.md +0 -119
  494. package/src/core/commands/multi-expert.md +0 -447
  495. package/src/core/commands/packages.md +0 -535
  496. package/src/core/commands/pr.md +0 -337
  497. package/src/core/commands/readme-sync.md +0 -329
  498. package/src/core/commands/research/analyze.md +0 -798
  499. package/src/core/commands/research/ask.md +0 -864
  500. package/src/core/commands/research/import.md +0 -1025
  501. package/src/core/commands/research/list.md +0 -273
  502. package/src/core/commands/research/synthesize.md +0 -928
  503. package/src/core/commands/research/view.md +0 -323
  504. package/src/core/commands/retro.md +0 -795
  505. package/src/core/commands/review.md +0 -694
  506. package/src/core/commands/rlm.md +0 -446
  507. package/src/core/commands/roadmap/analyze.md +0 -400
  508. package/src/core/commands/rpi.md +0 -633
  509. package/src/core/commands/seo/audit.md +0 -428
  510. package/src/core/commands/seo/competitor.md +0 -174
  511. package/src/core/commands/seo/content.md +0 -107
  512. package/src/core/commands/seo/geo.md +0 -229
  513. package/src/core/commands/seo/hreflang.md +0 -140
  514. package/src/core/commands/seo/images.md +0 -96
  515. package/src/core/commands/seo/page.md +0 -198
  516. package/src/core/commands/seo/plan.md +0 -163
  517. package/src/core/commands/seo/programmatic.md +0 -131
  518. package/src/core/commands/seo/references/cwv-thresholds.md +0 -64
  519. package/src/core/commands/seo/references/eeat-framework.md +0 -110
  520. package/src/core/commands/seo/references/quality-gates.md +0 -91
  521. package/src/core/commands/seo/references/schema-types.md +0 -102
  522. package/src/core/commands/seo/schema.md +0 -183
  523. package/src/core/commands/seo/sitemap.md +0 -97
  524. package/src/core/commands/seo/technical.md +0 -100
  525. package/src/core/commands/seo.md +0 -107
  526. package/src/core/commands/serve.md +0 -127
  527. package/src/core/commands/session/cleanup.md +0 -452
  528. package/src/core/commands/session/end.md +0 -865
  529. package/src/core/commands/session/history.md +0 -293
  530. package/src/core/commands/session/init.md +0 -210
  531. package/src/core/commands/session/new.md +0 -827
  532. package/src/core/commands/session/resume.md +0 -291
  533. package/src/core/commands/session/spawn.md +0 -205
  534. package/src/core/commands/session/status.md +0 -274
  535. package/src/core/commands/skill/list.md +0 -139
  536. package/src/core/commands/skill/recommend.md +0 -216
  537. package/src/core/commands/sprint.md +0 -714
  538. package/src/core/commands/status/undo.md +0 -191
  539. package/src/core/commands/status.md +0 -423
  540. package/src/core/commands/story/edit.md +0 -204
  541. package/src/core/commands/story/list.md +0 -199
  542. package/src/core/commands/story/view.md +0 -312
  543. package/src/core/commands/story-validate.md +0 -491
  544. package/src/core/commands/story.md +0 -465
  545. package/src/core/commands/tdd-next.md +0 -238
  546. package/src/core/commands/tdd.md +0 -211
  547. package/src/core/commands/team/guide.md +0 -688
  548. package/src/core/commands/team/list.md +0 -59
  549. package/src/core/commands/team/start.md +0 -130
  550. package/src/core/commands/team/status.md +0 -66
  551. package/src/core/commands/team/stop.md +0 -78
  552. package/src/core/commands/template.md +0 -644
  553. package/src/core/commands/tests.md +0 -731
  554. package/src/core/commands/update.md +0 -591
  555. package/src/core/commands/validate-expertise.md +0 -305
  556. package/src/core/commands/velocity.md +0 -630
  557. package/src/core/commands/verify.md +0 -534
  558. package/src/core/commands/whats-new.md +0 -201
  559. package/src/core/commands/workflow.md +0 -449
  560. package/src/core/council/sessions/.gitkeep +0 -0
  561. package/src/core/council/shared_reasoning.template.md +0 -106
  562. package/src/core/experts/README.md +0 -236
  563. package/src/core/experts/_core-expertise.yaml +0 -105
  564. package/src/core/experts/accessibility/expertise.yaml +0 -115
  565. package/src/core/experts/accessibility/question.md +0 -41
  566. package/src/core/experts/accessibility/self-improve.md +0 -45
  567. package/src/core/experts/accessibility/workflow.md +0 -59
  568. package/src/core/experts/adr-writer/expertise.yaml +0 -138
  569. package/src/core/experts/adr-writer/question.md +0 -56
  570. package/src/core/experts/adr-writer/self-improve.md +0 -106
  571. package/src/core/experts/adr-writer/workflow.md +0 -184
  572. package/src/core/experts/analytics/expertise.yaml +0 -119
  573. package/src/core/experts/analytics/question.md +0 -74
  574. package/src/core/experts/analytics/self-improve.md +0 -163
  575. package/src/core/experts/analytics/workflow.md +0 -272
  576. package/src/core/experts/api/expertise.yaml +0 -124
  577. package/src/core/experts/api/question.md +0 -74
  578. package/src/core/experts/api/self-improve.md +0 -122
  579. package/src/core/experts/api/workflow.md +0 -248
  580. package/src/core/experts/ci/expertise.yaml +0 -106
  581. package/src/core/experts/ci/question.md +0 -69
  582. package/src/core/experts/ci/self-improve.md +0 -100
  583. package/src/core/experts/ci/workflow.md +0 -145
  584. package/src/core/experts/codebase-query/expertise.yaml +0 -121
  585. package/src/core/experts/codebase-query/question.md +0 -73
  586. package/src/core/experts/codebase-query/self-improve.md +0 -105
  587. package/src/core/experts/compliance/expertise.yaml +0 -101
  588. package/src/core/experts/compliance/question.md +0 -56
  589. package/src/core/experts/compliance/self-improve.md +0 -106
  590. package/src/core/experts/compliance/workflow.md +0 -184
  591. package/src/core/experts/database/expertise.yaml +0 -109
  592. package/src/core/experts/database/question.md +0 -74
  593. package/src/core/experts/database/self-improve.md +0 -121
  594. package/src/core/experts/database/workflow.md +0 -234
  595. package/src/core/experts/datamigration/expertise.yaml +0 -141
  596. package/src/core/experts/datamigration/question.md +0 -56
  597. package/src/core/experts/datamigration/self-improve.md +0 -106
  598. package/src/core/experts/datamigration/workflow.md +0 -184
  599. package/src/core/experts/design/expertise.yaml +0 -116
  600. package/src/core/experts/design/question.md +0 -56
  601. package/src/core/experts/design/self-improve.md +0 -106
  602. package/src/core/experts/design/workflow.md +0 -184
  603. package/src/core/experts/devops/expertise.yaml +0 -116
  604. package/src/core/experts/devops/question.md +0 -68
  605. package/src/core/experts/devops/self-improve.md +0 -102
  606. package/src/core/experts/devops/workflow.md +0 -142
  607. package/src/core/experts/documentation/expertise.yaml +0 -126
  608. package/src/core/experts/documentation/question.md +0 -41
  609. package/src/core/experts/documentation/self-improve.md +0 -45
  610. package/src/core/experts/documentation/workflow.md +0 -55
  611. package/src/core/experts/epic-planner/expertise.yaml +0 -144
  612. package/src/core/experts/epic-planner/question.md +0 -56
  613. package/src/core/experts/epic-planner/self-improve.md +0 -106
  614. package/src/core/experts/epic-planner/workflow.md +0 -184
  615. package/src/core/experts/integrations/expertise.yaml +0 -113
  616. package/src/core/experts/integrations/question.md +0 -74
  617. package/src/core/experts/integrations/self-improve.md +0 -151
  618. package/src/core/experts/integrations/workflow.md +0 -246
  619. package/src/core/experts/mentor/expertise.yaml +0 -125
  620. package/src/core/experts/mentor/question.md +0 -56
  621. package/src/core/experts/mentor/self-improve.md +0 -106
  622. package/src/core/experts/mentor/workflow.md +0 -184
  623. package/src/core/experts/mobile/expertise.yaml +0 -136
  624. package/src/core/experts/mobile/question.md +0 -72
  625. package/src/core/experts/mobile/self-improve.md +0 -140
  626. package/src/core/experts/mobile/workflow.md +0 -240
  627. package/src/core/experts/monitoring/expertise.yaml +0 -132
  628. package/src/core/experts/monitoring/question.md +0 -76
  629. package/src/core/experts/monitoring/self-improve.md +0 -150
  630. package/src/core/experts/monitoring/workflow.md +0 -264
  631. package/src/core/experts/performance/expertise.yaml +0 -68
  632. package/src/core/experts/performance/question.md +0 -41
  633. package/src/core/experts/performance/self-improve.md +0 -45
  634. package/src/core/experts/performance/workflow.md +0 -61
  635. package/src/core/experts/product/expertise.yaml +0 -143
  636. package/src/core/experts/product/question.md +0 -56
  637. package/src/core/experts/product/self-improve.md +0 -106
  638. package/src/core/experts/product/workflow.md +0 -184
  639. package/src/core/experts/qa/expertise.yaml +0 -110
  640. package/src/core/experts/qa/question.md +0 -56
  641. package/src/core/experts/qa/self-improve.md +0 -106
  642. package/src/core/experts/qa/workflow.md +0 -184
  643. package/src/core/experts/readme-updater/expertise.yaml +0 -141
  644. package/src/core/experts/readme-updater/question.md +0 -56
  645. package/src/core/experts/readme-updater/self-improve.md +0 -106
  646. package/src/core/experts/readme-updater/workflow.md +0 -184
  647. package/src/core/experts/refactor/expertise.yaml +0 -135
  648. package/src/core/experts/refactor/question.md +0 -41
  649. package/src/core/experts/refactor/self-improve.md +0 -45
  650. package/src/core/experts/refactor/workflow.md +0 -57
  651. package/src/core/experts/research/expertise.yaml +0 -143
  652. package/src/core/experts/research/question.md +0 -56
  653. package/src/core/experts/research/self-improve.md +0 -106
  654. package/src/core/experts/research/workflow.md +0 -184
  655. package/src/core/experts/security/expertise.yaml +0 -117
  656. package/src/core/experts/security/question.md +0 -77
  657. package/src/core/experts/security/self-improve.md +0 -102
  658. package/src/core/experts/security/workflow.md +0 -152
  659. package/src/core/experts/templates/expertise-template.yaml +0 -67
  660. package/src/core/experts/templates/question-template.md +0 -56
  661. package/src/core/experts/templates/self-improve-template.md +0 -106
  662. package/src/core/experts/templates/workflow-template.md +0 -184
  663. package/src/core/experts/testing/expertise.yaml +0 -112
  664. package/src/core/experts/testing/question.md +0 -68
  665. package/src/core/experts/testing/self-improve.md +0 -102
  666. package/src/core/experts/testing/workflow.md +0 -143
  667. package/src/core/experts/ui/expertise.yaml +0 -133
  668. package/src/core/experts/ui/question.md +0 -74
  669. package/src/core/experts/ui/self-improve.md +0 -122
  670. package/src/core/experts/ui/workflow.md +0 -262
  671. package/src/core/knowledge/ads/ad-audit-checklist-scoring.md +0 -424
  672. package/src/core/knowledge/ads/ad-optimization-logic.md +0 -590
  673. package/src/core/knowledge/ads/ad-technical-specifications.md +0 -385
  674. package/src/core/knowledge/ads/definitive-advertising-reference-2026.md +0 -506
  675. package/src/core/knowledge/ads/paid-advertising-research-2026.md +0 -445
  676. package/src/core/profiles/COMPARISON.md +0 -170
  677. package/src/core/profiles/README.md +0 -178
  678. package/src/core/profiles/claude-code.yaml +0 -111
  679. package/src/core/profiles/codex.yaml +0 -103
  680. package/src/core/profiles/cursor.yaml +0 -134
  681. package/src/core/profiles/examples.js +0 -250
  682. package/src/core/profiles/loader.js +0 -235
  683. package/src/core/profiles/windsurf.yaml +0 -159
  684. package/src/core/skills/_learnings/README.md +0 -91
  685. package/src/core/skills/_learnings/_template.yaml +0 -106
  686. package/src/core/skills/_learnings/code-review.yaml +0 -118
  687. package/src/core/skills/_learnings/commit.yaml +0 -69
  688. package/src/core/skills/_learnings/story-writer.yaml +0 -71
  689. package/src/core/teams/backend.json +0 -41
  690. package/src/core/teams/builder-validator.json +0 -51
  691. package/src/core/teams/code-review.json +0 -41
  692. package/src/core/teams/frontend.json +0 -41
  693. package/src/core/teams/fullstack.json +0 -41
  694. package/src/core/teams/logic-audit.json +0 -53
  695. package/src/core/teams/perf-audit.json +0 -71
  696. package/src/core/teams/qa.json +0 -41
  697. package/src/core/teams/security-audit.json +0 -71
  698. package/src/core/teams/solo.json +0 -35
  699. package/src/core/teams/test-audit.json +0 -71
  700. package/src/core/templates/CONTEXT.md.example +0 -49
  701. package/src/core/templates/README-template.md +0 -16
  702. package/src/core/templates/adr-template.md +0 -28
  703. package/src/core/templates/agent-coordination-pattern.md +0 -38
  704. package/src/core/templates/agent-profile-template.md +0 -51
  705. package/src/core/templates/agileflow-metadata.json +0 -150
  706. package/src/core/templates/browser-qa-spec.yaml +0 -94
  707. package/src/core/templates/ci-workflow.yml +0 -74
  708. package/src/core/templates/claude-settings.advanced.example.json +0 -75
  709. package/src/core/templates/claude-settings.example.json +0 -26
  710. package/src/core/templates/command-documentation.md +0 -187
  711. package/src/core/templates/command-prerequisites.yaml +0 -169
  712. package/src/core/templates/comms-note-template.md +0 -24
  713. package/src/core/templates/damage-control-patterns.yaml +0 -243
  714. package/src/core/templates/environment.json +0 -18
  715. package/src/core/templates/epic-template.md +0 -27
  716. package/src/core/templates/plan-template.md +0 -125
  717. package/src/core/templates/preserve-rules-common.md +0 -107
  718. package/src/core/templates/preserve-rules.json +0 -42
  719. package/src/core/templates/proactive-action-spec.md +0 -29
  720. package/src/core/templates/product-brief.md +0 -136
  721. package/src/core/templates/quality-gate-priorities.md +0 -34
  722. package/src/core/templates/research-template.md +0 -44
  723. package/src/core/templates/session-harness-protocol.md +0 -128
  724. package/src/core/templates/session-state.json +0 -56
  725. package/src/core/templates/story-lifecycle.md +0 -213
  726. package/src/core/templates/story-template.md +0 -92
  727. package/src/core/templates/tdd-test-template.js +0 -241
  728. package/src/core/templates/worktrees-guide.md +0 -231
  729. package/tools/agileflow-npx.js +0 -52
  730. package/tools/cli/agileflow-cli.js +0 -72
  731. package/tools/cli/commands/config.js +0 -285
  732. package/tools/cli/commands/doctor.js +0 -496
  733. package/tools/cli/commands/list.js +0 -385
  734. package/tools/cli/commands/serve.js +0 -492
  735. package/tools/cli/commands/session.js +0 -1176
  736. package/tools/cli/commands/setup.js +0 -255
  737. package/tools/cli/commands/status.js +0 -101
  738. package/tools/cli/commands/tui.js +0 -56
  739. package/tools/cli/commands/uninstall.js +0 -155
  740. package/tools/cli/commands/update.js +0 -299
  741. package/tools/cli/installers/core/installer.js +0 -892
  742. package/tools/cli/installers/ide/_base-ide.js +0 -518
  743. package/tools/cli/installers/ide/_interface.js +0 -238
  744. package/tools/cli/installers/ide/claude-code.js +0 -432
  745. package/tools/cli/installers/ide/codex.js +0 -426
  746. package/tools/cli/installers/ide/cursor.js +0 -217
  747. package/tools/cli/installers/ide/manager.js +0 -222
  748. package/tools/cli/installers/ide/windsurf.js +0 -282
  749. package/tools/cli/lib/command-context.js +0 -382
  750. package/tools/cli/lib/config-manager.js +0 -446
  751. package/tools/cli/lib/content-injector.js +0 -969
  752. package/tools/cli/lib/content-transformer.js +0 -496
  753. package/tools/cli/lib/docs-setup.js +0 -464
  754. package/tools/cli/lib/error-handler.js +0 -165
  755. package/tools/cli/lib/ide-error-factory.js +0 -421
  756. package/tools/cli/lib/ide-errors.js +0 -367
  757. package/tools/cli/lib/ide-generator.js +0 -357
  758. package/tools/cli/lib/ide-health-monitor.js +0 -364
  759. package/tools/cli/lib/ide-registry.js +0 -297
  760. package/tools/cli/lib/npm-utils.js +0 -103
  761. package/tools/cli/lib/self-update.js +0 -148
  762. package/tools/cli/lib/ui.js +0 -211
  763. package/tools/cli/lib/utils.js +0 -87
  764. package/tools/cli/lib/validation-middleware.js +0 -491
  765. package/tools/cli/lib/version-checker.js +0 -95
  766. 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/)