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