agileflow 3.4.2 → 4.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (766) hide show
  1. package/CHANGELOG.md +235 -494
  2. package/README.md +22 -114
  3. package/bin/agileflow.js +15 -0
  4. package/bin/hooks/pre-bash.js +35 -0
  5. package/bin/hooks/pre-compact.js +34 -0
  6. package/bin/hooks/pre-edit.js +32 -0
  7. package/bin/hooks/pre-write.js +32 -0
  8. package/bin/hooks/session-start.js +42 -0
  9. package/bin/hooks/stop.js +34 -0
  10. package/content/plugins/ads/plugin.yaml +14 -0
  11. package/content/plugins/audit/plugin.yaml +14 -0
  12. package/content/plugins/core/hooks/session-welcome.js +19 -0
  13. package/content/plugins/core/plugin.yaml +34 -0
  14. package/content/plugins/core/skills/agileflow-adr/SKILL.md +179 -0
  15. package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +144 -0
  16. package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +179 -0
  17. package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +132 -0
  18. package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +200 -0
  19. package/content/plugins/council/plugin.yaml +14 -0
  20. package/content/plugins/seo/plugin.yaml +14 -0
  21. package/package.json +29 -49
  22. package/src/cli/commands/doctor.js +159 -0
  23. package/src/cli/commands/hook.js +80 -0
  24. package/src/cli/commands/setup.js +254 -0
  25. package/src/cli/commands/status.js +47 -0
  26. package/src/cli/commands/update.js +82 -0
  27. package/src/cli/index.js +73 -0
  28. package/src/cli/wizard/ide-picker.js +57 -0
  29. package/src/cli/wizard/personalization.js +64 -0
  30. package/src/cli/wizard/plugin-picker.js +106 -0
  31. package/src/lib/hash.js +41 -0
  32. package/src/runtime/config/defaults.js +45 -0
  33. package/src/runtime/config/loader.js +118 -0
  34. package/src/runtime/config/schema.json +76 -0
  35. package/src/runtime/config/writer.js +54 -0
  36. package/src/runtime/hooks/aggregator.js +133 -0
  37. package/src/runtime/hooks/chain.js +93 -0
  38. package/src/runtime/hooks/logger.js +68 -0
  39. package/src/runtime/hooks/manifest-loader.js +228 -0
  40. package/src/runtime/hooks/orchestrator.js +322 -0
  41. package/src/runtime/ide/capabilities.js +111 -0
  42. package/src/runtime/ide/claude-code-settings.js +234 -0
  43. package/src/runtime/ide/claude-code-skills.js +202 -0
  44. package/src/runtime/installer/file-index.js +112 -0
  45. package/src/runtime/installer/install.js +306 -0
  46. package/src/runtime/installer/stash.js +61 -0
  47. package/src/runtime/installer/sync-engine.js +205 -0
  48. package/src/runtime/plugins/registry.js +132 -0
  49. package/src/runtime/plugins/resolver.js +138 -0
  50. package/src/runtime/plugins/validator.js +196 -0
  51. package/src/runtime/skills/validator.js +335 -0
  52. package/lib/README.md +0 -178
  53. package/lib/api-routes.js +0 -625
  54. package/lib/api-server.js +0 -278
  55. package/lib/cache-provider.js +0 -155
  56. package/lib/claude-cli-bridge.js +0 -215
  57. package/lib/codebase-indexer.js +0 -819
  58. package/lib/colors.generated.js +0 -117
  59. package/lib/colors.js +0 -341
  60. package/lib/consent.js +0 -232
  61. package/lib/content-sanitizer.js +0 -464
  62. package/lib/correlation.js +0 -277
  63. package/lib/dashboard-automations.js +0 -130
  64. package/lib/dashboard-git.js +0 -254
  65. package/lib/dashboard-inbox.js +0 -64
  66. package/lib/dashboard-protocol.js +0 -605
  67. package/lib/dashboard-server.js +0 -1296
  68. package/lib/dashboard-session.js +0 -136
  69. package/lib/dashboard-status.js +0 -72
  70. package/lib/dashboard-terminal.js +0 -354
  71. package/lib/dashboard-websocket.js +0 -88
  72. package/lib/drivers/claude-driver.ts +0 -312
  73. package/lib/drivers/codex-driver.ts +0 -464
  74. package/lib/drivers/driver-manager.ts +0 -159
  75. package/lib/drivers/gemini-driver.ts +0 -498
  76. package/lib/drivers/index.ts +0 -17
  77. package/lib/error-codes.js +0 -590
  78. package/lib/errors.js +0 -670
  79. package/lib/feature-flags.js +0 -171
  80. package/lib/feedback.js +0 -595
  81. package/lib/file-cache.js +0 -541
  82. package/lib/flag-detection.js +0 -344
  83. package/lib/format-error.js +0 -156
  84. package/lib/gate-runner.js +0 -282
  85. package/lib/generator-factory.js +0 -333
  86. package/lib/git-operations.js +0 -266
  87. package/lib/lazy-require.js +0 -59
  88. package/lib/lock-file.js +0 -144
  89. package/lib/logger.js +0 -106
  90. package/lib/merge-operations.js +0 -1006
  91. package/lib/path-resolver.js +0 -544
  92. package/lib/path-utils.js +0 -49
  93. package/lib/paths.js +0 -291
  94. package/lib/placeholder-registry.js +0 -822
  95. package/lib/process-executor.js +0 -214
  96. package/lib/progress.js +0 -334
  97. package/lib/protocol/driver.ts +0 -354
  98. package/lib/protocol/index.ts +0 -12
  99. package/lib/protocol/ir.ts +0 -271
  100. package/lib/registry-cache.js +0 -80
  101. package/lib/registry-di.js +0 -358
  102. package/lib/result-schema.js +0 -363
  103. package/lib/result.js +0 -210
  104. package/lib/session-display.js +0 -331
  105. package/lib/session-operations.js +0 -611
  106. package/lib/session-registry.js +0 -484
  107. package/lib/session-state-machine.js +0 -465
  108. package/lib/session-switching.js +0 -191
  109. package/lib/skill-loader.js +0 -213
  110. package/lib/smart-json-file.js +0 -682
  111. package/lib/state-machine.js +0 -286
  112. package/lib/table-formatter.js +0 -519
  113. package/lib/template-loader.js +0 -143
  114. package/lib/transient-status.js +0 -374
  115. package/lib/ui-manager.js +0 -612
  116. package/lib/validate-args.js +0 -213
  117. package/lib/validate-commands.js +0 -308
  118. package/lib/validate-names.js +0 -143
  119. package/lib/validate-paths.js +0 -434
  120. package/lib/validate.js +0 -134
  121. package/lib/worktree-operations.js +0 -201
  122. package/lib/yaml-utils.js +0 -164
  123. package/scripts/README.md +0 -267
  124. package/scripts/af +0 -34
  125. package/scripts/agent-loop.js +0 -819
  126. package/scripts/agileflow-configure.js +0 -368
  127. package/scripts/agileflow-statusline.sh +0 -857
  128. package/scripts/agileflow-welcome.js +0 -2246
  129. package/scripts/api-server-runner.js +0 -177
  130. package/scripts/archive-completed-stories.sh +0 -308
  131. package/scripts/auto-self-improve.js +0 -326
  132. package/scripts/automation-run-due.js +0 -128
  133. package/scripts/babysit-clear-restore.js +0 -154
  134. package/scripts/babysit-context-restore.js +0 -89
  135. package/scripts/backfill-ideation-status.js +0 -128
  136. package/scripts/batch-pmap-loop.js +0 -551
  137. package/scripts/check-update.js +0 -282
  138. package/scripts/ci-summary.js +0 -294
  139. package/scripts/claude-smart.sh +0 -85
  140. package/scripts/claude-tmux.sh +0 -737
  141. package/scripts/claude-watchdog.sh +0 -225
  142. package/scripts/clear-active-command.js +0 -48
  143. package/scripts/compress-status.sh +0 -116
  144. package/scripts/context-loader.js +0 -310
  145. package/scripts/damage-control/bash-tool-damage-control.js +0 -22
  146. package/scripts/damage-control/edit-tool-damage-control.js +0 -19
  147. package/scripts/damage-control/patterns.yaml +0 -227
  148. package/scripts/damage-control/write-tool-damage-control.js +0 -19
  149. package/scripts/damage-control-bash.js +0 -51
  150. package/scripts/damage-control-edit.js +0 -48
  151. package/scripts/damage-control-multi-agent.js +0 -231
  152. package/scripts/damage-control-write.js +0 -48
  153. package/scripts/dashboard-serve.js +0 -336
  154. package/scripts/dependency-check.js +0 -311
  155. package/scripts/document-repl.js +0 -793
  156. package/scripts/expertise-metrics.sh +0 -264
  157. package/scripts/generate-all.sh +0 -77
  158. package/scripts/generate-colors.js +0 -314
  159. package/scripts/generators/agent-registry.js +0 -183
  160. package/scripts/generators/command-registry.js +0 -166
  161. package/scripts/generators/index.js +0 -85
  162. package/scripts/generators/inject-babysit.js +0 -191
  163. package/scripts/generators/inject-help.js +0 -125
  164. package/scripts/generators/inject-readme.js +0 -166
  165. package/scripts/generators/skill-registry.js +0 -188
  166. package/scripts/get-env.js +0 -225
  167. package/scripts/init.sh +0 -76
  168. package/scripts/lib/README-portable-tasks.md +0 -424
  169. package/scripts/lib/ac-test-matcher.js +0 -452
  170. package/scripts/lib/audit-cleanup.js +0 -250
  171. package/scripts/lib/audit-registry.js +0 -340
  172. package/scripts/lib/automation-registry.js +0 -544
  173. package/scripts/lib/automation-runner.js +0 -476
  174. package/scripts/lib/browser-qa-evidence.js +0 -409
  175. package/scripts/lib/browser-qa-status.js +0 -192
  176. package/scripts/lib/bus-utils.js +0 -473
  177. package/scripts/lib/colors.generated.sh +0 -82
  178. package/scripts/lib/colors.sh +0 -46
  179. package/scripts/lib/command-prereqs.js +0 -280
  180. package/scripts/lib/concurrency-limiter.js +0 -511
  181. package/scripts/lib/configure-detect.js +0 -596
  182. package/scripts/lib/configure-features.js +0 -1927
  183. package/scripts/lib/configure-repair.js +0 -327
  184. package/scripts/lib/configure-utils.js +0 -114
  185. package/scripts/lib/context-formatter.js +0 -1158
  186. package/scripts/lib/context-loader.js +0 -840
  187. package/scripts/lib/counter.js +0 -103
  188. package/scripts/lib/damage-control-utils.js +0 -619
  189. package/scripts/lib/feature-catalog.js +0 -332
  190. package/scripts/lib/file-lock.js +0 -392
  191. package/scripts/lib/file-tracking.js +0 -735
  192. package/scripts/lib/frontmatter-parser.js +0 -133
  193. package/scripts/lib/gate-enforcer.js +0 -295
  194. package/scripts/lib/hook-metrics.js +0 -324
  195. package/scripts/lib/ideation-index.js +0 -1205
  196. package/scripts/lib/json-utils.sh +0 -162
  197. package/scripts/lib/lifecycle-detector.js +0 -125
  198. package/scripts/lib/model-profiles.js +0 -118
  199. package/scripts/lib/portable-tasks-cli.js +0 -274
  200. package/scripts/lib/portable-tasks.js +0 -479
  201. package/scripts/lib/process-cleanup.js +0 -527
  202. package/scripts/lib/quality-gates.js +0 -761
  203. package/scripts/lib/scale-detector.js +0 -396
  204. package/scripts/lib/sessionRegistry.js +0 -678
  205. package/scripts/lib/signal-detectors.js +0 -880
  206. package/scripts/lib/skill-catalog.js +0 -557
  207. package/scripts/lib/skill-recommender.js +0 -311
  208. package/scripts/lib/state-migrator.js +0 -353
  209. package/scripts/lib/status-task-bridge.js +0 -522
  210. package/scripts/lib/status-writer.js +0 -255
  211. package/scripts/lib/story-claiming.js +0 -704
  212. package/scripts/lib/story-state-machine.js +0 -437
  213. package/scripts/lib/sync-ideation-status.js +0 -291
  214. package/scripts/lib/task-registry-cache.js +0 -490
  215. package/scripts/lib/task-registry.js +0 -1191
  216. package/scripts/lib/task-sync.js +0 -230
  217. package/scripts/lib/tdd-phase-manager.js +0 -455
  218. package/scripts/lib/team-events.js +0 -510
  219. package/scripts/lib/tmux-audit-monitor.js +0 -611
  220. package/scripts/lib/tmux-group-colors.js +0 -113
  221. package/scripts/lib/tool-registry.yaml +0 -241
  222. package/scripts/lib/tool-shed.js +0 -441
  223. package/scripts/lib/validation-registry.js +0 -177
  224. package/scripts/messaging-bridge.js +0 -561
  225. package/scripts/migrate-ideation-index.js +0 -553
  226. package/scripts/native-team-observer.js +0 -219
  227. package/scripts/obtain-context.js +0 -272
  228. package/scripts/pre-push-check.sh +0 -46
  229. package/scripts/precompact-context.sh +0 -306
  230. package/scripts/query-codebase.js +0 -543
  231. package/scripts/ralph-loop.js +0 -1278
  232. package/scripts/resume-session.sh +0 -121
  233. package/scripts/screenshot-verifier.js +0 -215
  234. package/scripts/session-boundary.js +0 -138
  235. package/scripts/session-coordinator.sh +0 -232
  236. package/scripts/session-manager.js +0 -546
  237. package/scripts/smart-detect.js +0 -449
  238. package/scripts/spawn-audit-sessions.js +0 -877
  239. package/scripts/spawn-parallel.js +0 -751
  240. package/scripts/strip-ai-attribution.js +0 -63
  241. package/scripts/task-completed-gate.js +0 -237
  242. package/scripts/team-manager.js +0 -596
  243. package/scripts/team-status-display.js +0 -200
  244. package/scripts/teammate-idle-gate.js +0 -237
  245. package/scripts/test-session-boundary.js +0 -80
  246. package/scripts/tmux-close-windows.sh +0 -180
  247. package/scripts/tmux-restore-window.sh +0 -67
  248. package/scripts/tmux-save-closed-window.sh +0 -35
  249. package/scripts/tui/App.js +0 -151
  250. package/scripts/tui/Dashboard.js +0 -277
  251. package/scripts/tui/blessed/data/watcher.js +0 -180
  252. package/scripts/tui/blessed/index.js +0 -244
  253. package/scripts/tui/blessed/panels/output.js +0 -101
  254. package/scripts/tui/blessed/panels/sessions.js +0 -150
  255. package/scripts/tui/blessed/panels/trace.js +0 -97
  256. package/scripts/tui/blessed/ui/help.js +0 -77
  257. package/scripts/tui/blessed/ui/screen.js +0 -52
  258. package/scripts/tui/blessed/ui/statusbar.js +0 -47
  259. package/scripts/tui/blessed/ui/tabbar.js +0 -99
  260. package/scripts/tui/index.js +0 -70
  261. package/scripts/tui/lib/crashRecovery.js +0 -304
  262. package/scripts/tui/lib/eventStream.js +0 -309
  263. package/scripts/tui/lib/keyboard.js +0 -261
  264. package/scripts/tui/lib/loopControl.js +0 -371
  265. package/scripts/tui/panels/OutputPanel.js +0 -240
  266. package/scripts/tui/panels/SessionPanel.js +0 -170
  267. package/scripts/tui/panels/TracePanel.js +0 -298
  268. package/scripts/tui/simple-tui.js +0 -510
  269. package/scripts/validate-expertise.sh +0 -263
  270. package/scripts/validate-tokens.sh +0 -73
  271. package/scripts/validators/README.md +0 -143
  272. package/scripts/validators/component-validator.js +0 -239
  273. package/scripts/validators/json-schema-validator.js +0 -186
  274. package/scripts/validators/markdown-validator.js +0 -152
  275. package/scripts/validators/migration-validator.js +0 -129
  276. package/scripts/validators/security-validator.js +0 -380
  277. package/scripts/validators/story-format-validator.js +0 -197
  278. package/scripts/validators/test-result-validator.js +0 -114
  279. package/scripts/validators/workflow-validator.js +0 -247
  280. package/scripts/welcome-deferred.js +0 -437
  281. package/scripts/worktree-create.sh +0 -111
  282. package/src/core/agents/a11y-analyzer-aria.md +0 -155
  283. package/src/core/agents/a11y-analyzer-forms.md +0 -162
  284. package/src/core/agents/a11y-analyzer-keyboard.md +0 -175
  285. package/src/core/agents/a11y-analyzer-semantic.md +0 -153
  286. package/src/core/agents/a11y-analyzer-visual.md +0 -158
  287. package/src/core/agents/a11y-consensus.md +0 -248
  288. package/src/core/agents/accessibility.md +0 -515
  289. package/src/core/agents/adr-writer.md +0 -463
  290. package/src/core/agents/ads-audit-budget.md +0 -181
  291. package/src/core/agents/ads-audit-compliance.md +0 -169
  292. package/src/core/agents/ads-audit-creative.md +0 -164
  293. package/src/core/agents/ads-audit-google.md +0 -226
  294. package/src/core/agents/ads-audit-meta.md +0 -183
  295. package/src/core/agents/ads-audit-tracking.md +0 -197
  296. package/src/core/agents/ads-consensus.md +0 -396
  297. package/src/core/agents/ads-generate.md +0 -145
  298. package/src/core/agents/ads-performance-tracker.md +0 -197
  299. package/src/core/agents/analytics.md +0 -617
  300. package/src/core/agents/api-quality-analyzer-conventions.md +0 -148
  301. package/src/core/agents/api-quality-analyzer-docs.md +0 -176
  302. package/src/core/agents/api-quality-analyzer-errors.md +0 -183
  303. package/src/core/agents/api-quality-analyzer-pagination.md +0 -171
  304. package/src/core/agents/api-quality-analyzer-versioning.md +0 -143
  305. package/src/core/agents/api-quality-consensus.md +0 -214
  306. package/src/core/agents/api-validator.md +0 -183
  307. package/src/core/agents/api.md +0 -665
  308. package/src/core/agents/arch-analyzer-circular.md +0 -148
  309. package/src/core/agents/arch-analyzer-complexity.md +0 -171
  310. package/src/core/agents/arch-analyzer-coupling.md +0 -146
  311. package/src/core/agents/arch-analyzer-layering.md +0 -151
  312. package/src/core/agents/arch-analyzer-patterns.md +0 -162
  313. package/src/core/agents/arch-consensus.md +0 -227
  314. package/src/core/agents/brainstorm-analyzer-features.md +0 -169
  315. package/src/core/agents/brainstorm-analyzer-growth.md +0 -161
  316. package/src/core/agents/brainstorm-analyzer-integration.md +0 -172
  317. package/src/core/agents/brainstorm-analyzer-market.md +0 -147
  318. package/src/core/agents/brainstorm-analyzer-ux.md +0 -167
  319. package/src/core/agents/brainstorm-consensus.md +0 -237
  320. package/src/core/agents/browser-qa.md +0 -328
  321. package/src/core/agents/ci.md +0 -511
  322. package/src/core/agents/code-reviewer.md +0 -288
  323. package/src/core/agents/codebase-query.md +0 -266
  324. package/src/core/agents/completeness-analyzer-api.md +0 -190
  325. package/src/core/agents/completeness-analyzer-conditional.md +0 -201
  326. package/src/core/agents/completeness-analyzer-handlers.md +0 -159
  327. package/src/core/agents/completeness-analyzer-imports.md +0 -159
  328. package/src/core/agents/completeness-analyzer-routes.md +0 -182
  329. package/src/core/agents/completeness-analyzer-state.md +0 -188
  330. package/src/core/agents/completeness-analyzer-stubs.md +0 -198
  331. package/src/core/agents/completeness-consensus.md +0 -286
  332. package/src/core/agents/compliance.md +0 -509
  333. package/src/core/agents/council-advocate.md +0 -206
  334. package/src/core/agents/council-analyst.md +0 -252
  335. package/src/core/agents/council-optimist.md +0 -170
  336. package/src/core/agents/database.md +0 -601
  337. package/src/core/agents/datamigration.md +0 -699
  338. package/src/core/agents/design.md +0 -525
  339. package/src/core/agents/devops.md +0 -720
  340. package/src/core/agents/documentation.md +0 -504
  341. package/src/core/agents/epic-planner.md +0 -480
  342. package/src/core/agents/error-analyzer.md +0 -201
  343. package/src/core/agents/integrations.md +0 -603
  344. package/src/core/agents/legal-analyzer-a11y.md +0 -110
  345. package/src/core/agents/legal-analyzer-ai.md +0 -117
  346. package/src/core/agents/legal-analyzer-consumer.md +0 -108
  347. package/src/core/agents/legal-analyzer-content.md +0 -113
  348. package/src/core/agents/legal-analyzer-international.md +0 -115
  349. package/src/core/agents/legal-analyzer-licensing.md +0 -115
  350. package/src/core/agents/legal-analyzer-privacy.md +0 -108
  351. package/src/core/agents/legal-analyzer-security.md +0 -112
  352. package/src/core/agents/legal-analyzer-terms.md +0 -111
  353. package/src/core/agents/legal-consensus.md +0 -242
  354. package/src/core/agents/logic-analyzer-edge.md +0 -170
  355. package/src/core/agents/logic-analyzer-flow.md +0 -253
  356. package/src/core/agents/logic-analyzer-invariant.md +0 -206
  357. package/src/core/agents/logic-analyzer-race.md +0 -266
  358. package/src/core/agents/logic-analyzer-type.md +0 -217
  359. package/src/core/agents/logic-consensus.md +0 -253
  360. package/src/core/agents/mentor.md +0 -654
  361. package/src/core/agents/mobile.md +0 -501
  362. package/src/core/agents/monitoring.md +0 -537
  363. package/src/core/agents/multi-expert.md +0 -311
  364. package/src/core/agents/orchestrator.md +0 -749
  365. package/src/core/agents/perf-analyzer-assets.md +0 -174
  366. package/src/core/agents/perf-analyzer-bundle.md +0 -165
  367. package/src/core/agents/perf-analyzer-caching.md +0 -160
  368. package/src/core/agents/perf-analyzer-compute.md +0 -165
  369. package/src/core/agents/perf-analyzer-memory.md +0 -182
  370. package/src/core/agents/perf-analyzer-network.md +0 -157
  371. package/src/core/agents/perf-analyzer-queries.md +0 -155
  372. package/src/core/agents/perf-analyzer-rendering.md +0 -156
  373. package/src/core/agents/perf-consensus.md +0 -280
  374. package/src/core/agents/performance.md +0 -492
  375. package/src/core/agents/product.md +0 -535
  376. package/src/core/agents/qa.md +0 -765
  377. package/src/core/agents/readme-updater.md +0 -579
  378. package/src/core/agents/refactor.md +0 -558
  379. package/src/core/agents/research.md +0 -453
  380. package/src/core/agents/rlm-subcore.md +0 -207
  381. package/src/core/agents/schema-validator.md +0 -454
  382. package/src/core/agents/security-analyzer-api.md +0 -199
  383. package/src/core/agents/security-analyzer-auth.md +0 -160
  384. package/src/core/agents/security-analyzer-authz.md +0 -168
  385. package/src/core/agents/security-analyzer-deps.md +0 -147
  386. package/src/core/agents/security-analyzer-infra.md +0 -176
  387. package/src/core/agents/security-analyzer-injection.md +0 -148
  388. package/src/core/agents/security-analyzer-input.md +0 -191
  389. package/src/core/agents/security-analyzer-secrets.md +0 -175
  390. package/src/core/agents/security-consensus.md +0 -276
  391. package/src/core/agents/security.md +0 -486
  392. package/src/core/agents/seo-analyzer-content.md +0 -167
  393. package/src/core/agents/seo-analyzer-images.md +0 -187
  394. package/src/core/agents/seo-analyzer-performance.md +0 -206
  395. package/src/core/agents/seo-analyzer-schema.md +0 -176
  396. package/src/core/agents/seo-analyzer-sitemap.md +0 -172
  397. package/src/core/agents/seo-analyzer-technical.md +0 -144
  398. package/src/core/agents/seo-consensus.md +0 -289
  399. package/src/core/agents/team-coordinator.md +0 -333
  400. package/src/core/agents/team-lead.md +0 -171
  401. package/src/core/agents/test-analyzer-assertions.md +0 -181
  402. package/src/core/agents/test-analyzer-coverage.md +0 -183
  403. package/src/core/agents/test-analyzer-fragility.md +0 -185
  404. package/src/core/agents/test-analyzer-integration.md +0 -155
  405. package/src/core/agents/test-analyzer-maintenance.md +0 -173
  406. package/src/core/agents/test-analyzer-mocking.md +0 -178
  407. package/src/core/agents/test-analyzer-patterns.md +0 -189
  408. package/src/core/agents/test-analyzer-structure.md +0 -177
  409. package/src/core/agents/test-consensus.md +0 -294
  410. package/src/core/agents/testing.md +0 -527
  411. package/src/core/agents/ui-validator.md +0 -331
  412. package/src/core/agents/ui.md +0 -1227
  413. package/src/core/commands/adr/list.md +0 -191
  414. package/src/core/commands/adr/update.md +0 -258
  415. package/src/core/commands/adr/view.md +0 -274
  416. package/src/core/commands/adr.md +0 -394
  417. package/src/core/commands/ads/audit.md +0 -437
  418. package/src/core/commands/ads/budget.md +0 -97
  419. package/src/core/commands/ads/competitor.md +0 -112
  420. package/src/core/commands/ads/creative.md +0 -85
  421. package/src/core/commands/ads/generate.md +0 -238
  422. package/src/core/commands/ads/google.md +0 -112
  423. package/src/core/commands/ads/health.md +0 -327
  424. package/src/core/commands/ads/landing.md +0 -119
  425. package/src/core/commands/ads/linkedin.md +0 -112
  426. package/src/core/commands/ads/meta.md +0 -91
  427. package/src/core/commands/ads/microsoft.md +0 -115
  428. package/src/core/commands/ads/plan.md +0 -321
  429. package/src/core/commands/ads/test-plan.md +0 -317
  430. package/src/core/commands/ads/tiktok.md +0 -129
  431. package/src/core/commands/ads/track.md +0 -288
  432. package/src/core/commands/ads/youtube.md +0 -124
  433. package/src/core/commands/ads.md +0 -140
  434. package/src/core/commands/agent.md +0 -256
  435. package/src/core/commands/api.md +0 -267
  436. package/src/core/commands/assign.md +0 -369
  437. package/src/core/commands/audit.md +0 -531
  438. package/src/core/commands/auto.md +0 -556
  439. package/src/core/commands/automate.md +0 -415
  440. package/src/core/commands/babysit.md +0 -643
  441. package/src/core/commands/baseline.md +0 -743
  442. package/src/core/commands/batch.md +0 -551
  443. package/src/core/commands/blockers.md +0 -602
  444. package/src/core/commands/board.md +0 -509
  445. package/src/core/commands/browser-qa.md +0 -240
  446. package/src/core/commands/changelog.md +0 -582
  447. package/src/core/commands/choose.md +0 -430
  448. package/src/core/commands/ci.md +0 -330
  449. package/src/core/commands/code/accessibility.md +0 -347
  450. package/src/core/commands/code/api.md +0 -297
  451. package/src/core/commands/code/architecture.md +0 -297
  452. package/src/core/commands/code/completeness.md +0 -503
  453. package/src/core/commands/code/legal.md +0 -493
  454. package/src/core/commands/code/logic.md +0 -416
  455. package/src/core/commands/code/performance.md +0 -490
  456. package/src/core/commands/code/security.md +0 -493
  457. package/src/core/commands/code/test.md +0 -489
  458. package/src/core/commands/compress.md +0 -408
  459. package/src/core/commands/configure.md +0 -1159
  460. package/src/core/commands/context/export.md +0 -296
  461. package/src/core/commands/context/full.md +0 -353
  462. package/src/core/commands/context/note.md +0 -380
  463. package/src/core/commands/council.md +0 -592
  464. package/src/core/commands/debt.md +0 -491
  465. package/src/core/commands/deploy.md +0 -864
  466. package/src/core/commands/deps.md +0 -728
  467. package/src/core/commands/diagnose.md +0 -404
  468. package/src/core/commands/docs.md +0 -469
  469. package/src/core/commands/epic/edit.md +0 -213
  470. package/src/core/commands/epic/list.md +0 -190
  471. package/src/core/commands/epic/view.md +0 -267
  472. package/src/core/commands/epic.md +0 -477
  473. package/src/core/commands/export.md +0 -238
  474. package/src/core/commands/feedback.md +0 -603
  475. package/src/core/commands/handoff.md +0 -386
  476. package/src/core/commands/help.md +0 -194
  477. package/src/core/commands/ideate/brief.md +0 -363
  478. package/src/core/commands/ideate/discover.md +0 -399
  479. package/src/core/commands/ideate/features.md +0 -496
  480. package/src/core/commands/ideate/history.md +0 -403
  481. package/src/core/commands/ideate/new.md +0 -899
  482. package/src/core/commands/impact.md +0 -407
  483. package/src/core/commands/install.md +0 -529
  484. package/src/core/commands/learn/explain.md +0 -118
  485. package/src/core/commands/learn/glossary.md +0 -135
  486. package/src/core/commands/learn/patterns.md +0 -138
  487. package/src/core/commands/learn/tour.md +0 -126
  488. package/src/core/commands/maintain.md +0 -558
  489. package/src/core/commands/metrics.md +0 -844
  490. package/src/core/commands/migrate/codemods.md +0 -151
  491. package/src/core/commands/migrate/plan.md +0 -131
  492. package/src/core/commands/migrate/scan.md +0 -114
  493. package/src/core/commands/migrate/validate.md +0 -119
  494. package/src/core/commands/multi-expert.md +0 -447
  495. package/src/core/commands/packages.md +0 -535
  496. package/src/core/commands/pr.md +0 -337
  497. package/src/core/commands/readme-sync.md +0 -329
  498. package/src/core/commands/research/analyze.md +0 -798
  499. package/src/core/commands/research/ask.md +0 -864
  500. package/src/core/commands/research/import.md +0 -1025
  501. package/src/core/commands/research/list.md +0 -273
  502. package/src/core/commands/research/synthesize.md +0 -928
  503. package/src/core/commands/research/view.md +0 -323
  504. package/src/core/commands/retro.md +0 -795
  505. package/src/core/commands/review.md +0 -694
  506. package/src/core/commands/rlm.md +0 -446
  507. package/src/core/commands/roadmap/analyze.md +0 -400
  508. package/src/core/commands/rpi.md +0 -633
  509. package/src/core/commands/seo/audit.md +0 -428
  510. package/src/core/commands/seo/competitor.md +0 -174
  511. package/src/core/commands/seo/content.md +0 -107
  512. package/src/core/commands/seo/geo.md +0 -229
  513. package/src/core/commands/seo/hreflang.md +0 -140
  514. package/src/core/commands/seo/images.md +0 -96
  515. package/src/core/commands/seo/page.md +0 -198
  516. package/src/core/commands/seo/plan.md +0 -163
  517. package/src/core/commands/seo/programmatic.md +0 -131
  518. package/src/core/commands/seo/references/cwv-thresholds.md +0 -64
  519. package/src/core/commands/seo/references/eeat-framework.md +0 -110
  520. package/src/core/commands/seo/references/quality-gates.md +0 -91
  521. package/src/core/commands/seo/references/schema-types.md +0 -102
  522. package/src/core/commands/seo/schema.md +0 -183
  523. package/src/core/commands/seo/sitemap.md +0 -97
  524. package/src/core/commands/seo/technical.md +0 -100
  525. package/src/core/commands/seo.md +0 -107
  526. package/src/core/commands/serve.md +0 -127
  527. package/src/core/commands/session/cleanup.md +0 -452
  528. package/src/core/commands/session/end.md +0 -865
  529. package/src/core/commands/session/history.md +0 -293
  530. package/src/core/commands/session/init.md +0 -210
  531. package/src/core/commands/session/new.md +0 -827
  532. package/src/core/commands/session/resume.md +0 -291
  533. package/src/core/commands/session/spawn.md +0 -205
  534. package/src/core/commands/session/status.md +0 -274
  535. package/src/core/commands/skill/list.md +0 -139
  536. package/src/core/commands/skill/recommend.md +0 -216
  537. package/src/core/commands/sprint.md +0 -714
  538. package/src/core/commands/status/undo.md +0 -191
  539. package/src/core/commands/status.md +0 -423
  540. package/src/core/commands/story/edit.md +0 -204
  541. package/src/core/commands/story/list.md +0 -199
  542. package/src/core/commands/story/view.md +0 -312
  543. package/src/core/commands/story-validate.md +0 -491
  544. package/src/core/commands/story.md +0 -465
  545. package/src/core/commands/tdd-next.md +0 -238
  546. package/src/core/commands/tdd.md +0 -211
  547. package/src/core/commands/team/guide.md +0 -688
  548. package/src/core/commands/team/list.md +0 -59
  549. package/src/core/commands/team/start.md +0 -130
  550. package/src/core/commands/team/status.md +0 -66
  551. package/src/core/commands/team/stop.md +0 -78
  552. package/src/core/commands/template.md +0 -644
  553. package/src/core/commands/tests.md +0 -731
  554. package/src/core/commands/update.md +0 -591
  555. package/src/core/commands/validate-expertise.md +0 -305
  556. package/src/core/commands/velocity.md +0 -630
  557. package/src/core/commands/verify.md +0 -534
  558. package/src/core/commands/whats-new.md +0 -201
  559. package/src/core/commands/workflow.md +0 -449
  560. package/src/core/council/sessions/.gitkeep +0 -0
  561. package/src/core/council/shared_reasoning.template.md +0 -106
  562. package/src/core/experts/README.md +0 -236
  563. package/src/core/experts/_core-expertise.yaml +0 -105
  564. package/src/core/experts/accessibility/expertise.yaml +0 -115
  565. package/src/core/experts/accessibility/question.md +0 -41
  566. package/src/core/experts/accessibility/self-improve.md +0 -45
  567. package/src/core/experts/accessibility/workflow.md +0 -59
  568. package/src/core/experts/adr-writer/expertise.yaml +0 -138
  569. package/src/core/experts/adr-writer/question.md +0 -56
  570. package/src/core/experts/adr-writer/self-improve.md +0 -106
  571. package/src/core/experts/adr-writer/workflow.md +0 -184
  572. package/src/core/experts/analytics/expertise.yaml +0 -119
  573. package/src/core/experts/analytics/question.md +0 -74
  574. package/src/core/experts/analytics/self-improve.md +0 -163
  575. package/src/core/experts/analytics/workflow.md +0 -272
  576. package/src/core/experts/api/expertise.yaml +0 -124
  577. package/src/core/experts/api/question.md +0 -74
  578. package/src/core/experts/api/self-improve.md +0 -122
  579. package/src/core/experts/api/workflow.md +0 -248
  580. package/src/core/experts/ci/expertise.yaml +0 -106
  581. package/src/core/experts/ci/question.md +0 -69
  582. package/src/core/experts/ci/self-improve.md +0 -100
  583. package/src/core/experts/ci/workflow.md +0 -145
  584. package/src/core/experts/codebase-query/expertise.yaml +0 -121
  585. package/src/core/experts/codebase-query/question.md +0 -73
  586. package/src/core/experts/codebase-query/self-improve.md +0 -105
  587. package/src/core/experts/compliance/expertise.yaml +0 -101
  588. package/src/core/experts/compliance/question.md +0 -56
  589. package/src/core/experts/compliance/self-improve.md +0 -106
  590. package/src/core/experts/compliance/workflow.md +0 -184
  591. package/src/core/experts/database/expertise.yaml +0 -109
  592. package/src/core/experts/database/question.md +0 -74
  593. package/src/core/experts/database/self-improve.md +0 -121
  594. package/src/core/experts/database/workflow.md +0 -234
  595. package/src/core/experts/datamigration/expertise.yaml +0 -141
  596. package/src/core/experts/datamigration/question.md +0 -56
  597. package/src/core/experts/datamigration/self-improve.md +0 -106
  598. package/src/core/experts/datamigration/workflow.md +0 -184
  599. package/src/core/experts/design/expertise.yaml +0 -116
  600. package/src/core/experts/design/question.md +0 -56
  601. package/src/core/experts/design/self-improve.md +0 -106
  602. package/src/core/experts/design/workflow.md +0 -184
  603. package/src/core/experts/devops/expertise.yaml +0 -116
  604. package/src/core/experts/devops/question.md +0 -68
  605. package/src/core/experts/devops/self-improve.md +0 -102
  606. package/src/core/experts/devops/workflow.md +0 -142
  607. package/src/core/experts/documentation/expertise.yaml +0 -126
  608. package/src/core/experts/documentation/question.md +0 -41
  609. package/src/core/experts/documentation/self-improve.md +0 -45
  610. package/src/core/experts/documentation/workflow.md +0 -55
  611. package/src/core/experts/epic-planner/expertise.yaml +0 -144
  612. package/src/core/experts/epic-planner/question.md +0 -56
  613. package/src/core/experts/epic-planner/self-improve.md +0 -106
  614. package/src/core/experts/epic-planner/workflow.md +0 -184
  615. package/src/core/experts/integrations/expertise.yaml +0 -113
  616. package/src/core/experts/integrations/question.md +0 -74
  617. package/src/core/experts/integrations/self-improve.md +0 -151
  618. package/src/core/experts/integrations/workflow.md +0 -246
  619. package/src/core/experts/mentor/expertise.yaml +0 -125
  620. package/src/core/experts/mentor/question.md +0 -56
  621. package/src/core/experts/mentor/self-improve.md +0 -106
  622. package/src/core/experts/mentor/workflow.md +0 -184
  623. package/src/core/experts/mobile/expertise.yaml +0 -136
  624. package/src/core/experts/mobile/question.md +0 -72
  625. package/src/core/experts/mobile/self-improve.md +0 -140
  626. package/src/core/experts/mobile/workflow.md +0 -240
  627. package/src/core/experts/monitoring/expertise.yaml +0 -132
  628. package/src/core/experts/monitoring/question.md +0 -76
  629. package/src/core/experts/monitoring/self-improve.md +0 -150
  630. package/src/core/experts/monitoring/workflow.md +0 -264
  631. package/src/core/experts/performance/expertise.yaml +0 -68
  632. package/src/core/experts/performance/question.md +0 -41
  633. package/src/core/experts/performance/self-improve.md +0 -45
  634. package/src/core/experts/performance/workflow.md +0 -61
  635. package/src/core/experts/product/expertise.yaml +0 -143
  636. package/src/core/experts/product/question.md +0 -56
  637. package/src/core/experts/product/self-improve.md +0 -106
  638. package/src/core/experts/product/workflow.md +0 -184
  639. package/src/core/experts/qa/expertise.yaml +0 -110
  640. package/src/core/experts/qa/question.md +0 -56
  641. package/src/core/experts/qa/self-improve.md +0 -106
  642. package/src/core/experts/qa/workflow.md +0 -184
  643. package/src/core/experts/readme-updater/expertise.yaml +0 -141
  644. package/src/core/experts/readme-updater/question.md +0 -56
  645. package/src/core/experts/readme-updater/self-improve.md +0 -106
  646. package/src/core/experts/readme-updater/workflow.md +0 -184
  647. package/src/core/experts/refactor/expertise.yaml +0 -135
  648. package/src/core/experts/refactor/question.md +0 -41
  649. package/src/core/experts/refactor/self-improve.md +0 -45
  650. package/src/core/experts/refactor/workflow.md +0 -57
  651. package/src/core/experts/research/expertise.yaml +0 -143
  652. package/src/core/experts/research/question.md +0 -56
  653. package/src/core/experts/research/self-improve.md +0 -106
  654. package/src/core/experts/research/workflow.md +0 -184
  655. package/src/core/experts/security/expertise.yaml +0 -117
  656. package/src/core/experts/security/question.md +0 -77
  657. package/src/core/experts/security/self-improve.md +0 -102
  658. package/src/core/experts/security/workflow.md +0 -152
  659. package/src/core/experts/templates/expertise-template.yaml +0 -67
  660. package/src/core/experts/templates/question-template.md +0 -56
  661. package/src/core/experts/templates/self-improve-template.md +0 -106
  662. package/src/core/experts/templates/workflow-template.md +0 -184
  663. package/src/core/experts/testing/expertise.yaml +0 -112
  664. package/src/core/experts/testing/question.md +0 -68
  665. package/src/core/experts/testing/self-improve.md +0 -102
  666. package/src/core/experts/testing/workflow.md +0 -143
  667. package/src/core/experts/ui/expertise.yaml +0 -133
  668. package/src/core/experts/ui/question.md +0 -74
  669. package/src/core/experts/ui/self-improve.md +0 -122
  670. package/src/core/experts/ui/workflow.md +0 -262
  671. package/src/core/knowledge/ads/ad-audit-checklist-scoring.md +0 -424
  672. package/src/core/knowledge/ads/ad-optimization-logic.md +0 -590
  673. package/src/core/knowledge/ads/ad-technical-specifications.md +0 -385
  674. package/src/core/knowledge/ads/definitive-advertising-reference-2026.md +0 -506
  675. package/src/core/knowledge/ads/paid-advertising-research-2026.md +0 -445
  676. package/src/core/profiles/COMPARISON.md +0 -170
  677. package/src/core/profiles/README.md +0 -178
  678. package/src/core/profiles/claude-code.yaml +0 -111
  679. package/src/core/profiles/codex.yaml +0 -103
  680. package/src/core/profiles/cursor.yaml +0 -134
  681. package/src/core/profiles/examples.js +0 -250
  682. package/src/core/profiles/loader.js +0 -235
  683. package/src/core/profiles/windsurf.yaml +0 -159
  684. package/src/core/skills/_learnings/README.md +0 -91
  685. package/src/core/skills/_learnings/_template.yaml +0 -106
  686. package/src/core/skills/_learnings/code-review.yaml +0 -118
  687. package/src/core/skills/_learnings/commit.yaml +0 -69
  688. package/src/core/skills/_learnings/story-writer.yaml +0 -71
  689. package/src/core/teams/backend.json +0 -41
  690. package/src/core/teams/builder-validator.json +0 -51
  691. package/src/core/teams/code-review.json +0 -41
  692. package/src/core/teams/frontend.json +0 -41
  693. package/src/core/teams/fullstack.json +0 -41
  694. package/src/core/teams/logic-audit.json +0 -53
  695. package/src/core/teams/perf-audit.json +0 -71
  696. package/src/core/teams/qa.json +0 -41
  697. package/src/core/teams/security-audit.json +0 -71
  698. package/src/core/teams/solo.json +0 -35
  699. package/src/core/teams/test-audit.json +0 -71
  700. package/src/core/templates/CONTEXT.md.example +0 -49
  701. package/src/core/templates/README-template.md +0 -16
  702. package/src/core/templates/adr-template.md +0 -28
  703. package/src/core/templates/agent-coordination-pattern.md +0 -38
  704. package/src/core/templates/agent-profile-template.md +0 -51
  705. package/src/core/templates/agileflow-metadata.json +0 -150
  706. package/src/core/templates/browser-qa-spec.yaml +0 -94
  707. package/src/core/templates/ci-workflow.yml +0 -74
  708. package/src/core/templates/claude-settings.advanced.example.json +0 -75
  709. package/src/core/templates/claude-settings.example.json +0 -26
  710. package/src/core/templates/command-documentation.md +0 -187
  711. package/src/core/templates/command-prerequisites.yaml +0 -169
  712. package/src/core/templates/comms-note-template.md +0 -24
  713. package/src/core/templates/damage-control-patterns.yaml +0 -243
  714. package/src/core/templates/environment.json +0 -18
  715. package/src/core/templates/epic-template.md +0 -27
  716. package/src/core/templates/plan-template.md +0 -125
  717. package/src/core/templates/preserve-rules-common.md +0 -107
  718. package/src/core/templates/preserve-rules.json +0 -42
  719. package/src/core/templates/proactive-action-spec.md +0 -29
  720. package/src/core/templates/product-brief.md +0 -136
  721. package/src/core/templates/quality-gate-priorities.md +0 -34
  722. package/src/core/templates/research-template.md +0 -44
  723. package/src/core/templates/session-harness-protocol.md +0 -128
  724. package/src/core/templates/session-state.json +0 -56
  725. package/src/core/templates/story-lifecycle.md +0 -213
  726. package/src/core/templates/story-template.md +0 -92
  727. package/src/core/templates/tdd-test-template.js +0 -241
  728. package/src/core/templates/worktrees-guide.md +0 -231
  729. package/tools/agileflow-npx.js +0 -52
  730. package/tools/cli/agileflow-cli.js +0 -72
  731. package/tools/cli/commands/config.js +0 -285
  732. package/tools/cli/commands/doctor.js +0 -496
  733. package/tools/cli/commands/list.js +0 -385
  734. package/tools/cli/commands/serve.js +0 -492
  735. package/tools/cli/commands/session.js +0 -1176
  736. package/tools/cli/commands/setup.js +0 -255
  737. package/tools/cli/commands/status.js +0 -101
  738. package/tools/cli/commands/tui.js +0 -56
  739. package/tools/cli/commands/uninstall.js +0 -155
  740. package/tools/cli/commands/update.js +0 -299
  741. package/tools/cli/installers/core/installer.js +0 -892
  742. package/tools/cli/installers/ide/_base-ide.js +0 -518
  743. package/tools/cli/installers/ide/_interface.js +0 -238
  744. package/tools/cli/installers/ide/claude-code.js +0 -432
  745. package/tools/cli/installers/ide/codex.js +0 -426
  746. package/tools/cli/installers/ide/cursor.js +0 -217
  747. package/tools/cli/installers/ide/manager.js +0 -222
  748. package/tools/cli/installers/ide/windsurf.js +0 -282
  749. package/tools/cli/lib/command-context.js +0 -382
  750. package/tools/cli/lib/config-manager.js +0 -446
  751. package/tools/cli/lib/content-injector.js +0 -969
  752. package/tools/cli/lib/content-transformer.js +0 -496
  753. package/tools/cli/lib/docs-setup.js +0 -464
  754. package/tools/cli/lib/error-handler.js +0 -165
  755. package/tools/cli/lib/ide-error-factory.js +0 -421
  756. package/tools/cli/lib/ide-errors.js +0 -367
  757. package/tools/cli/lib/ide-generator.js +0 -357
  758. package/tools/cli/lib/ide-health-monitor.js +0 -364
  759. package/tools/cli/lib/ide-registry.js +0 -297
  760. package/tools/cli/lib/npm-utils.js +0 -103
  761. package/tools/cli/lib/self-update.js +0 -148
  762. package/tools/cli/lib/ui.js +0 -211
  763. package/tools/cli/lib/utils.js +0 -87
  764. package/tools/cli/lib/validation-middleware.js +0 -491
  765. package/tools/cli/lib/version-checker.js +0 -95
  766. package/tools/postinstall.js +0 -190
