budget-rebalance

Budget Rebalance

PREREQUISITE: Read ../_mureo-shared/SKILL.md for auth, security rules, output format, and Tool Selection (Read/Write on Code, mureo_strategy_* / mureo_state_* MCP on Desktop / Cowork).

Analyze budget allocation and suggest rebalancing across all campaigns.

Prerequisites

• STRATEGY.md and STATE.json must exist (run the onboard skill first)

Steps

Before you start: Run the Diagnostic preamble from ../_mureo-shared/SKILL.md — load learning insights (mureo_learning_insights_get) and consult advisors (mureo_consult_advisor) before drawing conclusions.

1. Establish today: call mureo_state_get first, on every host (including Claude Code, where you would otherwise Read the file) and take server_now from its response — ISO 8601 with UTC offset, e.g. 2026-07-28T10:12:33+09:00. Its date is the only source of the current date for this run: the observation_due you write in step 16, and every "is a previous change still inside its observation window?" check in step 14, are measured from it. Do not shell out (this skill must run in Bash-less headless hosts) and do not read the date off STATE.json — last_synced_at, reports.*.period and action_log timestamps are history, never evidence of what day it is now. Never write server_now into STATE.json: it is a response field, and a persisted copy becomes tomorrow's stale "today".

2. Load context: Read STRATEGY.md (Operation Mode, Market Context, Goal sections, Data Sources) and STATE.json (the same mureo_state_get response from step 0 on MCP hosts).

3. Discover platforms: Identify all configured ad platforms from STATE.json platforms. Also include any hosted official-MCP connector present in the session (e.g. TikTok, key tiktok_ads) — drive it via its own tools and skip mureo-only value-adds; see ../_mureo-shared/SKILL.md → Hosted-connector platforms.

4. Analyze budget efficiency: For each ad platform:

   • Google Ads: prefer mureo native — call google_ads_budget_efficiency (campaign × budget × spend × conv ratio) and google_ads_performance_report for the period. In BYOD mode, budget.efficiency may return [] because daily budgets aren't carried in the Apps Script bundle — fall back to performance.report cost / conv numbers and rank by CPA. If mureo's Google Ads tools are unavailable (e.g. MUREO_DISABLE_GOOGLE_ADS=1 after mureo providers add google-ads-official), fall back to the official google-ads-official MCP for the performance report only, then skip google_ads_budget_efficiency (mureo-only analysis) and rank campaigns by CPA from the raw cost / conv numbers yourself; note to the user that mureo's automated budget-efficiency scoring requires the native MCP (mureo setup claude-code).
   • Meta Ads: prefer mureo native — call meta_ads_insights_report and meta_ads_analysis_cost. In BYOD mode, daily budgets aren't surfaced — rank by spend × result_indicator-aware conversions instead. If mureo's Meta Ads tools are unavailable, fall back to the official meta-ads-official hosted MCP for raw insights only, then skip meta_ads_analysis_cost (mureo-only cost-trend analysis) and the result_indicator-aware ranking; rank by raw spend / conversions from the official MCP's response instead and warn the user that CV-definition mismatches across campaigns are NOT detected in this fallback path.
   • mureo BYOD data is centralized in the workspace byod/ directory (or ~/.mureo/byod/ for legacy CLI users) and is only accessible through mureo MCP tools — do not look for raw CSVs in the project directory.