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,424 +0,0 @@
1
- # Algorithmic Integrity and Performance Auditing: A Technical Standard for Digital Advertising Compliance
2
-
3
- ---
4
-
5
- ## 1. Executive Summary: The Shift to Deterministic Auditing
6
-
7
- The digital advertising landscape has undergone a fundamental architectural shift. The era of manual bid adjustments and granular keyword management has largely ceded territory to algorithmic automation---systems driven by machine learning models such as Google's Smart Bidding, Meta's Advantage+, and TikTok's Automated Creative Optimization. In this environment, the role of the account audit transforms from a subjective review of human strategy to a deterministic evaluation of algorithmic inputs. The auditor's primary function is no longer to judge creative aesthetics but to verify "Signal Integrity" and "Algorithmic Freedom."
8
-
9
- Signal Integrity refers to the technical fidelity of the data loop feeding the ad platform. If a conversion pixel misfires, or if server-side deduplication fails, the algorithm optimizes toward a hallucination. Algorithmic Freedom refers to the structural constraints placed on the machine; hyper-segmented account structures (such as Single Keyword Ad Groups or SKAGs) often starve modern algorithms of the data density required for statistical significance, forcing them into a perpetual state of "Learning Limited."
10
-
11
- This report establishes a rigorous technical specification for claude-ads, an automated auditing engine. It defines over 170 specific, binary, and numeric pass/fail criteria across Google, Meta, LinkedIn, TikTok, and Microsoft advertising platforms. These specifications are designed not merely as best practices but as hard-coded logic gates that determine the health of an advertising ecosystem. The methodology prioritizes the mathematical realities of auction dynamics---Impression Share, Quality Score, Event Match Quality, and Auction Overlap---over subjective marketing trends.
12
-
13
- ---
14
-
15
- ## 2. Standardized Scoring Methodology
16
-
17
- To convert complex, multi-dimensional audit data into a singular, actionable metric, a weighted scoring algorithm is essential. This system must account for the disparate impact of various failure modes; a broken conversion tag (Critical) renders an account functionally useless, whereas a missing sitelink extension (Low) merely represents a marginal efficiency loss.
18
-
19
- ### 2.1 The Weighted Scoring Algorithm
20
-
21
- The final account score (S_total) is derived using a category-weighted arithmetic mean, adjusted by severity multipliers. Each individual audit check (C_i) is assigned a severity tier (W_sev) and falls within a functional category (Cat_j) carrying a specific category weight (W_cat).
22
-
23
- The severity weights are calibrated to reflect the existential risk to account performance:
24
-
25
- - **Critical (Multiplier: 5.0):** These are "Kill Switch" issues. Their presence implies that reported data is false or that capital is being deployed with near-zero efficiency. Examples include offline conversion tracking, >90% budget wasted on irrelevant search terms, or a Meta Pixel with <3.0 Event Match Quality. A failure here triggers an automatic "F" grade for the specific section.
26
- - **High (Multiplier: 3.0):** These issues cause significant inefficiency, volume loss, or algorithmic confusion. Examples include Quality Scores below 5, creative fatigue indices >0.6, or audience overlaps >30%.
27
- - **Medium (Multiplier: 1.5):** These represent violations of modern best practices that hinder optimization but do not break the system. Examples include excessive keyword density per ad group (>20) or missing secondary ad extensions.
28
- - **Low (Multiplier: 0.5):** Housekeeping, hygiene, and minor optimizations, such as inconsistent naming conventions or disorganized labels.
29
-
30
- The algorithmic logic for the final score calculation is expressed as:
31
-
32
- $$S_{total} = \frac{\sum(C_{pass} \times W_{sev} \times W_{cat})}{\sum(C_{total} \times W_{sev} \times W_{cat})} \times 100$$
33
-
34
- ### 2.2 Category Weight Distribution
35
-
36
- The weights assigned to each audit category reflect the specific architectural priorities of each platform. For instance, in Google Ads, "Search Terms" and "Keywords" hold primacy because it is a pull-based intent channel. In contrast, for Meta Ads, "Creative" and "Pixel Health" are dominant because it is a push-based discovery channel reliant on signal resilience and visual engagement.
37
-
38
- | Platform | Category | Weight (%) | Rationale |
39
- |----------|----------|------------|-----------|
40
- | **Google** | Conversion Tracking | 25% | Smart Bidding (tCPA/tROAS) fails fundamentally without accurate data. |
41
- | | Wasted Spend / Negatives | 20% | Direct impact on financial efficiency and CPA. |
42
- | | Account Structure | 15% | Determines Quality Score, Ad Rank, and data density. |
43
- | | Keywords & Quality Score | 15% | The core mechanism of the Search auction. |
44
- | | Ads & Assets (RSA/PMax) | 15% | Critical for CTR, Ad Rank, and inventory access. |
45
- | | Settings & Targeting | 10% | Foundational hygiene and geo-fencing. |
46
- | **Meta** | Pixel/CAPI Health | 30% | Post-iOS14, signal resilience is the primary determinant of success. |
47
- | | Creative (Diversity/Fatigue) | 30% | Creative is the primary targeting lever on social platforms. |
48
- | | Account Structure | 20% | Consolidation is required for algorithmic learning phases. |
49
- | | Audience & Targeting | 20% | Overlap and saturation checks to prevent self-competition. |
50
-
51
- ### 2.3 Grading Thresholds and "Quick Wins"
52
-
53
- The numeric score output (0--100) maps to qualitative performance bands. These thresholds are strict; an account in the "C" range is functioning but leaking significant budget, while an "A" account is fully optimized for machine learning.
54
-
55
- - **A (90--100): Algorithmic Excellence.** The account operates with high signal integrity, consolidated structures, and maximal asset density.
56
- - **B (75--89): Performant.** A solid foundation exists, likely with minor inefficiencies in asset variety or secondary extension coverage.
57
- - **C (60--74): Compromised.** The account is functional but inefficient. It likely suffers from fragmentation (too many ad sets/groups) or creative fatigue.
58
- - **D (40--59): At Risk.** Major fundamental errors are present. Tracking may be intermittent, or wasted spend is unchecked.
59
- - **F (<40): Critical Failure.** The account is actively burning capital with little attributable return. Immediate pause and remediation are required.
60
-
61
- **Quick Wins Logic:**
62
-
63
- The system must algorithmically identify "Quick Wins" to prioritize user action. A check is classified as a Quick Win if it meets the following Boolean logic:
64
-
65
- 1. **Severity** == High OR Critical
66
- 2. **Remediation Time** == Low (<15 minutes)
67
-
68
- Examples of Quick Wins include adding negative keywords for 0-conversion terms, enabling "Enhanced Conversions" in settings, or excluding "Audience Network" from traffic campaigns.
69
-
70
- ---
71
-
72
- ## 3. Google Ads Audit Checklist: The Intent Engine
73
-
74
- Google Ads remains the most complex platform to audit due to its multi-layered auction dynamics involving Search, Shopping, Display, and Video. The core philosophy of a Google Ads audit is "Relevance and Hygiene." The system penalizes irrelevance (low Quality Score, wasted search terms) and rewards density (high asset counts in PMax and RSAs).
75
-
76
- ### 3.1 Account Structure and Hierarchy
77
-
78
- The structural integrity of a Google Ads account dictates its ability to learn. In the age of Smart Bidding, the "SKAG" (Single Keyword Ad Group) structure is largely obsolete because it fragments data, preventing the bidding algorithm from achieving statistical significance. The modern standard is the "STAG" (Single Theme Ad Group) or consolidated structure, which pools data to feed the AI.
79
-
80
- **Metric Analysis:** The "Ad Group Density" check (G02) monitors the ratio of ad groups to campaigns. An account with 100 campaigns and 1 ad group each (1:1 ratio) often fails to leverage campaign-level budget optimization. Conversely, an ad group with >20 keywords (G03) suffers from "Theme Drift," where the ad copy cannot possibly match the user intent of every keyword, degrading Ad Relevance.<sup>1</sup>
81
-
82
- **Table 1: Google Ads Structure & Settings Audit**
83
-
84
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
85
- |---------|----------|------------|---------------|---------------|----------|
86
- | G01 | Structure | Campaign Fragmentation | < 1 Campaign per $500/mo spend | > 1 Campaign per $500/mo spend | Medium |
87
- | G02 | Structure | Ad Group Density | 5--20 Ad Groups per Campaign | < 1 or > 50 (diluted data) | Medium |
88
- | G03 | Structure | Keyword Density per Ad Group | ≤ 10 Keywords <sup>1</sup> | > 20 Keywords | High |
89
- | G04 | Structure | Ad Count per Ad Group | 1--3 Active RSAs | 0 Active or > 3 Active | Critical |
90
- | G05 | Structure | Search Network Settings | Display Network Disabled | Display Network Enabled | High |
91
- | G06 | Structure | Search Partner Performance | CPA ≤ 1.2x Search CPA | CPA > 1.2x Search CPA & Enabled | Medium |
92
- | G07 | Structure | Campaign Naming Hygiene | Matches Regex (e.g., `Type | Geo | Goal`) | | Low |
93
- | G08 | Settings | Location Option | "Presence: People in..." | "Interest: People in or interested in..." | High |
94
- | G09 | Settings | Geo Exclusions | Excluded Locations List Populated | Empty Exclusion List | Low |
95
- | G10 | Settings | Ad Schedule (Dayparting) | Applied (Data-driven) | 24/7 (if limited by budget) | Low |
96
- | G11 | Settings | Device Bid Adjustments | Applied to low performers | None (despite variance >20%) | Medium |
97
- | G12 | Settings | Auto-Apply Recommendations | Harmful suggestions OFF (e.g., Broad Match) | Harmful suggestions ON | Medium |
98
-
99
- ### 3.2 Search Terms and Wasted Spend
100
-
101
- This category represents the most direct financial impact. "Wasted Spend" is defined as budget consumed by search terms that generate clicks but zero conversions. While some exploration is necessary, algorithmic efficiency demands that this waste be capped.
102
-
103
- **Technical Thresholds:** The audit sets a strict fail threshold for irrelevant spend. If more than 10% of the budget is allocated to search terms classified as irrelevant (via N-gram analysis or manual review logic), the account fails.<sup>1</sup> Furthermore, "Zero-Conversion Spend" is a critical efficiency metric. A threshold of 20% of the total budget spent on 0-conversion terms is the fail line.<sup>2</sup> The audit also utilizes a specific query volume check: identifying search terms with >30 clicks and 0 conversions as immediate candidates for negative keywords.<sup>3</sup>
104
-
105
- **Table 2: Google Ads Search Terms & Negatives Audit**
106
-
107
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
108
- |---------|----------|------------|---------------|---------------|----------|
109
- | G13 | Search Terms | Irrelevant Spend Ratio | < 5% of spend | > 10% of spend <sup>1</sup> | High |
110
- | G14 | Search Terms | Zero-Conversion Waste | < 10% of total budget | > 20% of total budget <sup>2</sup> | Critical |
111
- | G15 | Search Terms | High-Volume Losers | 0 terms with >30 clicks & 0 conv | > 0 terms with >30 clicks & 0 conv <sup>3</sup> | High |
112
- | G16 | Search Terms | Search Term Coverage | > 80% of volume matched to keywords | < 50% matched | Medium |
113
- | G17 | Negatives | Negative Keyword Conflicts | 0 Conflicts | > 0 Conflicts | Critical |
114
- | G18 | Negatives | Negative List Usage | Shared Lists Applied | Campaign-level negatives only | Low |
115
- | G19 | Negatives | Brand Isolation | 0% Brand Imp. in Non-Brand | > 5% Brand Imp. in Non-Brand | High |
116
-
117
- ### 3.3 Quality Score and Keyword Health
118
-
119
- Quality Score (QS) is not a vanity metric; it is a proxy for Ad Rank and Cost Per Click (CPC). A low QS forces the advertiser to pay a premium for every click. The audit analyzes the distribution of QS across the account's active keywords.
120
-
121
- **Critical Thresholds:** A healthy account maintains a weighted Quality Score where ≥70% of keywords are QS 7 or higher.<sup>1</sup> Conversely, any account where >20% of spend goes to keywords with QS < 5 is critically inefficient.<sup>4</sup> This indicates a fundamental disconnect between keywords, ad copy, and landing pages.
122
-
123
- **Table 3: Google Ads Keyword & Quality Score Audit**
124
-
125
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
126
- |---------|----------|------------|---------------|---------------|----------|
127
- | G20 | Quality Score | High QS Distribution | ≥ 70% keywords with QS ≥ 7 | < 50% keywords with QS ≥ 7 <sup>1</sup> | High |
128
- | G21 | Quality Score | Critical QS Spend | < 10% spend on QS < 5 | > 20% spend on QS < 5 <sup>4</sup> | Critical |
129
- | G22 | Keywords | Match Type Mix | Broad Match < 20% (if Manual CPC) | Match > 50% (if Manual CPC) | High |
130
- | G23 | Keywords | Broad Match + Smart Bidding | Broad Match used with tCPA/tROAS | Broad Match used with Manual CPC | High |
131
- | G24 | Keywords | Ad Group Relevance | QS "Ad Relevance" component Above Avg | "Below Average" for >20% spend | Medium |
132
- | G25 | Keywords | Landing Page Exp. | QS "LP Exp" component Above Avg | "Below Average" for >20% spend | High |
133
-
134
- ### 3.4 Ads, Assets, and Performance Max
135
-
136
- The transition from Expanded Text Ads (ETAs) to Responsive Search Ads (RSAs) and Performance Max (PMax) campaigns requires a shift in auditing focus from "copywriting" to "asset density." PMax, in particular, acts as a black box that requires sufficient fuel (assets) to function.
137
-
138
- **PMax Specifics:** The audit enforces a "Maximum Asset Density" standard. A PMax asset group must contain the full complement of 20 images, 5 logos, and 5 videos to access all inventory slots (Discovery, YouTube, Display). Missing videos is a common failure point that restricts PMax to standard Display slots, degrading performance.<sup>1</sup>
139
-
140
- **Table 4: Google Ads Creative (RSA & PMax) Audit**
141
-
142
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
143
- |---------|----------|------------|---------------|---------------|----------|
144
- | G26 | Ads (RSA) | Ad Strength | > 80% "Good" or "Excellent" | < 50% "Good" or "Excellent" | Medium |
145
- | G27 | Ads (RSA) | Asset Performance | < 10% assets rated "Low" | > 20% assets rated "Low" <sup>1</sup> | High |
146
- | G28 | Ads (RSA) | Headline Utilization | 10--15 Headlines | < 5 Headlines | High |
147
- | G29 | Ads (RSA) | Description Utilization | 4 Descriptions | < 2 Descriptions | High |
148
- | G30 | Ads (RSA) | Pinning Rate | < 20% assets pinned | > 50% assets pinned (AI restriction) | Medium |
149
- | G31 | PMax | Asset Group Density | 20 img, 5 logo, 5 vid <sup>1</sup> | < 10 img OR 0 video | Critical |
150
- | G32 | PMax | Audience Signals | High Intent Segments attached | No Signals / Generic Interest only | High |
151
- | G33 | PMax | Brand Exclusions | Brand List applied (if Search active) | No Brand Exclusions | Medium |
152
- | G34 | PMax | URL Expansion | On (with exclusions) | On (without exclusions) or Off | Medium |
153
- | G35 | PMax | Negative Keywords | Account-level negatives applied | No negatives applied | High |
154
-
155
- ### 3.5 Bidding, Budget, and Impression Share
156
-
157
- Budget allocation efficiency is measured through "Lost Impression Share (IS)." This metric bifurcates lost volume into "Lost to Rank" (quality/bid issue) and "Lost to Budget" (financial constraint).
158
-
159
- **Threshold Logic:** If a campaign has profitable ROAS but loses >15-25% of its Impression Share to budget, it is a mathematical failure of capital allocation.<sup>5</sup> Conversely, a campaign limited by budget should not be using "Maximize Clicks" or manual bidding without strict caps, as it will simply exhaust the budget earlier in the day at a higher CPC.
160
-
161
- **Table 5: Google Ads Bidding & Budget Audit**
162
-
163
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
164
- |---------|----------|------------|---------------|---------------|----------|
165
- | G36 | Budget | Lost IS (Budget) | < 10% | > 15--25% <sup>5</sup> | High |
166
- | G37 | Budget | Lost IS (Rank) | < 20% | > 50% (Quality/Bid issue) | High |
167
- | G38 | Bidding | Strategy Alignment | tCPA/tROAS has >30 conv/mo | tCPA/tROAS with <15 conv/mo | Critical |
168
- | G39 | Bidding | Limited by Budget | Status: Active | Status: Limited by Budget | Medium |
169
- | G40 | Bidding | Enhanced CPC | Disabled (on Auto-bidding) | Enabled (redundant/conflicting) | Low |
170
- | G41 | Bidding | Target Reality Check | Actual ROAS within +/- 20% of Target | Variance > 50% (Unrealistic) | High |
171
-
172
- ### 3.6 Conversion Tracking and Attribution
173
-
174
- This is the bedrock of the account. Without accurate conversion data, Smart Bidding algorithms optimize toward noise.
175
-
176
- **Table 6: Google Ads Conversion & Attribution Audit**
177
-
178
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
179
- |---------|----------|------------|---------------|---------------|----------|
180
- | G42 | Conversions | Primary Action Check | At least 1 Primary Action | No Primary Actions / All Secondary | Critical |
181
- | G43 | Conversions | Tracking Status | "Recording Conversions" | "No recent conversions" (>7 days) | Critical |
182
- | G44 | Conversions | Enhanced Conversions | Status: Active/On <sup>6</sup> | Status: Off | High |
183
- | G45 | Conversions | Attribution Model | Data-Driven | Last Click (Legacy) | High |
184
- | G46 | Conversions | Conversion Window | 30--90 Days | 7 Days (for high-consideration) | Medium |
185
- | G47 | Conversions | Repeat Rate | < 1.1 (Lead Gen) | > 1.5 (Duplicate tracking error) | Critical |
186
- | G48 | Conversions | Offline Import | Scheduled / API Connected | Manual / None | Medium |
187
- | G49 | Conversions | View-Through Window | 1 Day | > 1 Day (Inflation risk) | Low |
188
-
189
- ### 3.7 Extensions, Audiences, and Landing Pages
190
-
191
- **Table 7: Google Ads Assets & Landing Page Audit**
192
-
193
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
194
- |---------|----------|------------|---------------|---------------|----------|
195
- | G50 | Extensions | Sitelink Coverage | > 4 Active Sitelinks | < 2 | Medium |
196
- | G51 | Extensions | Callout Coverage | > 4 Active Callouts | < 2 | Low |
197
- | G52 | Extensions | Snippet Coverage | > 1 Active Snippet | 0 | Low |
198
- | G53 | Extensions | Image Extensions | > 1 Active Image Ext | 0 | Medium |
199
- | G54 | Extensions | Disapproval Rate | 0% | > 10% | Low |
200
- | G55 | Audiences | RLSA List Size | > 1,000 Users | < 100 Users (Too small) | Medium |
201
- | G56 | Audiences | Customer Match | Upload < 30 Days ago | Upload > 90 Days ago | Medium |
202
- | G57 | Audiences | Observation Mode | > 5 Audiences Observed | 0 | Medium |
203
- | G58 | Landing Page | Mobile Speed | Score > 70 | Score < 40 | High |
204
- | G59 | Landing Page | Destination Errors | 0% 404/500 Errors | > 0% | Critical |
205
- | G60 | Landing Page | Relevance | QS LP Exp "Average" | QS LP Exp "Below Average" | High |
206
- | G61 | Maintenance | Change History | > 5 changes in 30 days | 0 changes (Dormant) | High |
207
-
208
- ---
209
-
210
- ## 4. Meta Ads Audit Checklist: The Social Signal Graph
211
-
212
- Auditing Meta (Facebook/Instagram) Ads requires a fundamentally different approach than search. While search is deterministic (keyword = intent), social is probabilistic. The algorithm relies on "Signal Resilience" (Event Match Quality) and "Creative Velocity" to function. The "Learning Phase" is the central mechanic; ad sets that fail to exit the learning phase effectively waste budget by operating without full algorithmic optimization.
213
-
214
- ### 4.1 Technical Setup: Pixel, CAPI, and Signal Resilience
215
-
216
- In a post-iOS14 world, the browser pixel is insufficient. The audit must verify the implementation of the Conversions API (CAPI) and the quality of the events being passed.
217
-
218
- **Metric Analysis:** The "Event Match Quality" (EMQ) score is Meta's grading of how well it can link an event to a user. A score of "Great" (8-10) is ideal. Scores in the "Poor" (0-2) or "OK" (3-5) range <sup>7</sup> indicate that the data is too degraded for effective retargeting or lookalike modeling. Additionally, "Deduplication" is critical; checking that every event has a unique Event ID ensures that browser and server events are unified, preventing ROAS inflation.
219
-
220
- **Table 8: Meta Ads Technical & Signal Audit**
221
-
222
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
223
- |---------|----------|------------|---------------|---------------|----------|
224
- | M01 | Technical | Pixel Activity | Active / Firing | Inactive / No Recent Events | Critical |
225
- | M02 | Technical | CAPI Integration | Connected | Not Connected | Critical |
226
- | M03 | Technical | EMQ Score | Score ≥ 6 (Good/Great) <sup>7</sup> | Score ≤ 5 (OK/Poor) | Critical |
227
- | M04 | Technical | Deduplication | 100% Deduplicated | Duplicated (Double Counting) | Critical |
228
- | M05 | Technical | Domain Verification | Verified | Not Verified | High |
229
- | M06 | Technical | Aggregated Event Msmt | 8 Priority Events Configured | Not Configured | High |
230
- | M07 | Technical | Advanced Matching | Auto-Matching ON | Auto-Matching OFF | High |
231
- | M08 | Technical | Currency Match | Ad Account = Pixel Currency | Mismatch | Low |
232
- | M09 | Technical | Parameters Passed | Email, Phone, Name, IP, Agent | Missing User Data Keys | High |
233
- | M10 | Technical | Standard Events | Standard Events Used | Custom Conversions Only | Medium |
234
-
235
- ### 4.2 Account Structure and Learning Phase Mechanics
236
-
237
- Meta's algorithm thrives on consolidated data. Fragmented accounts with dozens of low-budget ad sets prevent any single ad set from achieving the necessary 50 conversions per week to exit the "Learning Phase."
238
-
239
- **Table 9: Meta Ads Structure & Learning Audit**
240
-
241
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
242
- |---------|----------|------------|---------------|---------------|----------|
243
- | M11 | Structure | Campaign Consolidation | < 5 Campaigns per Objective | > 10 (Fragmentation) | High |
244
- | M12 | Structure | Learning Phase Status | < 20% Ad Sets "Learning Limited" | > 50% "Learning Limited" | High |
245
- | M13 | Structure | Conversion Volume | > 50 Conversions/week <sup>8</sup> | < 10 Conversions/week | High |
246
- | M14 | Structure | Ad Set Audience | > 100,000 <sup>9</sup> | < 100,000 (Too small) | Medium |
247
- | M15 | Structure | Advantage+ Budget | CBO / Advantage + Budget ON | ABO (if > 3 ad sets) | Medium |
248
- | M16 | Structure | Advantage+ Shopping | Active (if E-com) | Inactive (if E-com) | Medium |
249
- | M17 | Structure | Objective Alignment | Sales/Leads | Traffic/Awareness (for perf.) | High |
250
- | M18 | Structure | Naming Conventions | Consistent Taxonomy | Chaotic | Low |
251
-
252
- ### 4.3 Audience Dynamics and Overlap
253
-
254
- "Audience Overlap" is a silent budget killer. If two ad sets target overlapping audiences (e.g., "Interest: Golf" and "Interest: Tiger Woods"), they compete against each other in the auction, raising CPMs. The audit threshold for overlap is 30%.<sup>10</sup>
255
-
256
- **Table 10: Meta Ads Audience & Targeting Audit**
257
-
258
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
259
- |---------|----------|------------|---------------|---------------|----------|
260
- | M19 | Audience | Audience Overlap | < 20% | > 30% <sup>10</sup> | High |
261
- | M20 | Audience | Exclusion Logic | Past Purchasers Excluded (TOF) | No Exclusions | High |
262
- | M21 | Audience | Lookalike Recency | Dynamic / < 60 days | Static List > 90 days | Medium |
263
- | M22 | Audience | Retargeting Window | Appropriate (e.g. 30D) | Too small (<1000 users) | Medium |
264
- | M23 | Audience | Advantage+ Audience | Enabled (Expansion ON) | Disabled (Strict targeting) | Medium |
265
- | M24 | Audience | Geo-Targeting | "Living in" (if local) | "Recently in" (if shipping ltd) | Low |
266
-
267
- ### 4.4 Creative Strategy, Diversity, and Fatigue
268
-
269
- Creative is the new targeting. The audit evaluates "Creative Diversity" (mix of static and video) and "Fatigue." Creative fatigue is identified via Frequency metrics. A frequency > 3.0 for prospecting audiences correlates with diminishing returns and rising CPAs.<sup>11</sup>
270
-
271
- **Table 11: Meta Ads Creative & Settings Audit**
272
-
273
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
274
- |---------|----------|------------|---------------|---------------|----------|
275
- | M25 | Creative | Format Diversity | Image + Video present | Single Format Only | High |
276
- | M26 | Creative | Aspect Ratio | 1:1, 9:16, 1.91:1 all present | Missing 9:16 (Reels/Stories) | High |
277
- | M27 | Creative | Ad Density per Ad Set | 3--6 Ads <sup>12</sup> | 1 Ad or > 10 Ads | Medium |
278
- | M28 | Creative | Frequency (Prospecting) | < 2.5 | > 3.0 <sup>11</sup> | High |
279
- | M29 | Creative | Creative Refresh | < 14 Days <sup>11</sup> | > 30 Days | High |
280
- | M30 | Creative | Text Overlay | < 20% Text | Text Heavy (Delivery penalty) | Low |
281
- | M31 | Creative | Hook Rate | > 25% (3-sec view / Imp) | < 10% | Medium |
282
- | M32 | Creative | Hold Rate | > 15% (ThruPlay / Imp) | < 5% | Low |
283
- | M33 | Placements | Advantage+ Placements | Enabled (Auto) | Manual (unless strict safety) | Medium |
284
- | M34 | Placements | Audience Network | < 20% Spend | > 50% Spend (Low quality) | High |
285
- | M35 | Settings | Attribution Setting | 7-day click / 1-day view | Varies by ad set | Medium |
286
- | M36 | Settings | Bid Strategy | Lowest Cost / Highest Vol | Cost Cap (with 0 delivery) | High |
287
- | M37 | Settings | Budget Pacing | Standard | Accelerated (Legacy/Manual) | Low |
288
- | M38 | Reporting | UTM Parameters | Present & Consistent | Missing | High |
289
- | M39 | Reporting | Cross-Channel Parity | Variance < 20% | Variance > 40% | Medium |
290
- | M40 | Reporting | Experimentation | Active A/B Tests | No historical tests | Low |
291
-
292
- ---
293
-
294
- ## 5. LinkedIn Ads Audit Checklist: Precision B2B Targeting
295
-
296
- LinkedIn's auction dynamics are distinct: high CPCs ($8--$15+) demand extreme precision. The "Insight Tag" and "Matched Audiences" are the linchpins of success. Unlike Meta, broad targeting is a liability on LinkedIn; "Audience Expansion" often dilutes B2B intent with irrelevant industries to fill budget.
297
-
298
- **Audience Thresholds:** A critical failure point on LinkedIn is the "Audience Size" floor. Campaigns with <300 members in the target audience will fail to deliver entirely.<sup>13</sup> Conversely, the "Audience Expansion" setting is flagged as a "High" severity fail because it breaks the precision of the Ideal Customer Profile (ICP).
299
-
300
- **Table 12: LinkedIn Ads Audit Checklist**
301
-
302
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
303
- |---------|----------|------------|---------------|---------------|----------|
304
- | L01 | Technical | Insight Tag Health | Active / Rec'd < 24h | Inactive / Not Installed <sup>14</sup> | Critical |
305
- | L02 | Technical | Conversion Tracking | Leads/Purchases Active | "Page View" only / None | Critical |
306
- | L03 | Audience | Cold Audience Size | 50k -- 400k | < 50k or > 1M | High |
307
- | L04 | Audience | Retargeting Size | > 300 Members <sup>13</sup> | < 300 (Delivery Block) | Critical |
308
- | L05 | Audience | Audience Expansion | Disabled (Unchecked) | Enabled (Dilutes ICP) | High |
309
- | L06 | Audience | Audience Network | Disabled (Unchecked) | Enabled (Low Quality) | High |
310
- | L07 | Audience | Targeting Layers | Function + Seniority | Job Title Only (Unscalable) | Medium |
311
- | L08 | Audience | Exclusions | Competitors/Customers Excluded | No Exclusions | Medium |
312
- | L09 | Audience | Geo-Targeting | "Permanent Location" | "Recent Location" | Medium |
313
- | L10 | Creative | Ad Variations | 3--5 Variations <sup>14</sup> | 1 Variation | High |
314
- | L11 | Creative | Refresh Cycle | < 45 Days <sup>14</sup> | > 60 Days | Medium |
315
- | L12 | Creative | Intro Text | < 150 chars (Mobile) | > 150 chars (Truncated) | Low |
316
- | L13 | Creative | Video Captions | SRT Uploaded | Missing | Low |
317
- | L14 | Forms | Lead Gen Forms | Native Forms Used | Landing Page Traffic Only | High |
318
- | L15 | Forms | Hidden Fields | UTM/Source Passing | Missing | Medium |
319
- | L16 | Bidding | Bid Strategy | Manual CPC (Control) | Auto-Bid (Inefficient) | Medium |
320
- | L17 | Bidding | Budget/Bid Ratio | Budget > 5x Bid | Budget < 2x Bid | High |
321
- | L18 | Structure | Objective | Lead Gen / Website Visits | Brand Awareness | Low |
322
- | L19 | Structure | Naming | Consistent | Chaotic | Low |
323
- | L20 | Structure | Ad Rotation | Rotate Evenly | Optimize (Premature) | Low |
324
- | L21 | Performance | CTR Benchmark | > 0.40% | < 0.20% | High |
325
- | L22 | Performance | CPC vs Target | < Target | > Target (Increase budget 25%) | Medium |
326
- | L23 | Performance | Frequency Cap | < 4 (30-day) | > 8 (B2B Fatigue) | Medium |
327
- | L24 | Matching | Company Match Rate | > 50% | < 20% (Data quality issue) | Medium |
328
- | L25 | Tracking | Demographic Report | > 80% Relevant Titles | > 20% Irrelevant | High |
329
-
330
- ---
331
-
332
- ## 6. TikTok Ads Audit Checklist: The Content Graph
333
-
334
- TikTok's algorithm consumes creative at an unprecedented rate. The core audit metric here is the "Fatigue Index." A score >0.6 indicates that the creative has exhausted its audience potential and must be refreshed.<sup>15</sup>
335
-
336
- **Technical Nuance:** The "Pangle" placement (TikTok's audience network) is often a source of low-quality, accidental clicks. Unless the goal is pure reach, Pangle should generally be excluded or heavily monitored. Additionally, TikTok requires a specific budget threshold to exit the learning phase: the daily budget should ideally be 50x the Target CPA <sup>15</sup> to provide the system with enough "room" to find conversions.
337
-
338
- **Table 13: TikTok Ads Audit Checklist**
339
-
340
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
341
- |---------|----------|------------|---------------|---------------|----------|
342
- | T01 | Technical | Connection Type | Pixel + Events API <sup>15</sup> | Pixel Only | High |
343
- | T02 | Technical | Advanced Matching | Enabled (Email/Phone) | Disabled | High |
344
- | T03 | Structure | Ad Group Diversity | 3--5 Ad Groups <sup>15</sup> | 1 Ad Group | Medium |
345
- | T04 | Structure | Broad Targeting | Broad (Gender/Age) | Narrow (Restrictive) | Medium |
346
- | T05 | Creative | Fatigue Index | < 0.6 | > 0.6 <sup>15</sup> | High |
347
- | T06 | Creative | Creative Velocity | > 3 New Ads/Week | 0 New Ads | High |
348
- | T07 | Creative | Ad Count | 3--5 Active Ads <sup>15</sup> | 1 Active Ad | High |
349
- | T08 | Creative | Video Duration | > 21s (Ideal: 21-34s) | < 5s | Medium |
350
- | T09 | Creative | Sound On | Audio Enabled | Muted | High |
351
- | T10 | Creative | Safe Zone | UI Safe Zone Clear | Elements Obscured | Medium |
352
- | T11 | Bidding | Budget Floor | > 50x Target CPA <sup>15</sup> | < 10x Target CPA | High |
353
- | T12 | Bidding | Dayparting | All Day | Restricted Hours | Low |
354
- | T13 | Learning | Learning Phase | > 50 Conv/Week <sup>15</sup> | < 20 Conv/Week | High |
355
- | T14 | Settings | Pangle Placement | Excluded / Monitored | Included (Blind) | Medium |
356
- | T15 | Settings | Comments | Enabled (Moderated) | Disabled (Reach penalty) | Low |
357
- | T16 | Settings | ACO | Enabled | Disabled | Low |
358
- | T17 | Performance | CTR | > 1.0% | < 0.5% | Medium |
359
- | T18 | Performance | CVR | Within Benchmark | < 50% Benchmark | High |
360
- | T19 | Performance | CPA Stability | Stable | > 1.5x KPI | High |
361
- | T20 | Structure | CBO | Enabled | Disabled | Low |
362
- | T21 | Creative | Spark Ads | Active | None | Medium |
363
- | T22 | Attribution | Window | 7d Click / 1d View | Default | Low |
364
- | T23 | Technical | Parameters | Value/Currency Passed | Missing | Medium |
365
- | T24 | Creative | Resolution | ≥ 720p <sup>15</sup> | < 720p | Low |
366
- | T25 | Structure | Budget Util. | > 80% (Ready to scale) | < 50% (Delivery issue) | Low |
367
-
368
- ---
369
-
370
- ## 7. Microsoft Ads Audit Checklist: The Import Hygiene
371
-
372
- Microsoft Ads (Bing) is frequently managed via "Import from Google," which introduces specific failure modes. The most critical audit check is "Syndication on Brand." Microsoft's search partners (Syndication) can generate high-volume, low-quality traffic. Unlike Google, where partners are often benign, on Microsoft, enabling partners on Brand campaigns can lead to massive budget waste on irrelevant queries.<sup>16</sup>
373
-
374
- **Table 14: Microsoft Ads Audit Checklist**
375
-
376
- | Check # | Category | Check Name | Pass Criteria | Fail Criteria | Severity |
377
- |---------|----------|------------|---------------|---------------|----------|
378
- | MS01 | Technical | UET Tag Health | Active / Verified | Inactive / Missing | Critical |
379
- | MS02 | Technical | Import Errors | 0 Failed Items | > 0 Failed Items | High |
380
- | MS03 | Technical | Auto-Tagging | MSCLKID Enabled | Disabled | Critical |
381
- | MS04 | Syndication | Brand Syndication | Excluded / Off <sup>16</sup> | Included / On | Critical |
382
- | MS05 | Syndication | Website Exclusions | List > 0 Domains | 0 Domains | High |
383
- | MS06 | Bidding | Bid Modifiers | Reviewed post-import | Google Defaults | Medium |
384
- | MS07 | Bidding | CPC Arbitrage | 20--30% < Google <sup>16</sup> | > Google CPC | High |
385
- | MS08 | Structure | Import Schedule | Scheduled | Manual | Medium |
386
- | MS09 | Structure | Spend Ratio | 10--30% of Google Spend | < 5% | Low |
387
- | MS10 | Audience | LinkedIn Targeting | Profile Layers Applied | None | High |
388
- | MS11 | Creative | RSA Coverage | Active | None (ETAs only) | Medium |
389
- | MS12 | Creative | Image Extensions | Active | None | Medium |
390
- | MS13 | Creative | Audience Ads Img | 1.91:1 & 1:1 Present | Missing one ratio | Medium |
391
- | MS14 | Settings | Time Zone | Correct | Incorrect (Import error) | Low |
392
- | MS15 | Settings | Location Opt | "People In" | "People Searching For" | High |
393
- | MS16 | Performance | Quality Score | > 5 | < 3 | High |
394
- | MS17 | Performance | Brand SOV | > 70% | < 50% | High |
395
- | MS18 | Attribution | Conv. Window | 30 Days <sup>16</sup> | Default | Medium |
396
- | MS19 | Extensions | Action Ext. | Active | None | Low |
397
- | MS20 | Extensions | Sitelinks | > 4 Active | < 2 | Low |
398
-
399
- ---
400
-
401
- ## 8. Conclusion: The Unified Audit Standard
402
-
403
- This technical standard provides a deterministic framework for evaluating ad account health. By strictly adhering to these 170+ pass/fail criteria, claude-ads moves beyond subjective advice to provide an objective measurement of algorithmic compliance. The scoring model ensures that critical signal failures (like EMQ < 3.0 or broken UET tags) effectively "fail" the audit, forcing user attention where it impacts revenue most. This is the baseline for high-performance, automated advertising management in the algorithmic era.
404
-
405
- ---
406
-
407
- ## Works Cited
408
-
409
- 1. How to Audit B2B Google Ads Accounts [+Free Template] - AdConversion, accessed February 10, 2026, [https://www.adconversion.com/blog/google-ads-audit](https://www.adconversion.com/blog/google-ads-audit)
410
- 2. The First 30 Days of Autonomous Google Ads: What Actually Happens - groas, accessed February 10, 2026, [https://groas.ai/post/the-first-30-days-of-autonomous-google-ads-what-actually-happens](https://groas.ai/post/the-first-30-days-of-autonomous-google-ads-what-actually-happens)
411
- 3. Helium 10 Ads Video: The First Thing Existing Sellers Should Do in Helium 10 Ads, accessed February 10, 2026, [https://kb.helium10.com/hc/en-us/articles/30452442370459-Helium-10-Ads-Video-The-First-Thing-Existing-Sellers-Should-Do-in-Helium-10-Ads](https://kb.helium10.com/hc/en-us/articles/30452442370459-Helium-10-Ads-Video-The-First-Thing-Existing-Sellers-Should-Do-in-Helium-10-Ads)
412
- 4. What Is Quality Score, And Why Is It Important? - Pepper PPC agency, accessed February 10, 2026, [https://pepper.agency/blog/what-is-quality-score-and-why-is-it-important/](https://pepper.agency/blog/what-is-quality-score-and-why-is-it-important/)
413
- 5. How to Estimate Google Ads Budget (with Examples) - Sheldon Payne, accessed February 10, 2026, [https://sheldonpayne.com/how-to-estimate-google-ads-budget/](https://sheldonpayne.com/how-to-estimate-google-ads-budget/)
414
- 6. Everything You Need to Know About Google Ads Measurement for 2024 & Beyond, accessed February 10, 2026, [https://kpplaybook.com/resources/google-ads-measurement/](https://kpplaybook.com/resources/google-ads-measurement/)
415
- 7. What is Event Match Quality (EMQ) in Facebook Ads and How to ..., accessed February 10, 2026, [https://www.customerlabs.com/blog/improve-your-event-match-quality-from-ok-to-great/](https://www.customerlabs.com/blog/improve-your-event-match-quality-from-ok-to-great/)
416
- 8. How to scale facebook ads: Proven Growth Tactics - Sprello, accessed February 10, 2026, [https://sprello.ai/blog/how-to-scale-facebook-ads](https://sprello.ai/blog/how-to-scale-facebook-ads)
417
- 9. Facebook Ads Audit: Free Template and Step-by-Step Account Checklist - Vaizle Insights, accessed February 10, 2026, [https://insights.vaizle.com/facebook-ads-audit/](https://insights.vaizle.com/facebook-ads-audit/)
418
- 10. 5 Tips to Prevent Interest-Based Audience Overlap - AdAmigo.ai Blog, accessed February 10, 2026, [https://www.adamigo.ai/blog/prevent-interest-based-audience-overlap](https://www.adamigo.ai/blog/prevent-interest-based-audience-overlap)
419
- 11. Facebook Creative Fatigue: What Is It and How to Avoid It? - inBeat Agency, accessed February 10, 2026, [https://inbeat.agency/blog/facebook-creative-fatigue](https://inbeat.agency/blog/facebook-creative-fatigue)
420
- 12. 5 Common Meta Ads Mistakes and How to Fix Them - AdAmigo.ai Blog, accessed February 10, 2026, [https://www.adamigo.ai/blog/5-common-meta-ads-mistakes-and-how-to-fix-them](https://www.adamigo.ai/blog/5-common-meta-ads-mistakes-and-how-to-fix-them)
421
- 13. Running ABM on LinkedIn -- The Ultimate Guide [Updated for 2026] - ZenABM, accessed February 10, 2026, [https://zenabm.com/blog/running-abm-on-linkedin-the-ultimate-guide](https://zenabm.com/blog/running-abm-on-linkedin-the-ultimate-guide)
422
- 14. Definitive LinkedIn Ads Optimisation Checklist Guide - Priority Pixels, accessed February 10, 2026, [https://prioritypixels.co.uk/blog/definitive-checklist-for-linkedin-ads-optimisation/](https://prioritypixels.co.uk/blog/definitive-checklist-for-linkedin-ads-optimisation/)
423
- 15. TikTok Web Auction Best Practices - TikTok For Business, accessed February 10, 2026, [https://ads.tiktok.com/business/library/TikTok_WebAuctionBestPractices.pdf](https://ads.tiktok.com/business/library/TikTok_WebAuctionBestPractices.pdf)
424
- 16. Ads on Bing: 2026 Microsoft Ads Guide | Gravitate - Gravitate Design, accessed February 10, 2026, [https://www.gravitatedesign.com/blog/ads-on-bing-microsoft-ads-guide/](https://www.gravitatedesign.com/blog/ads-on-bing-microsoft-ads-guide/)