Execution

/ads optimize --draft

Draft evidence-backed optimization changes

Claude Code
/ads optimize --draft

Installed as a plugin? The same command is namespaced: /claude-ads:ads optimize --draft

What it does

Diagnoses account performance against evidence, financial constraints, and experiment state, then drafts ranked optimization changes: budget reallocation, bid changes, pausing, creative rotation, and search-term actions. Nothing is applied without the same capability-gated approval flow as launch.

Use it to

  • Diagnose why CPA or ROAS moved and what to do about it
  • Draft a budget reallocation with confidence levels and success measures
  • Review search terms and draft negative-keyword actions with overblocking checks
  • Decide between changing nothing, running an experiment, or mutating the account
  • Handle a request to delete a campaign with reversible alternatives instead

How it works

  1. Load the evidence

    Latest snapshot, prior decisions, monitoring results, experiment state, conversion lag, economics, and the capability manifest.

  2. Identify the real decision

    Finds the decision and its causal evidence rather than optimizing one metric in isolation.

  3. Compare the options

    No-change, experiment, and mutation are weighed, including learning, policy, tracking, inventory, and opportunity-cost effects.

  4. Rank the recommendations

    Each recommendation carries confidence and a success measure.

  5. Gate any mutation

    Approved recommendations become mutation plans only through the main mutation gate, and apply requires the exact operation to be enabled with remote state matching the draft precondition.

Reads & produces

What it reads

  • The latest normalized account snapshot
  • Prior decisions, monitoring results, and experiment state
  • Conversion lag and business economics
  • The platform capability manifest for the target account

What it produces

  • Ranked recommendations with confidence and success measures
  • An explicit comparison of no-change, experiment, and mutation options
  • Mutation plans for approved recommendations, gated exactly like launch
  • On apply: a verified change with an audit trail and retained rollback

Guardrails

What /ads optimize --draft will and will not do, by contract. These boundaries are enforced in the skill itself, not left to judgment.

  • Defaults to draft. Recommendations become account changes only through the capability-gated mutation flow with explicit approval.
  • Refuses permanent deletion of campaigns, ad groups, ads, audiences, or conversions. It offers reversible alternatives instead: pause, archive where supported, label, back up, and set a review date.
  • Search-term and negative-keyword actions require an actual search terms report, business-relevance evidence, and an overblocking review. It will not invent example negatives.
  • Never uses a fixed CPA multiple, budget ratio, benchmark, or novelty claim as sole authorization to change an account.
  • Apply verifies that remote state still matches the draft precondition, and every change retains a rollback.

Questions

I asked it to delete a campaign. Why did it refuse?

Permanent deletion is outside the supported mutation contract and cannot be made safe by confirmation. Optimize offers reversible alternatives: leave the campaign paused, archive it where the platform supports that, label it, export a backup, and set a review date.

Why will it not just add negative keywords for me?

Negative-keyword actions require a search terms report, evidence of business relevance, and an overblocking review. Without them it requests the missing evidence, because invented negatives silently cut real demand.

Does an optimization draft change my bids or budgets?

No. A draft is a ranked recommendation set with confidence and success measures. Changing the account requires converting an approved recommendation through the mutation gate, exactly like a launch.