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,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/)