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.
- package/CHANGELOG.md +238 -473
- package/README.md +22 -114
- package/bin/agileflow.js +15 -0
- package/bin/hooks/pre-bash.js +35 -0
- package/bin/hooks/pre-compact.js +34 -0
- package/bin/hooks/pre-edit.js +32 -0
- package/bin/hooks/pre-write.js +32 -0
- package/bin/hooks/session-start.js +42 -0
- package/bin/hooks/stop.js +34 -0
- package/content/plugins/ads/plugin.yaml +14 -0
- package/content/plugins/audit/plugin.yaml +14 -0
- package/content/plugins/core/hooks/babysit-mentor-injector.js +55 -0
- package/content/plugins/core/hooks/context-loader.js +169 -0
- package/content/plugins/core/hooks/damage-control-bash.js +78 -0
- package/content/plugins/core/hooks/damage-control-edit.js +76 -0
- package/content/plugins/core/hooks/damage-control-patterns.yaml +100 -0
- package/content/plugins/core/hooks/damage-control-write.js +72 -0
- package/content/plugins/core/hooks/pre-compact-state.js +90 -0
- package/content/plugins/core/hooks/session-welcome.js +19 -0
- package/content/plugins/core/plugin.yaml +82 -0
- package/content/plugins/core/skills/agileflow-adr/SKILL.md +179 -0
- package/content/plugins/core/skills/agileflow-babysit-mentor/SKILL.md +144 -0
- package/content/plugins/core/skills/agileflow-epic-planner/SKILL.md +179 -0
- package/content/plugins/core/skills/agileflow-status-updater/SKILL.md +132 -0
- package/content/plugins/core/skills/agileflow-story-writer/SKILL.md +200 -0
- package/content/plugins/council/plugin.yaml +14 -0
- package/content/plugins/seo/plugin.yaml +14 -0
- package/package.json +29 -49
- package/src/cli/commands/doctor.js +159 -0
- package/src/cli/commands/hook.js +80 -0
- package/src/cli/commands/setup.js +292 -0
- package/src/cli/commands/status.js +47 -0
- package/src/cli/commands/update.js +83 -0
- package/src/cli/index.js +73 -0
- package/src/cli/wizard/behaviors-picker.js +108 -0
- package/src/cli/wizard/ide-picker.js +57 -0
- package/src/cli/wizard/personalization.js +64 -0
- package/src/cli/wizard/plugin-picker.js +106 -0
- package/src/lib/hash.js +41 -0
- package/src/runtime/config/defaults.js +61 -0
- package/src/runtime/config/loader.js +117 -0
- package/src/runtime/config/schema.json +99 -0
- package/src/runtime/config/writer.js +55 -0
- package/src/runtime/hooks/aggregator.js +157 -0
- package/src/runtime/hooks/chain.js +93 -0
- package/src/runtime/hooks/logger.js +68 -0
- package/src/runtime/hooks/manifest-loader.js +228 -0
- package/src/runtime/hooks/orchestrator.js +322 -0
- package/src/runtime/ide/capabilities.js +111 -0
- package/src/runtime/ide/claude-code-settings.js +234 -0
- package/src/runtime/ide/claude-code-skills.js +202 -0
- package/src/runtime/installer/file-index.js +112 -0
- package/src/runtime/installer/install.js +329 -0
- package/src/runtime/installer/stash.js +61 -0
- package/src/runtime/installer/sync-engine.js +205 -0
- package/src/runtime/plugins/registry.js +132 -0
- package/src/runtime/plugins/resolver.js +138 -0
- package/src/runtime/plugins/validator.js +196 -0
- package/src/runtime/skills/validator.js +335 -0
- package/lib/README.md +0 -178
- package/lib/api-routes.js +0 -625
- package/lib/api-server.js +0 -278
- package/lib/cache-provider.js +0 -155
- package/lib/codebase-indexer.js +0 -819
- package/lib/colors.generated.js +0 -117
- package/lib/colors.js +0 -341
- package/lib/consent.js +0 -232
- package/lib/content-sanitizer.js +0 -464
- package/lib/correlation.js +0 -277
- package/lib/drivers/claude-driver.ts +0 -312
- package/lib/drivers/codex-driver.ts +0 -464
- package/lib/drivers/driver-manager.ts +0 -159
- package/lib/drivers/gemini-driver.ts +0 -498
- package/lib/drivers/index.ts +0 -17
- package/lib/error-codes.js +0 -590
- package/lib/errors.js +0 -670
- package/lib/feature-flags.js +0 -171
- package/lib/feedback.js +0 -595
- package/lib/file-cache.js +0 -541
- package/lib/flag-detection.js +0 -344
- package/lib/format-error.js +0 -156
- package/lib/gate-runner.js +0 -282
- package/lib/generator-factory.js +0 -333
- package/lib/git-operations.js +0 -266
- package/lib/lazy-require.js +0 -59
- package/lib/lock-file.js +0 -144
- package/lib/logger.js +0 -106
- package/lib/merge-operations.js +0 -1006
- package/lib/path-resolver.js +0 -544
- package/lib/path-utils.js +0 -49
- package/lib/paths.js +0 -291
- package/lib/placeholder-registry.js +0 -822
- package/lib/process-executor.js +0 -214
- package/lib/progress.js +0 -334
- package/lib/protocol/driver.ts +0 -354
- package/lib/protocol/index.ts +0 -12
- package/lib/protocol/ir.ts +0 -271
- package/lib/registry-cache.js +0 -80
- package/lib/registry-di.js +0 -358
- package/lib/result-schema.js +0 -363
- package/lib/result.js +0 -210
- package/lib/session-display.js +0 -331
- package/lib/session-operations.js +0 -611
- package/lib/session-registry.js +0 -484
- package/lib/session-state-machine.js +0 -465
- package/lib/session-switching.js +0 -191
- package/lib/skill-loader.js +0 -213
- package/lib/smart-json-file.js +0 -682
- package/lib/state-machine.js +0 -286
- package/lib/table-formatter.js +0 -519
- package/lib/template-loader.js +0 -143
- package/lib/transient-status.js +0 -374
- package/lib/ui-manager.js +0 -612
- package/lib/validate-args.js +0 -213
- package/lib/validate-commands.js +0 -308
- package/lib/validate-names.js +0 -143
- package/lib/validate-paths.js +0 -434
- package/lib/validate.js +0 -134
- package/lib/worktree-operations.js +0 -201
- package/lib/yaml-utils.js +0 -164
- package/scripts/README.md +0 -267
- package/scripts/af +0 -34
- package/scripts/agent-loop.js +0 -879
- package/scripts/agileflow-configure.js +0 -368
- package/scripts/agileflow-statusline.sh +0 -857
- package/scripts/agileflow-welcome.js +0 -2246
- package/scripts/api-server-runner.js +0 -177
- package/scripts/archive-completed-stories.sh +0 -308
- package/scripts/auto-self-improve.js +0 -326
- package/scripts/automation-run-due.js +0 -128
- package/scripts/babysit-clear-restore.js +0 -154
- package/scripts/babysit-context-restore.js +0 -89
- package/scripts/backfill-ideation-status.js +0 -128
- package/scripts/batch-pmap-loop.js +0 -551
- package/scripts/check-sessions.js +0 -116
- package/scripts/check-update.js +0 -282
- package/scripts/ci-summary.js +0 -294
- package/scripts/claude-smart.sh +0 -85
- package/scripts/claude-tmux.sh +0 -737
- package/scripts/claude-watchdog.sh +0 -225
- package/scripts/clear-active-command.js +0 -48
- package/scripts/compress-status.sh +0 -116
- package/scripts/context-loader.js +0 -310
- package/scripts/damage-control/bash-tool-damage-control.js +0 -22
- package/scripts/damage-control/edit-tool-damage-control.js +0 -19
- package/scripts/damage-control/patterns.yaml +0 -227
- package/scripts/damage-control/write-tool-damage-control.js +0 -19
- package/scripts/damage-control-bash.js +0 -51
- package/scripts/damage-control-edit.js +0 -48
- package/scripts/damage-control-multi-agent.js +0 -231
- package/scripts/damage-control-write.js +0 -48
- package/scripts/dependency-check.js +0 -311
- package/scripts/document-repl.js +0 -793
- package/scripts/expertise-metrics.sh +0 -264
- package/scripts/generate-all.sh +0 -77
- package/scripts/generate-colors.js +0 -314
- package/scripts/generators/agent-registry.js +0 -183
- package/scripts/generators/command-registry.js +0 -166
- package/scripts/generators/index.js +0 -85
- package/scripts/generators/inject-babysit.js +0 -191
- package/scripts/generators/inject-help.js +0 -125
- package/scripts/generators/inject-readme.js +0 -166
- package/scripts/generators/skill-registry.js +0 -188
- package/scripts/get-env.js +0 -225
- package/scripts/init.sh +0 -76
- package/scripts/lib/README-portable-tasks.md +0 -424
- package/scripts/lib/ac-test-matcher.js +0 -452
- package/scripts/lib/audit-cleanup.js +0 -250
- package/scripts/lib/audit-registry.js +0 -340
- package/scripts/lib/automation-registry.js +0 -544
- package/scripts/lib/automation-runner.js +0 -476
- package/scripts/lib/browser-qa-evidence.js +0 -409
- package/scripts/lib/browser-qa-status.js +0 -192
- package/scripts/lib/bus-utils.js +0 -473
- package/scripts/lib/colors.generated.sh +0 -82
- package/scripts/lib/colors.sh +0 -46
- package/scripts/lib/command-prereqs.js +0 -280
- package/scripts/lib/concurrency-limiter.js +0 -511
- package/scripts/lib/configure-detect.js +0 -596
- package/scripts/lib/configure-features.js +0 -1927
- package/scripts/lib/configure-repair.js +0 -327
- package/scripts/lib/configure-utils.js +0 -114
- package/scripts/lib/context-formatter.js +0 -1158
- package/scripts/lib/context-loader.js +0 -840
- package/scripts/lib/counter.js +0 -103
- package/scripts/lib/damage-control-utils.js +0 -619
- package/scripts/lib/feature-catalog.js +0 -332
- package/scripts/lib/file-lock.js +0 -392
- package/scripts/lib/file-tracking.js +0 -735
- package/scripts/lib/frontmatter-parser.js +0 -133
- package/scripts/lib/gate-enforcer.js +0 -295
- package/scripts/lib/hook-metrics.js +0 -324
- package/scripts/lib/ideation-index.js +0 -1205
- package/scripts/lib/json-utils.sh +0 -162
- package/scripts/lib/lifecycle-detector.js +0 -125
- package/scripts/lib/model-profiles.js +0 -118
- package/scripts/lib/portable-tasks-cli.js +0 -274
- package/scripts/lib/portable-tasks.js +0 -479
- package/scripts/lib/process-cleanup.js +0 -527
- package/scripts/lib/quality-gates.js +0 -788
- package/scripts/lib/scale-detector.js +0 -396
- package/scripts/lib/sessionRegistry.js +0 -678
- package/scripts/lib/signal-detectors.js +0 -867
- package/scripts/lib/skill-catalog.js +0 -557
- package/scripts/lib/skill-recommender.js +0 -311
- package/scripts/lib/state-migrator.js +0 -353
- package/scripts/lib/status-task-bridge.js +0 -522
- package/scripts/lib/status-writer.js +0 -255
- package/scripts/lib/story-claiming.js +0 -704
- package/scripts/lib/story-state-machine.js +0 -437
- package/scripts/lib/sync-ideation-status.js +0 -291
- package/scripts/lib/task-registry-cache.js +0 -490
- package/scripts/lib/task-registry.js +0 -1191
- package/scripts/lib/task-sync.js +0 -230
- package/scripts/lib/tdd-phase-manager.js +0 -455
- package/scripts/lib/team-events.js +0 -510
- package/scripts/lib/tmux-audit-monitor.js +0 -612
- package/scripts/lib/tmux-group-colors.js +0 -113
- package/scripts/lib/tool-registry.yaml +0 -241
- package/scripts/lib/tool-shed.js +0 -441
- package/scripts/lib/validation-registry.js +0 -177
- package/scripts/messaging-bridge.js +0 -561
- package/scripts/migrate-ideation-index.js +0 -553
- package/scripts/native-team-observer.js +0 -219
- package/scripts/obtain-context.js +0 -272
- package/scripts/pre-push-check.sh +0 -46
- package/scripts/precompact-context.sh +0 -306
- package/scripts/query-codebase.js +0 -543
- package/scripts/ralph-loop.js +0 -1278
- package/scripts/resume-session.sh +0 -121
- package/scripts/screenshot-verifier.js +0 -215
- package/scripts/session-boundary.js +0 -138
- package/scripts/session-coordinator.sh +0 -232
- package/scripts/session-manager.js +0 -546
- package/scripts/smart-detect.js +0 -449
- package/scripts/spawn-audit-sessions.js +0 -877
- package/scripts/spawn-parallel.js +0 -751
- package/scripts/strip-ai-attribution.js +0 -63
- package/scripts/task-completed-gate.js +0 -237
- package/scripts/team-manager.js +0 -596
- package/scripts/team-status-display.js +0 -200
- package/scripts/teammate-idle-gate.js +0 -237
- package/scripts/test-session-boundary.js +0 -80
- package/scripts/tmux-close-windows.sh +0 -180
- package/scripts/tmux-restore-window.sh +0 -67
- package/scripts/tmux-save-closed-window.sh +0 -35
- package/scripts/tui/App.js +0 -151
- package/scripts/tui/Dashboard.js +0 -277
- package/scripts/tui/blessed/data/watcher.js +0 -180
- package/scripts/tui/blessed/index.js +0 -244
- package/scripts/tui/blessed/panels/output.js +0 -101
- package/scripts/tui/blessed/panels/sessions.js +0 -150
- package/scripts/tui/blessed/panels/trace.js +0 -97
- package/scripts/tui/blessed/ui/help.js +0 -77
- package/scripts/tui/blessed/ui/screen.js +0 -52
- package/scripts/tui/blessed/ui/statusbar.js +0 -47
- package/scripts/tui/blessed/ui/tabbar.js +0 -99
- package/scripts/tui/index.js +0 -70
- package/scripts/tui/lib/crashRecovery.js +0 -304
- package/scripts/tui/lib/eventStream.js +0 -309
- package/scripts/tui/lib/keyboard.js +0 -261
- package/scripts/tui/lib/loopControl.js +0 -371
- package/scripts/tui/panels/OutputPanel.js +0 -240
- package/scripts/tui/panels/SessionPanel.js +0 -170
- package/scripts/tui/panels/TracePanel.js +0 -298
- package/scripts/tui/simple-tui.js +0 -510
- package/scripts/validate-expertise.sh +0 -263
- package/scripts/validate-tokens.sh +0 -73
- package/scripts/validators/README.md +0 -143
- package/scripts/validators/component-validator.js +0 -239
- package/scripts/validators/json-schema-validator.js +0 -186
- package/scripts/validators/markdown-validator.js +0 -152
- package/scripts/validators/migration-validator.js +0 -129
- package/scripts/validators/security-validator.js +0 -380
- package/scripts/validators/story-format-validator.js +0 -197
- package/scripts/validators/test-result-validator.js +0 -114
- package/scripts/validators/workflow-validator.js +0 -247
- package/scripts/welcome-deferred.js +0 -437
- package/scripts/worktree-create.sh +0 -111
- package/src/core/agents/a11y-analyzer-aria.md +0 -155
- package/src/core/agents/a11y-analyzer-forms.md +0 -162
- package/src/core/agents/a11y-analyzer-keyboard.md +0 -175
- package/src/core/agents/a11y-analyzer-semantic.md +0 -153
- package/src/core/agents/a11y-analyzer-visual.md +0 -158
- package/src/core/agents/a11y-consensus.md +0 -248
- package/src/core/agents/accessibility.md +0 -515
- package/src/core/agents/adr-writer.md +0 -463
- package/src/core/agents/ads-audit-budget.md +0 -181
- package/src/core/agents/ads-audit-compliance.md +0 -169
- package/src/core/agents/ads-audit-creative.md +0 -164
- package/src/core/agents/ads-audit-google.md +0 -226
- package/src/core/agents/ads-audit-meta.md +0 -183
- package/src/core/agents/ads-audit-tracking.md +0 -197
- package/src/core/agents/ads-consensus.md +0 -396
- package/src/core/agents/ads-generate.md +0 -145
- package/src/core/agents/ads-performance-tracker.md +0 -197
- package/src/core/agents/analytics.md +0 -617
- package/src/core/agents/api-quality-analyzer-conventions.md +0 -148
- package/src/core/agents/api-quality-analyzer-docs.md +0 -176
- package/src/core/agents/api-quality-analyzer-errors.md +0 -183
- package/src/core/agents/api-quality-analyzer-pagination.md +0 -171
- package/src/core/agents/api-quality-analyzer-versioning.md +0 -143
- package/src/core/agents/api-quality-consensus.md +0 -214
- package/src/core/agents/api-validator.md +0 -183
- package/src/core/agents/api.md +0 -665
- package/src/core/agents/arch-analyzer-circular.md +0 -148
- package/src/core/agents/arch-analyzer-complexity.md +0 -171
- package/src/core/agents/arch-analyzer-coupling.md +0 -146
- package/src/core/agents/arch-analyzer-layering.md +0 -151
- package/src/core/agents/arch-analyzer-patterns.md +0 -162
- package/src/core/agents/arch-consensus.md +0 -227
- package/src/core/agents/brainstorm-analyzer-features.md +0 -169
- package/src/core/agents/brainstorm-analyzer-growth.md +0 -161
- package/src/core/agents/brainstorm-analyzer-integration.md +0 -172
- package/src/core/agents/brainstorm-analyzer-market.md +0 -147
- package/src/core/agents/brainstorm-analyzer-ux.md +0 -167
- package/src/core/agents/brainstorm-consensus.md +0 -237
- package/src/core/agents/browser-qa.md +0 -328
- package/src/core/agents/ci.md +0 -511
- package/src/core/agents/code-reviewer.md +0 -288
- package/src/core/agents/codebase-query.md +0 -266
- package/src/core/agents/completeness-analyzer-api.md +0 -190
- package/src/core/agents/completeness-analyzer-conditional.md +0 -201
- package/src/core/agents/completeness-analyzer-handlers.md +0 -159
- package/src/core/agents/completeness-analyzer-imports.md +0 -159
- package/src/core/agents/completeness-analyzer-routes.md +0 -182
- package/src/core/agents/completeness-analyzer-state.md +0 -188
- package/src/core/agents/completeness-analyzer-stubs.md +0 -198
- package/src/core/agents/completeness-consensus.md +0 -286
- package/src/core/agents/compliance.md +0 -509
- package/src/core/agents/council-advocate.md +0 -206
- package/src/core/agents/council-analyst.md +0 -252
- package/src/core/agents/council-optimist.md +0 -170
- package/src/core/agents/database.md +0 -601
- package/src/core/agents/datamigration.md +0 -699
- package/src/core/agents/design.md +0 -525
- package/src/core/agents/devops.md +0 -720
- package/src/core/agents/documentation.md +0 -504
- package/src/core/agents/epic-planner.md +0 -480
- package/src/core/agents/error-analyzer.md +0 -201
- package/src/core/agents/integrations.md +0 -603
- package/src/core/agents/legal-analyzer-a11y.md +0 -110
- package/src/core/agents/legal-analyzer-ai.md +0 -117
- package/src/core/agents/legal-analyzer-consumer.md +0 -108
- package/src/core/agents/legal-analyzer-content.md +0 -113
- package/src/core/agents/legal-analyzer-international.md +0 -115
- package/src/core/agents/legal-analyzer-licensing.md +0 -115
- package/src/core/agents/legal-analyzer-privacy.md +0 -108
- package/src/core/agents/legal-analyzer-security.md +0 -112
- package/src/core/agents/legal-analyzer-terms.md +0 -111
- package/src/core/agents/legal-consensus.md +0 -242
- package/src/core/agents/logic-analyzer-edge.md +0 -170
- package/src/core/agents/logic-analyzer-flow.md +0 -253
- package/src/core/agents/logic-analyzer-invariant.md +0 -206
- package/src/core/agents/logic-analyzer-race.md +0 -266
- package/src/core/agents/logic-analyzer-type.md +0 -217
- package/src/core/agents/logic-consensus.md +0 -253
- package/src/core/agents/mentor.md +0 -654
- package/src/core/agents/mobile.md +0 -501
- package/src/core/agents/monitoring.md +0 -537
- package/src/core/agents/multi-expert.md +0 -311
- package/src/core/agents/orchestrator.md +0 -749
- package/src/core/agents/perf-analyzer-assets.md +0 -174
- package/src/core/agents/perf-analyzer-bundle.md +0 -165
- package/src/core/agents/perf-analyzer-caching.md +0 -160
- package/src/core/agents/perf-analyzer-compute.md +0 -165
- package/src/core/agents/perf-analyzer-memory.md +0 -182
- package/src/core/agents/perf-analyzer-network.md +0 -157
- package/src/core/agents/perf-analyzer-queries.md +0 -155
- package/src/core/agents/perf-analyzer-rendering.md +0 -156
- package/src/core/agents/perf-consensus.md +0 -280
- package/src/core/agents/performance.md +0 -492
- package/src/core/agents/product.md +0 -535
- package/src/core/agents/qa.md +0 -765
- package/src/core/agents/readme-updater.md +0 -579
- package/src/core/agents/refactor.md +0 -558
- package/src/core/agents/research.md +0 -453
- package/src/core/agents/rlm-subcore.md +0 -207
- package/src/core/agents/schema-validator.md +0 -454
- package/src/core/agents/security-analyzer-api.md +0 -199
- package/src/core/agents/security-analyzer-auth.md +0 -160
- package/src/core/agents/security-analyzer-authz.md +0 -168
- package/src/core/agents/security-analyzer-deps.md +0 -147
- package/src/core/agents/security-analyzer-infra.md +0 -176
- package/src/core/agents/security-analyzer-injection.md +0 -148
- package/src/core/agents/security-analyzer-input.md +0 -191
- package/src/core/agents/security-analyzer-secrets.md +0 -175
- package/src/core/agents/security-consensus.md +0 -276
- package/src/core/agents/security.md +0 -486
- package/src/core/agents/seo-analyzer-content.md +0 -167
- package/src/core/agents/seo-analyzer-images.md +0 -187
- package/src/core/agents/seo-analyzer-performance.md +0 -206
- package/src/core/agents/seo-analyzer-schema.md +0 -176
- package/src/core/agents/seo-analyzer-sitemap.md +0 -172
- package/src/core/agents/seo-analyzer-technical.md +0 -144
- package/src/core/agents/seo-consensus.md +0 -289
- package/src/core/agents/team-coordinator.md +0 -333
- package/src/core/agents/team-lead.md +0 -171
- package/src/core/agents/test-analyzer-assertions.md +0 -181
- package/src/core/agents/test-analyzer-coverage.md +0 -183
- package/src/core/agents/test-analyzer-fragility.md +0 -185
- package/src/core/agents/test-analyzer-integration.md +0 -155
- package/src/core/agents/test-analyzer-maintenance.md +0 -173
- package/src/core/agents/test-analyzer-mocking.md +0 -178
- package/src/core/agents/test-analyzer-patterns.md +0 -189
- package/src/core/agents/test-analyzer-structure.md +0 -177
- package/src/core/agents/test-consensus.md +0 -294
- package/src/core/agents/testing.md +0 -527
- package/src/core/agents/ui-validator.md +0 -331
- package/src/core/agents/ui.md +0 -1227
- package/src/core/commands/adr/list.md +0 -191
- package/src/core/commands/adr/update.md +0 -258
- package/src/core/commands/adr/view.md +0 -274
- package/src/core/commands/adr.md +0 -394
- package/src/core/commands/ads/audit.md +0 -453
- package/src/core/commands/ads/budget.md +0 -97
- package/src/core/commands/ads/competitor.md +0 -112
- package/src/core/commands/ads/creative.md +0 -85
- package/src/core/commands/ads/generate.md +0 -238
- package/src/core/commands/ads/google.md +0 -112
- package/src/core/commands/ads/health.md +0 -327
- package/src/core/commands/ads/landing.md +0 -119
- package/src/core/commands/ads/linkedin.md +0 -112
- package/src/core/commands/ads/meta.md +0 -91
- package/src/core/commands/ads/microsoft.md +0 -115
- package/src/core/commands/ads/plan.md +0 -321
- package/src/core/commands/ads/test-plan.md +0 -317
- package/src/core/commands/ads/tiktok.md +0 -129
- package/src/core/commands/ads/track.md +0 -288
- package/src/core/commands/ads/youtube.md +0 -124
- package/src/core/commands/ads.md +0 -140
- package/src/core/commands/agent.md +0 -256
- package/src/core/commands/api.md +0 -267
- package/src/core/commands/assign.md +0 -369
- package/src/core/commands/audit.md +0 -531
- package/src/core/commands/auto.md +0 -556
- package/src/core/commands/automate.md +0 -415
- package/src/core/commands/babysit.md +0 -643
- package/src/core/commands/baseline.md +0 -743
- package/src/core/commands/batch.md +0 -551
- package/src/core/commands/blockers.md +0 -602
- package/src/core/commands/board.md +0 -509
- package/src/core/commands/browser-qa.md +0 -240
- package/src/core/commands/changelog.md +0 -582
- package/src/core/commands/choose.md +0 -430
- package/src/core/commands/ci.md +0 -330
- package/src/core/commands/code/accessibility.md +0 -363
- package/src/core/commands/code/api.md +0 -313
- package/src/core/commands/code/architecture.md +0 -313
- package/src/core/commands/code/completeness.md +0 -519
- package/src/core/commands/code/legal.md +0 -509
- package/src/core/commands/code/logic.md +0 -432
- package/src/core/commands/code/performance.md +0 -506
- package/src/core/commands/code/security.md +0 -509
- package/src/core/commands/code/test.md +0 -505
- package/src/core/commands/compress.md +0 -408
- package/src/core/commands/configure.md +0 -1159
- package/src/core/commands/context/export.md +0 -296
- package/src/core/commands/context/full.md +0 -353
- package/src/core/commands/context/note.md +0 -380
- package/src/core/commands/council.md +0 -592
- package/src/core/commands/debt.md +0 -491
- package/src/core/commands/deploy.md +0 -864
- package/src/core/commands/deps.md +0 -728
- package/src/core/commands/diagnose.md +0 -404
- package/src/core/commands/docs.md +0 -469
- package/src/core/commands/epic/edit.md +0 -213
- package/src/core/commands/epic/list.md +0 -190
- package/src/core/commands/epic/view.md +0 -267
- package/src/core/commands/epic.md +0 -477
- package/src/core/commands/export.md +0 -238
- package/src/core/commands/feedback.md +0 -603
- package/src/core/commands/handoff.md +0 -386
- package/src/core/commands/help.md +0 -194
- package/src/core/commands/ideate/brief.md +0 -363
- package/src/core/commands/ideate/discover.md +0 -399
- package/src/core/commands/ideate/features.md +0 -497
- package/src/core/commands/ideate/history.md +0 -403
- package/src/core/commands/ideate/new.md +0 -900
- package/src/core/commands/impact.md +0 -407
- package/src/core/commands/install.md +0 -529
- package/src/core/commands/learn/explain.md +0 -118
- package/src/core/commands/learn/glossary.md +0 -135
- package/src/core/commands/learn/patterns.md +0 -138
- package/src/core/commands/learn/tour.md +0 -126
- package/src/core/commands/maintain.md +0 -558
- package/src/core/commands/metrics.md +0 -844
- package/src/core/commands/migrate/codemods.md +0 -151
- package/src/core/commands/migrate/plan.md +0 -131
- package/src/core/commands/migrate/scan.md +0 -114
- package/src/core/commands/migrate/validate.md +0 -119
- package/src/core/commands/multi-expert.md +0 -447
- package/src/core/commands/packages.md +0 -535
- package/src/core/commands/pr.md +0 -337
- package/src/core/commands/readme-sync.md +0 -329
- package/src/core/commands/research/analyze.md +0 -798
- package/src/core/commands/research/ask.md +0 -864
- package/src/core/commands/research/import.md +0 -1025
- package/src/core/commands/research/list.md +0 -273
- package/src/core/commands/research/synthesize.md +0 -928
- package/src/core/commands/research/view.md +0 -323
- package/src/core/commands/retro.md +0 -795
- package/src/core/commands/review.md +0 -694
- package/src/core/commands/rlm.md +0 -446
- package/src/core/commands/roadmap/analyze.md +0 -400
- package/src/core/commands/rpi.md +0 -633
- package/src/core/commands/seo/audit.md +0 -444
- package/src/core/commands/seo/competitor.md +0 -174
- package/src/core/commands/seo/content.md +0 -107
- package/src/core/commands/seo/geo.md +0 -229
- package/src/core/commands/seo/hreflang.md +0 -140
- package/src/core/commands/seo/images.md +0 -96
- package/src/core/commands/seo/page.md +0 -198
- package/src/core/commands/seo/plan.md +0 -163
- package/src/core/commands/seo/programmatic.md +0 -131
- package/src/core/commands/seo/references/cwv-thresholds.md +0 -64
- package/src/core/commands/seo/references/eeat-framework.md +0 -110
- package/src/core/commands/seo/references/quality-gates.md +0 -91
- package/src/core/commands/seo/references/schema-types.md +0 -102
- package/src/core/commands/seo/schema.md +0 -183
- package/src/core/commands/seo/sitemap.md +0 -97
- package/src/core/commands/seo/technical.md +0 -100
- package/src/core/commands/seo.md +0 -107
- package/src/core/commands/session/cleanup.md +0 -452
- package/src/core/commands/session/end.md +0 -865
- package/src/core/commands/session/history.md +0 -293
- package/src/core/commands/session/init.md +0 -210
- package/src/core/commands/session/new.md +0 -827
- package/src/core/commands/session/resume.md +0 -291
- package/src/core/commands/session/spawn.md +0 -205
- package/src/core/commands/session/status.md +0 -274
- package/src/core/commands/skill/list.md +0 -139
- package/src/core/commands/skill/recommend.md +0 -216
- package/src/core/commands/sprint.md +0 -714
- package/src/core/commands/status/undo.md +0 -191
- package/src/core/commands/status.md +0 -423
- package/src/core/commands/story/edit.md +0 -204
- package/src/core/commands/story/list.md +0 -199
- package/src/core/commands/story/view.md +0 -312
- package/src/core/commands/story-validate.md +0 -491
- package/src/core/commands/story.md +0 -465
- package/src/core/commands/tdd-next.md +0 -238
- package/src/core/commands/tdd.md +0 -211
- package/src/core/commands/team/guide.md +0 -688
- package/src/core/commands/team/list.md +0 -59
- package/src/core/commands/team/start.md +0 -130
- package/src/core/commands/team/status.md +0 -66
- package/src/core/commands/team/stop.md +0 -78
- package/src/core/commands/template.md +0 -644
- package/src/core/commands/tests.md +0 -731
- package/src/core/commands/update.md +0 -591
- package/src/core/commands/validate-expertise.md +0 -305
- package/src/core/commands/velocity.md +0 -630
- package/src/core/commands/verify.md +0 -534
- package/src/core/commands/whats-new.md +0 -201
- package/src/core/commands/workflow.md +0 -449
- package/src/core/council/sessions/.gitkeep +0 -0
- package/src/core/council/shared_reasoning.template.md +0 -106
- package/src/core/experts/README.md +0 -236
- package/src/core/experts/_core-expertise.yaml +0 -105
- package/src/core/experts/accessibility/expertise.yaml +0 -115
- package/src/core/experts/accessibility/question.md +0 -41
- package/src/core/experts/accessibility/self-improve.md +0 -45
- package/src/core/experts/accessibility/workflow.md +0 -59
- package/src/core/experts/adr-writer/expertise.yaml +0 -138
- package/src/core/experts/adr-writer/question.md +0 -56
- package/src/core/experts/adr-writer/self-improve.md +0 -106
- package/src/core/experts/adr-writer/workflow.md +0 -184
- package/src/core/experts/analytics/expertise.yaml +0 -119
- package/src/core/experts/analytics/question.md +0 -74
- package/src/core/experts/analytics/self-improve.md +0 -163
- package/src/core/experts/analytics/workflow.md +0 -272
- package/src/core/experts/api/expertise.yaml +0 -124
- package/src/core/experts/api/question.md +0 -74
- package/src/core/experts/api/self-improve.md +0 -122
- package/src/core/experts/api/workflow.md +0 -248
- package/src/core/experts/ci/expertise.yaml +0 -106
- package/src/core/experts/ci/question.md +0 -69
- package/src/core/experts/ci/self-improve.md +0 -100
- package/src/core/experts/ci/workflow.md +0 -145
- package/src/core/experts/codebase-query/expertise.yaml +0 -121
- package/src/core/experts/codebase-query/question.md +0 -73
- package/src/core/experts/codebase-query/self-improve.md +0 -105
- package/src/core/experts/compliance/expertise.yaml +0 -101
- package/src/core/experts/compliance/question.md +0 -56
- package/src/core/experts/compliance/self-improve.md +0 -106
- package/src/core/experts/compliance/workflow.md +0 -184
- package/src/core/experts/database/expertise.yaml +0 -109
- package/src/core/experts/database/question.md +0 -74
- package/src/core/experts/database/self-improve.md +0 -121
- package/src/core/experts/database/workflow.md +0 -234
- package/src/core/experts/datamigration/expertise.yaml +0 -141
- package/src/core/experts/datamigration/question.md +0 -56
- package/src/core/experts/datamigration/self-improve.md +0 -106
- package/src/core/experts/datamigration/workflow.md +0 -184
- package/src/core/experts/design/expertise.yaml +0 -116
- package/src/core/experts/design/question.md +0 -56
- package/src/core/experts/design/self-improve.md +0 -106
- package/src/core/experts/design/workflow.md +0 -184
- package/src/core/experts/devops/expertise.yaml +0 -116
- package/src/core/experts/devops/question.md +0 -68
- package/src/core/experts/devops/self-improve.md +0 -102
- package/src/core/experts/devops/workflow.md +0 -142
- package/src/core/experts/documentation/expertise.yaml +0 -126
- package/src/core/experts/documentation/question.md +0 -41
- package/src/core/experts/documentation/self-improve.md +0 -45
- package/src/core/experts/documentation/workflow.md +0 -55
- package/src/core/experts/epic-planner/expertise.yaml +0 -144
- package/src/core/experts/epic-planner/question.md +0 -56
- package/src/core/experts/epic-planner/self-improve.md +0 -106
- package/src/core/experts/epic-planner/workflow.md +0 -184
- package/src/core/experts/integrations/expertise.yaml +0 -113
- package/src/core/experts/integrations/question.md +0 -74
- package/src/core/experts/integrations/self-improve.md +0 -151
- package/src/core/experts/integrations/workflow.md +0 -246
- package/src/core/experts/mentor/expertise.yaml +0 -125
- package/src/core/experts/mentor/question.md +0 -56
- package/src/core/experts/mentor/self-improve.md +0 -106
- package/src/core/experts/mentor/workflow.md +0 -184
- package/src/core/experts/mobile/expertise.yaml +0 -136
- package/src/core/experts/mobile/question.md +0 -72
- package/src/core/experts/mobile/self-improve.md +0 -140
- package/src/core/experts/mobile/workflow.md +0 -240
- package/src/core/experts/monitoring/expertise.yaml +0 -132
- package/src/core/experts/monitoring/question.md +0 -76
- package/src/core/experts/monitoring/self-improve.md +0 -150
- package/src/core/experts/monitoring/workflow.md +0 -264
- package/src/core/experts/performance/expertise.yaml +0 -68
- package/src/core/experts/performance/question.md +0 -41
- package/src/core/experts/performance/self-improve.md +0 -45
- package/src/core/experts/performance/workflow.md +0 -61
- package/src/core/experts/product/expertise.yaml +0 -143
- package/src/core/experts/product/question.md +0 -56
- package/src/core/experts/product/self-improve.md +0 -106
- package/src/core/experts/product/workflow.md +0 -184
- package/src/core/experts/qa/expertise.yaml +0 -110
- package/src/core/experts/qa/question.md +0 -56
- package/src/core/experts/qa/self-improve.md +0 -106
- package/src/core/experts/qa/workflow.md +0 -184
- package/src/core/experts/readme-updater/expertise.yaml +0 -141
- package/src/core/experts/readme-updater/question.md +0 -56
- package/src/core/experts/readme-updater/self-improve.md +0 -106
- package/src/core/experts/readme-updater/workflow.md +0 -184
- package/src/core/experts/refactor/expertise.yaml +0 -135
- package/src/core/experts/refactor/question.md +0 -41
- package/src/core/experts/refactor/self-improve.md +0 -45
- package/src/core/experts/refactor/workflow.md +0 -57
- package/src/core/experts/research/expertise.yaml +0 -143
- package/src/core/experts/research/question.md +0 -56
- package/src/core/experts/research/self-improve.md +0 -106
- package/src/core/experts/research/workflow.md +0 -184
- package/src/core/experts/security/expertise.yaml +0 -117
- package/src/core/experts/security/question.md +0 -77
- package/src/core/experts/security/self-improve.md +0 -102
- package/src/core/experts/security/workflow.md +0 -152
- package/src/core/experts/templates/expertise-template.yaml +0 -67
- package/src/core/experts/templates/question-template.md +0 -56
- package/src/core/experts/templates/self-improve-template.md +0 -106
- package/src/core/experts/templates/workflow-template.md +0 -184
- package/src/core/experts/testing/expertise.yaml +0 -112
- package/src/core/experts/testing/question.md +0 -68
- package/src/core/experts/testing/self-improve.md +0 -102
- package/src/core/experts/testing/workflow.md +0 -143
- package/src/core/experts/ui/expertise.yaml +0 -133
- package/src/core/experts/ui/question.md +0 -74
- package/src/core/experts/ui/self-improve.md +0 -122
- package/src/core/experts/ui/workflow.md +0 -262
- package/src/core/knowledge/ads/ad-audit-checklist-scoring.md +0 -424
- package/src/core/knowledge/ads/ad-optimization-logic.md +0 -590
- package/src/core/knowledge/ads/ad-technical-specifications.md +0 -385
- package/src/core/knowledge/ads/definitive-advertising-reference-2026.md +0 -506
- package/src/core/knowledge/ads/paid-advertising-research-2026.md +0 -445
- package/src/core/profiles/COMPARISON.md +0 -170
- package/src/core/profiles/README.md +0 -178
- package/src/core/profiles/claude-code.yaml +0 -111
- package/src/core/profiles/codex.yaml +0 -103
- package/src/core/profiles/cursor.yaml +0 -134
- package/src/core/profiles/examples.js +0 -250
- package/src/core/profiles/loader.js +0 -235
- package/src/core/profiles/windsurf.yaml +0 -159
- package/src/core/skills/_learnings/README.md +0 -91
- package/src/core/skills/_learnings/_template.yaml +0 -106
- package/src/core/skills/_learnings/code-review.yaml +0 -118
- package/src/core/skills/_learnings/commit.yaml +0 -69
- package/src/core/skills/_learnings/story-writer.yaml +0 -71
- package/src/core/teams/backend.json +0 -41
- package/src/core/teams/builder-validator.json +0 -51
- package/src/core/teams/code-review.json +0 -41
- package/src/core/teams/frontend.json +0 -41
- package/src/core/teams/fullstack.json +0 -41
- package/src/core/teams/logic-audit.json +0 -53
- package/src/core/teams/perf-audit.json +0 -71
- package/src/core/teams/qa.json +0 -41
- package/src/core/teams/security-audit.json +0 -71
- package/src/core/teams/solo.json +0 -35
- package/src/core/teams/test-audit.json +0 -71
- package/src/core/templates/CONTEXT.md.example +0 -49
- package/src/core/templates/README-template.md +0 -16
- package/src/core/templates/adr-template.md +0 -28
- package/src/core/templates/agent-coordination-pattern.md +0 -38
- package/src/core/templates/agent-profile-template.md +0 -51
- package/src/core/templates/agileflow-metadata.json +0 -150
- package/src/core/templates/browser-qa-spec.yaml +0 -94
- package/src/core/templates/ci-workflow.yml +0 -74
- package/src/core/templates/claude-settings.advanced.example.json +0 -75
- package/src/core/templates/claude-settings.example.json +0 -26
- package/src/core/templates/command-documentation.md +0 -187
- package/src/core/templates/command-prerequisites.yaml +0 -169
- package/src/core/templates/comms-note-template.md +0 -24
- package/src/core/templates/damage-control-patterns.yaml +0 -243
- package/src/core/templates/environment.json +0 -18
- package/src/core/templates/epic-template.md +0 -27
- package/src/core/templates/plan-template.md +0 -125
- package/src/core/templates/preserve-rules-common.md +0 -107
- package/src/core/templates/preserve-rules.json +0 -42
- package/src/core/templates/proactive-action-spec.md +0 -29
- package/src/core/templates/product-brief.md +0 -136
- package/src/core/templates/quality-gate-priorities.md +0 -34
- package/src/core/templates/research-template.md +0 -44
- package/src/core/templates/session-harness-protocol.md +0 -128
- package/src/core/templates/session-state.json +0 -56
- package/src/core/templates/story-lifecycle.md +0 -213
- package/src/core/templates/story-template.md +0 -92
- package/src/core/templates/tdd-test-template.js +0 -241
- package/src/core/templates/worktrees-guide.md +0 -231
- package/tools/agileflow-npx.js +0 -52
- package/tools/cli/agileflow-cli.js +0 -72
- package/tools/cli/commands/config.js +0 -285
- package/tools/cli/commands/doctor.js +0 -496
- package/tools/cli/commands/list.js +0 -385
- package/tools/cli/commands/session.js +0 -1176
- package/tools/cli/commands/setup.js +0 -255
- package/tools/cli/commands/status.js +0 -101
- package/tools/cli/commands/tui.js +0 -56
- package/tools/cli/commands/uninstall.js +0 -155
- package/tools/cli/commands/update.js +0 -299
- package/tools/cli/installers/core/installer.js +0 -892
- package/tools/cli/installers/ide/_base-ide.js +0 -518
- package/tools/cli/installers/ide/_interface.js +0 -238
- package/tools/cli/installers/ide/claude-code.js +0 -432
- package/tools/cli/installers/ide/codex.js +0 -426
- package/tools/cli/installers/ide/cursor.js +0 -217
- package/tools/cli/installers/ide/manager.js +0 -222
- package/tools/cli/installers/ide/windsurf.js +0 -282
- package/tools/cli/lib/command-context.js +0 -382
- package/tools/cli/lib/config-manager.js +0 -446
- package/tools/cli/lib/content-injector.js +0 -969
- package/tools/cli/lib/content-transformer.js +0 -496
- package/tools/cli/lib/docs-setup.js +0 -464
- package/tools/cli/lib/error-handler.js +0 -165
- package/tools/cli/lib/ide-error-factory.js +0 -421
- package/tools/cli/lib/ide-errors.js +0 -367
- package/tools/cli/lib/ide-generator.js +0 -357
- package/tools/cli/lib/ide-health-monitor.js +0 -364
- package/tools/cli/lib/ide-registry.js +0 -297
- package/tools/cli/lib/npm-utils.js +0 -103
- package/tools/cli/lib/self-update.js +0 -148
- package/tools/cli/lib/ui.js +0 -211
- package/tools/cli/lib/utils.js +0 -87
- package/tools/cli/lib/validation-middleware.js +0 -491
- package/tools/cli/lib/version-checker.js +0 -95
- 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
|