@@ -1,169 +0,0 @@
1
- ---
2
- name: ads-audit-compliance
3
- description: Cross-platform advertising compliance and performance benchmarks analyzer with 18 checks for policy adherence, regulatory requirements, and industry-standard KPIs
4
- tools: Read, Glob, Grep
5
- model: haiku
6
- team_role: utility
7
- ---
8
-
9
-
10
- # Ads Analyzer: Compliance & Benchmarks
11
-
12
- You are a specialized compliance and performance benchmarks auditor. Your job is to analyze advertising accounts for policy compliance, regulatory requirements, and performance against industry benchmarks, applying 18 deterministic checks.
13
-
14
- ---
15
-
16
- ## Your Focus Areas
17
-
18
- 1. **Platform Policy Compliance (35%)** - 6 checks
19
- 2. **Regulatory Compliance (30%)** - 5 checks
20
- 3. **Performance Benchmarks (20%)** - 4 checks
21
- 4. **Account Health (15%)** - 3 checks
22
-
23
- ---
24
-
25
- ## Analysis Process
26
-
27
- ### Category 1: Platform Policy Compliance (35% weight) - 6 checks
28
-
29
- | # | Check | Severity | Pass Criteria |
30
- |---|-------|----------|---------------|
31
- | C-PC-1 | Ad disapprovals | CRITICAL | 0 disapproved ads in active campaigns |
32
- | C-PC-2 | Special Ad Categories declared | CRITICAL | Housing/employment/credit/political categories declared when applicable |
33
- | C-PC-3 | Trademark compliance | HIGH | No unauthorized trademark use in ad copy |
34
- | C-PC-4 | Landing page policy | HIGH | Landing pages meet platform quality standards |
35
- | C-PC-5 | Prohibited content | CRITICAL | No ads for prohibited products/services |
36
- | C-PC-6 | Restricted content compliance | HIGH | Restricted content has required certifications |
37
-
38
- ### Special Ad Categories by Platform
39
-
40
- | Category | Google | Meta | LinkedIn | TikTok |
41
- |----------|--------|------|----------|--------|
42
- | Housing | Required | Required | N/A | Limited |
43
- | Employment | Required | Required | Built-in | Limited |
44
- | Credit/Financial | Required | Required | N/A | Limited |
45
- | Political | Required | Required | Prohibited | Prohibited |
46
- | Alcohol | Restricted | Restricted | Restricted | 21+ targeting |
47
- | Pharmaceuticals | Certification | Restricted | Restricted | Prohibited |
48
- | Gambling | Certification | Certification | Prohibited | Prohibited |
49
-
50
- ### Category 2: Regulatory Compliance (30% weight) - 5 checks
51
-
52
- | # | Check | Severity | Pass Criteria |
53
- |---|-------|----------|---------------|
54
- | C-RC-1 | GDPR consent implementation | CRITICAL | Consent mode active for EU traffic |
55
- | C-RC-2 | CCPA/CPRA compliance | HIGH | Limited Data Use enabled for California |
56
- | C-RC-3 | FTC disclosure requirements | HIGH | Affiliate/influencer disclosures present |
57
- | C-RC-4 | Substantiation of claims | HIGH | Performance claims backed by evidence |
58
- | C-RC-5 | Children's advertising (COPPA) | CRITICAL | No targeting of users under 13 |
59
-
60
- ### Category 3: Performance Benchmarks (20% weight) - 4 checks
61
-
62
- | # | Check | Severity | Pass Criteria |
63
- |---|-------|----------|---------------|
64
- | C-PB-1 | CTR vs industry average | MEDIUM | Within 50% of industry benchmark |
65
- | C-PB-2 | CPA vs target | HIGH | CPA within 1.5x of target |
66
- | C-PB-3 | Conversion rate vs benchmark | MEDIUM | Within 50% of industry benchmark |
67
- | C-PB-4 | ROAS vs target | HIGH | ROAS within 75% of target |
68
-
69
- ### Industry Benchmark Reference
70
-
71
- | Industry | Avg CTR (Search) | Avg CTR (Social) | Avg CPA | Avg CVR |
72
- |----------|-----------------|------------------|---------|---------|
73
- | SaaS/Tech | 3.0% | 1.2% | $75 | 3.5% |
74
- | E-commerce | 2.5% | 1.5% | $45 | 2.8% |
75
- | Healthcare | 3.2% | 0.8% | $85 | 3.0% |
76
- | Finance | 2.8% | 0.9% | $90 | 4.0% |
77
- | Education | 3.5% | 1.0% | $55 | 3.2% |
78
- | Real Estate | 2.2% | 1.1% | $65 | 2.5% |
79
- | Legal | 2.0% | 0.7% | $110 | 2.8% |
80
- | Local Services | 4.0% | 1.3% | $35 | 4.5% |
81
-
82
- ### Category 4: Account Health (15% weight) - 3 checks
83
-
84
- | # | Check | Severity | Pass Criteria |
85
- |---|-------|----------|---------------|
86
- | C-AH-1 | Account quality score | HIGH | No policy strikes or account-level warnings |
87
- | C-AH-2 | Payment method status | MEDIUM | Payment method current, no billing issues |
88
- | C-AH-3 | Account access controls | MEDIUM | MFA enabled, appropriate role assignments |
89
-
90
- ---
91
-
92
- ## Quality Gates
93
-
94
- 1. **Ad disapprovals are emergencies** - C-PC-1: Fix immediately to restore serving
95
- 2. **Special categories are legal requirements** - C-PC-2: Non-compliance = account suspension risk
96
- 3. **GDPR/CCPA violations are legal liability** - C-RC-1/C-RC-2: Legal and financial risk
97
- 4. **COPPA violations are the most serious** - C-RC-5: Federal penalties up to $50K per violation
98
-
99
- ---
100
-
101
- ## Scoring Method
102
-
103
- ```
104
- Category Score = max(0, 100 - sum(severity_deductions))
105
- Compliance Score = sum(Category Score * Category Weight)
106
- ```
107
-
108
- Severity deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
109
-
110
- ---
111
-
112
- ## Output Format
113
-
114
- For each failed check:
115
-
116
- ```markdown
117
- ### FINDING-{N}: {Check ID} - {Brief Title}
118
-
119
- **Category**: {Category Name}
120
- **Check**: {Check ID}
121
- **Severity**: CRITICAL | HIGH | MEDIUM | LOW
122
- **Confidence**: HIGH | MEDIUM | LOW
123
- **Legal Risk**: {YES/NO}
124
-
125
- **Issue**: {Clear explanation of compliance gap}
126
-
127
- **Evidence**:
128
- {Policy reference, ad data, or regulatory citation}
129
-
130
- **Impact**: {Account suspension risk, legal liability, financial penalty}
131
-
132
- **Remediation**:
133
- - {Specific compliance action}
134
- - {Timeline for resolution}
135
- - {Preventive measures}
136
- ```
137
-
138
- Final summary:
139
-
140
- ```markdown
141
- ## Compliance & Benchmarks Audit Summary
142
-
143
- | Category | Weight | Checks | Passed | Failed | Score |
144
- |----------|--------|--------|--------|--------|-------|
145
- | Platform Policy | 35% | 6 | X | Y | Z/100 |
146
- | Regulatory Compliance | 30% | 5 | X | Y | Z/100 |
147
- | Performance Benchmarks | 20% | 4 | X | Y | Z/100 |
148
- | Account Health | 15% | 3 | X | Y | Z/100 |
149
- | **Compliance Score** | **100%** | **18** | **X** | **Y** | **Z/100** |
150
-
151
- ### Quality Gate Status
152
- - [ ] No ad disapprovals: {PASS/FAIL}
153
- - [ ] Special categories declared: {PASS/FAIL}
154
- - [ ] Privacy compliance: {PASS/FAIL}
155
- - [ ] COPPA compliance: {PASS/FAIL}
156
-
157
- ### Legal Risk Items
158
- {list any findings with Legal Risk = YES}
159
- ```
160
-
161
- ---
162
-
163
- ## Important Rules
164
-
165
- 1. **Compliance is non-negotiable** - Unlike performance, compliance issues must be fixed
166
- 2. **Cite specific policies** - Reference platform policy URLs and regulatory sections
167
- 3. **Flag legal risk explicitly** - The user needs to know which findings carry legal liability
168
- 4. **Benchmark fairly** - Use industry-appropriate benchmarks, not universal averages
169
- 5. **Don't assume data** - If data for a check is unavailable, mark "Unable to verify"
@@ -1,164 +0,0 @@
1
- ---
2
- name: ads-audit-creative
3
- description: Cross-platform creative quality analyzer with 21 checks for ad copy effectiveness, visual compliance, format coverage, and performance benchmarks
4
- tools: Read, Glob, Grep
5
- model: haiku
6
- team_role: utility
7
- ---
8
-
9
-
10
- # Ads Analyzer: Creative Quality
11
-
12
- You are a specialized creative quality auditor. Your job is to analyze ad creatives across platforms, applying 21 deterministic checks for copy effectiveness, visual compliance, format coverage, and performance.
13
-
14
- ---
15
-
16
- ## Your Focus Areas
17
-
18
- 1. **Ad Copy Effectiveness (30%)** - 7 checks
19
- 2. **Visual & Format Compliance (25%)** - 6 checks
20
- 3. **Platform-Specific Requirements (25%)** - 4 checks
21
- 4. **Performance & Testing (20%)** - 4 checks
22
-
23
- ---
24
-
25
- ## Analysis Process
26
-
27
- ### Category 1: Ad Copy Effectiveness (30% weight) - 7 checks
28
-
29
- | # | Check | Severity | Pass Criteria |
30
- |---|-------|----------|---------------|
31
- | CR-CE-1 | Clear value proposition | HIGH | Primary benefit stated in first headline |
32
- | CR-CE-2 | Call-to-action present | HIGH | Every ad has a clear, specific CTA |
33
- | CR-CE-3 | Social proof inclusion | MEDIUM | Numbers, testimonials, or reviews referenced |
34
- | CR-CE-4 | Urgency/scarcity when appropriate | LOW | Time-sensitive offers have deadline language |
35
- | CR-CE-5 | Keyword-ad copy alignment | HIGH | Search ad copy contains target keywords |
36
- | CR-CE-6 | Benefit vs feature balance | MEDIUM | Benefits emphasized over features |
37
- | CR-CE-7 | Copy length optimization | MEDIUM | Platform-appropriate length (short for social, detailed for search) |
38
-
39
- ### Category 2: Visual & Format Compliance (25% weight) - 6 checks
40
-
41
- | # | Check | Severity | Pass Criteria |
42
- |---|-------|----------|---------------|
43
- | CR-VF-1 | Image resolution | HIGH | Min 1080x1080 for feed, 1080x1920 for stories |
44
- | CR-VF-2 | Text overlay < 20% | MEDIUM | Less than 20% of image area contains text |
45
- | CR-VF-3 | Brand consistency | MEDIUM | Logo, colors, fonts consistent across ads |
46
- | CR-VF-4 | Mobile-first design | HIGH | Creative designed for mobile viewing first |
47
- | CR-VF-5 | Safe zone compliance | HIGH | Key elements within platform safe zones |
48
- | CR-VF-6 | Video specifications | HIGH | Correct duration, aspect ratio, file size per platform |
49
-
50
- ### Category 3: Platform-Specific Requirements (25% weight) - 4 checks
51
-
52
- | # | Check | Severity | Pass Criteria |
53
- |---|-------|----------|---------------|
54
- | CR-PS-1 | Format coverage | HIGH | All required formats per platform (1:1, 4:5, 9:16, 16:9) |
55
- | CR-PS-2 | Platform-native style | MEDIUM | Ads feel native to platform (not repurposed) |
56
- | CR-PS-3 | Character limit compliance | HIGH | All text within platform character limits |
57
- | CR-PS-4 | Restricted content compliance | CRITICAL | No prohibited content (before/after, claims, etc.) |
58
-
59
- Platform character limits reference:
60
- | Platform | Headline | Description | Primary Text |
61
- |----------|----------|-------------|-------------|
62
- | Google RSA | 30 chars x15 | 90 chars x4 | N/A |
63
- | Meta | 40 chars | 30 chars link desc | 125 chars primary |
64
- | LinkedIn | 70 chars | 100 chars intro | 600 chars |
65
- | TikTok | 100 chars | N/A | 100 chars |
66
-
67
- ### Category 4: Performance & Testing (20% weight) - 4 checks
68
-
69
- | # | Check | Severity | Pass Criteria |
70
- |---|-------|----------|---------------|
71
- | CR-PT-1 | Creative diversity tested | HIGH | 3+ distinct concepts in active rotation |
72
- | CR-PT-2 | Winner/loser identification | HIGH | Clear performance thresholds for pausing/scaling |
73
- | CR-PT-3 | Refresh cadence | HIGH | New creatives within last 30 days |
74
- | CR-PT-4 | A/B testing methodology | MEDIUM | Controlled tests with one variable changed |
75
-
76
- ---
77
-
78
- ## Platform Safe Zones
79
-
80
- ### TikTok
81
- - Top: 130px (username + caption overlay)
82
- - Bottom: 170px (CTA button + navigation)
83
- - Right: 100px (engagement buttons)
84
- - Key content must be in center 720x900px area
85
-
86
- ### Meta Stories/Reels
87
- - Top: 250px (story header)
88
- - Bottom: 280px (CTA swipe area)
89
- - Safe area: center 1080x1420px
90
-
91
- ### YouTube
92
- - Skip button overlay: bottom-right
93
- - Info cards: top-right
94
- - Companion banner: below video on desktop
95
-
96
- ---
97
-
98
- ## Quality Gates
99
-
100
- 1. **Restricted content** - CR-PS-4: Prohibited content = immediate CRITICAL
101
- 2. **No creative = no campaign** - Must have at least 1 compliant creative per ad set
102
- 3. **Ad fatigue** - Frequency > 3.0 with declining CTR = mandatory refresh
103
-
104
- ---
105
-
106
- ## Scoring Method
107
-
108
- ```
109
- Category Score = max(0, 100 - sum(severity_deductions))
110
- Creative Score = sum(Category Score * Category Weight)
111
- ```
112
-
113
- Severity deductions: CRITICAL (-15), HIGH (-8), MEDIUM (-4), LOW (-2)
114
-
115
- ---
116
-
117
- ## Output Format
118
-
119
- For each failed check:
120
-
121
- ```markdown
122
- ### FINDING-{N}: {Check ID} - {Brief Title}
123
-
124
- **Category**: {Category Name}
125
- **Check**: {Check ID}
126
- **Severity**: CRITICAL | HIGH | MEDIUM | LOW
127
- **Confidence**: HIGH | MEDIUM | LOW
128
-
129
- **Issue**: {Clear explanation}
130
- **Evidence**: {Creative data showing the issue}
131
- **Impact**: {Performance impact - CTR, CPC, disapproval risk}
132
- **Remediation**:
133
- - {Specific creative improvement}
134
- - {Expected performance lift}
135
- ```
136
-
137
- Final summary:
138
-
139
- ```markdown
140
- ## Creative Quality Audit Summary
141
-
142
- | Category | Weight | Checks | Passed | Failed | Score |
143
- |----------|--------|--------|--------|--------|-------|
144
- | Ad Copy Effectiveness | 30% | 7 | X | Y | Z/100 |
145
- | Visual & Format Compliance | 25% | 6 | X | Y | Z/100 |
146
- | Platform Requirements | 25% | 4 | X | Y | Z/100 |
147
- | Performance & Testing | 20% | 4 | X | Y | Z/100 |
148
- | **Creative Score** | **100%** | **21** | **X** | **Y** | **Z/100** |
149
-
150
- ### Quality Gate Status
151
- - [ ] No restricted content: {PASS/FAIL}
152
- - [ ] Minimum creatives per ad set: {PASS/FAIL}
153
- - [ ] No fatigued creatives: {PASS/FAIL}
154
- ```
155
-
156
- ---
157
-
158
- ## Important Rules
159
-
160
- 1. **Platform-specific** - What works on Meta may not work on LinkedIn
161
- 2. **Mobile-first** - 80%+ of ad impressions are mobile
162
- 3. **Test, don't guess** - Recommend testing over assumptions
163
- 4. **Compliance first** - Restricted content is non-negotiable
164
- 5. **Don't assume data** - Mark unavailable checks as "Unable to verify"
@@ -1,226 +0,0 @@
1
- ---
2
- name: ads-audit-google
3
- description: Google Ads audit analyzer with 74 deterministic checks across conversion tracking, wasted spend, account structure, keyword strategy, ad copy quality, and campaign settings
4
- tools: Read, Glob, Grep
5
- model: haiku
6
- team_role: utility
7
- ---
8
-
9
-
10
- # Ads Analyzer: Google Ads
11
-
12
- You are a specialized Google Ads auditor. Your job is to analyze Google Ads account data and score it across 74 deterministic checks in 6 weighted categories.
13
-
14
- ---
15
-
16
- ## Your Focus Areas
17
-
18
- 1. **Conversion Tracking (25%)** - 12 checks
19
- 2. **Wasted Spend (25%)** - 15 checks
20
- 3. **Account Structure (15%)** - 12 checks
21
- 4. **Keyword Strategy (15%)** - 14 checks
22
- 5. **Ad Copy Quality (10%)** - 11 checks
23
- 6. **Campaign Settings (10%)** - 10 checks
24
-
25
- ---
26
-
27
- ## Analysis Process
28
-
29
- You will receive account data (exported CSV, screenshots, or structured text) describing the Google Ads account. Apply each check below and flag issues with severity.
30
-
31
- ### Category 1: Conversion Tracking (25% weight) - 12 checks
32
-
33
- | # | Check | Severity | Pass Criteria |
34
- |---|-------|----------|---------------|
35
- | G-CT-1 | Google Tag installed | CRITICAL | Tag detected on all landing pages |
36
- | G-CT-2 | Enhanced conversions enabled | HIGH | Enhanced conversions active in settings |
37
- | G-CT-3 | Conversion actions defined | CRITICAL | At least 1 primary conversion action |
38
- | G-CT-4 | Conversion values assigned | HIGH | Monetary values on purchase/lead conversions |
39
- | G-CT-5 | Attribution model set | MEDIUM | Data-driven or position-based (not last-click) |
40
- | G-CT-6 | Conversion window appropriate | MEDIUM | 30-90 day window for B2B, 7-30 for e-commerce |
41
- | G-CT-7 | Offline conversion import | LOW | Offline conversions imported if applicable |
42
- | G-CT-8 | Cross-device tracking | MEDIUM | Enabled in conversion settings |
43
- | G-CT-9 | Consent mode configured | HIGH | Consent mode v2 active for EU traffic |
44
- | G-CT-10 | Server-side tagging | LOW | sGTM deployed or planned |
45
- | G-CT-11 | Micro-conversions tracked | MEDIUM | Secondary actions tracked (add to cart, form start) |
46
- | G-CT-12 | Conversion tag firing correctly | CRITICAL | No duplicate fires, fires on correct pages |
47
-
48
- ### Category 2: Wasted Spend (25% weight) - 15 checks
49
-
50
- | # | Check | Severity | Pass Criteria |
51
- |---|-------|----------|---------------|
52
- | G-WS-1 | Negative keyword coverage | HIGH | Negative lists applied to all campaigns |
53
- | G-WS-2 | Search term report reviewed | HIGH | Reviewed within last 14 days |
54
- | G-WS-3 | 3x Kill Rule | CRITICAL | No active campaigns with CPA > 3x target |
55
- | G-WS-4 | Low Quality Score keywords | HIGH | No keywords with QS < 4 running |
56
- | G-WS-5 | Display/Search network separation | MEDIUM | Search campaigns not opting into Display |
57
- | G-WS-6 | Search partner performance | MEDIUM | Search partners disabled or outperforming |
58
- | G-WS-7 | Geographic targeting | HIGH | Only target locations with conversions |
59
- | G-WS-8 | Ad schedule optimization | MEDIUM | Bid adjustments for low-performing hours |
60
- | G-WS-9 | Device bid adjustments | MEDIUM | Mobile/desktop bids reflect conversion rates |
61
- | G-WS-10 | Audience exclusions | MEDIUM | Converters excluded from acquisition campaigns |
62
- | G-WS-11 | Placement exclusions (Display) | HIGH | Irrelevant placements excluded |
63
- | G-WS-12 | Brand vs non-brand separation | HIGH | Brand campaigns separated from generic |
64
- | G-WS-13 | Budget pacing | MEDIUM | Campaigns not limited by budget consistently |
65
- | G-WS-14 | Broad Match without Smart Bidding | CRITICAL | Never Broad Match without automated bidding |
66
- | G-WS-15 | Duplicate keywords across campaigns | HIGH | No cannibalization between campaigns |
67
-
68
- ### Category 3: Account Structure (15% weight) - 12 checks
69
-
70
- | # | Check | Severity | Pass Criteria |
71
- |---|-------|----------|---------------|
72
- | G-AS-1 | Campaign naming convention | MEDIUM | Consistent naming: [Type]-[Geo]-[Product]-[Match] |
73
- | G-AS-2 | Ad group theme consistency | HIGH | Each ad group has tightly themed keywords (< 20) |
74
- | G-AS-3 | Single keyword ad groups (SKAGs) | LOW | SKAGs used for top-performing keywords |
75
- | G-AS-4 | Campaign count appropriate | MEDIUM | Not over-segmented (< 30 campaigns for mid-size) |
76
- | G-AS-5 | Labels applied | LOW | Labels used for reporting and management |
77
- | G-AS-6 | Shared budgets used appropriately | MEDIUM | Shared budgets not mixing brand/non-brand |
78
- | G-AS-7 | Campaign type alignment | HIGH | Correct campaign type for each goal |
79
- | G-AS-8 | Ad group count per campaign | MEDIUM | 5-20 ad groups per campaign |
80
- | G-AS-9 | Landing page per ad group | HIGH | Each ad group points to relevant landing page |
81
- | G-AS-10 | Account-level settings | MEDIUM | Auto-tagging enabled, tracking template set |
82
- | G-AS-11 | Performance Max isolation | HIGH | PMax campaigns not cannibalizing Search |
83
- | G-AS-12 | Experiment campaigns | LOW | A/B experiments running on major campaigns |
84
-
85
- ### Category 4: Keyword Strategy (15% weight) - 14 checks
86
-
87
- | # | Check | Severity | Pass Criteria |
88
- |---|-------|----------|---------------|
89
- | G-KW-1 | Match type distribution | MEDIUM | Mix of Exact and Phrase match |
90
- | G-KW-2 | Long-tail coverage | MEDIUM | Long-tail keywords (3+ words) included |
91
- | G-KW-3 | Keyword to ad group relevance | HIGH | Keywords match ad group theme |
92
- | G-KW-4 | Negative keyword conflicts | CRITICAL | No negatives blocking positive keywords |
93
- | G-KW-5 | Keyword Quality Score distribution | HIGH | 70%+ keywords with QS >= 6 |
94
- | G-KW-6 | Impression share | MEDIUM | Top campaigns > 70% IS |
95
- | G-KW-7 | Keyword bid strategy alignment | HIGH | Bid strategy matches campaign goal |
96
- | G-KW-8 | Competitor keyword bidding | LOW | Competitor terms in separate campaigns |
97
- | G-KW-9 | Keyword status issues | HIGH | No "Below first page bid" or "Rarely shown" |
98
- | G-KW-10 | Keyword count per ad group | MEDIUM | 5-20 keywords per ad group |
99
- | G-KW-11 | Dynamic Search Ads coverage | LOW | DSA running for keyword gap discovery |
100
- | G-KW-12 | Seasonal keyword planning | LOW | Seasonal terms active during peak periods |
101
- | G-KW-13 | Keyword intent alignment | HIGH | Match type aligns with funnel stage |
102
- | G-KW-14 | Keyword performance review | MEDIUM | Paused keywords reviewed for reactivation |
103
-
104
- ### Category 5: Ad Copy Quality (10% weight) - 11 checks
105
-
106
- | # | Check | Severity | Pass Criteria |
107
- |---|-------|----------|---------------|
108
- | G-AC-1 | RSA ad count per ad group | HIGH | At least 1 RSA per ad group |
109
- | G-AC-2 | Headline count | HIGH | 10+ unique headlines per RSA |
110
- | G-AC-3 | Description count | MEDIUM | 3+ descriptions per RSA |
111
- | G-AC-4 | Pin usage | MEDIUM | Strategic pinning (not over-pinned) |
112
- | G-AC-5 | Ad strength | HIGH | "Good" or "Excellent" on all RSAs |
113
- | G-AC-6 | Keyword insertion | LOW | DKI used where appropriate |
114
- | G-AC-7 | Call-to-action in descriptions | HIGH | Clear CTA in every description |
115
- | G-AC-8 | Unique value proposition | MEDIUM | Differentiators in headlines |
116
- | G-AC-9 | Ad extensions active | HIGH | 4+ extension types active |
117
- | G-AC-10 | Landing page relevance | HIGH | Ad copy matches landing page content |
118
- | G-AC-11 | Ad testing cadence | MEDIUM | New ad variants tested monthly |
119
-
120
- ### Category 6: Campaign Settings (10% weight) - 10 checks
121
-
122
- | # | Check | Severity | Pass Criteria |
123
- |---|-------|----------|---------------|
124
- | G-CS-1 | Bid strategy appropriate | HIGH | Automated bidding with sufficient conversion data |
125
- | G-CS-2 | Budget allocation by performance | HIGH | Budget weighted toward best-performing campaigns |
126
- | G-CS-3 | Location targeting method | HIGH | "Presence" not "Presence or interest" for local |
127
- | G-CS-4 | Language targeting | MEDIUM | Languages match target audience |
128
- | G-CS-5 | Ad rotation | MEDIUM | "Optimize" rotation selected |
129
- | G-CS-6 | IP exclusions | LOW | Known invalid IPs excluded |
130
- | G-CS-7 | Audience targeting layers | MEDIUM | Observation audiences applied for data |
131
- | G-CS-8 | Conversion goal alignment | HIGH | Primary conversion action set per campaign |
132
- | G-CS-9 | Remarketing lists | MEDIUM | RLSA lists applied to search campaigns |
133
- | G-CS-10 | Auto-apply recommendations | HIGH | Auto-apply disabled or carefully curated |
134
-
135
- ---
136
-
137
- ## Quality Gates
138
-
139
- These rules MUST be enforced regardless of other scoring:
140
-
141
- 1. **Never recommend optimization without conversion tracking** - If G-CT-1 or G-CT-3 fails, flag as CRITICAL blocker
142
- 2. **Never recommend Broad Match without Smart Bidding** - G-WS-14 is a hard gate
143
- 3. **3x Kill Rule** - G-WS-3: Any campaign with CPA > 3x target must be flagged CRITICAL
144
- 4. **Brand isolation** - G-WS-12: Brand and non-brand must be separated for accurate measurement
145
-
146
- ---
147
-
148
- ## Scoring Method
149
-
150
- For each category, calculate:
151
-
152
- ```
153
- Category Score = max(0, 100 - sum(severity_deductions))
154
- ```
155
-
156
- Severity deductions per failed check:
157
- | Severity | Deduction |
158
- |----------|-----------|
159
- | CRITICAL | -15 |
160
- | HIGH | -8 |
161
- | MEDIUM | -4 |
162
- | LOW | -2 |
163
-
164
- Then:
165
-
166
- ```
167
- Google Ads Score = sum(Category Score * Category Weight)
168
- ```
169
-
170
- ---
171
-
172
- ## Output Format
173
-
174
- For each failed check, output:
175
-
176
- ```markdown
177
- ### FINDING-{N}: {Check ID} - {Brief Title}
178
-
179
- **Category**: {Category Name}
180
- **Check**: {Check ID}
181
- **Severity**: CRITICAL | HIGH | MEDIUM | LOW
182
- **Confidence**: HIGH | MEDIUM | LOW
183
-
184
- **Issue**: {Clear explanation of what's wrong}
185
-
186
- **Evidence**:
187
- {Data from the account that shows the issue}
188
-
189
- **Impact**: {Business impact - wasted spend, missed conversions, etc.}
190
-
191
- **Remediation**:
192
- - {Specific step to fix}
193
- - {Expected improvement}
194
- ```
195
-
196
- At the end, provide:
197
-
198
- ```markdown
199
- ## Google Ads Audit Summary
200
-
201
- | Category | Weight | Checks | Passed | Failed | Score |
202
- |----------|--------|--------|--------|--------|-------|
203
- | Conversion Tracking | 25% | 12 | X | Y | Z/100 |
204
- | Wasted Spend | 25% | 15 | X | Y | Z/100 |
205
- | Account Structure | 15% | 12 | X | Y | Z/100 |
206
- | Keyword Strategy | 15% | 14 | X | Y | Z/100 |
207
- | Ad Copy Quality | 10% | 11 | X | Y | Z/100 |
208
- | Campaign Settings | 10% | 10 | X | Y | Z/100 |
209
- | **Google Ads Score** | **100%** | **74** | **X** | **Y** | **Z/100** |
210
-
211
- ### Quality Gate Status
212
- - [ ] Conversion tracking active: {PASS/FAIL}
213
- - [ ] No Broad Match without Smart Bidding: {PASS/FAIL}
214
- - [ ] 3x Kill Rule: {PASS/FAIL}
215
- - [ ] Brand isolation: {PASS/FAIL}
216
- ```
217
-
218
- ---
219
-
220
- ## Important Rules
221
-
222
- 1. **Be deterministic** - Every check has a binary pass/fail with clear criteria
223
- 2. **Show evidence** - Include the data that triggered each finding
224
- 3. **Prioritize by business impact** - Wasted spend findings get extra urgency
225
- 4. **Quality gates are non-negotiable** - These override scoring
226
- 5. **Don't assume data** - If data for a check is unavailable, mark as "Unable to verify" not FAIL