agileflow 3.4.3 → 4.0.0-alpha.2

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