Budget Management

What you get back:

Budget data:

• allocated -- Total budget for the current period.
• spent -- Amount already spent.
• reserved -- Amount reserved for pending/queued payments.
• remaining -- Available balance (allocated - spent - reserved).
• currency -- Always USDC.
• period -- Budget period (daily, weekly, monthly, quarterly).
• utilization -- Percentage of budget consumed.

Projections (when enabled):

• dailySpendRate -- Your current average daily spend.
• projectedPeriodSpend -- Where you will land if current rate continues.
• budgetRunway -- How many days of spending remain at current rate.
• onTrack -- Boolean indicating whether projected spend stays within allocation.
• utilizationTrend -- One of "healthy", "near-limit", or "over-budget".

Status thresholds:

• Below 70% utilization: Healthy. Spending is on track.
• 70-90% utilization: Moderate. Budget is being consumed. Plan remaining purchases carefully.
• Above 90% utilization: Warning. Nearly exhausted. Only essential purchases should proceed.

Rules

1. Check budget at session start. Your first action in any spending-related task should be checkBudget with projections enabled. Know where you stand before you act.
2. Never spend without checking first. Even if you believe you have plenty of budget, verify. Other payments may have been queued or executed since your last check.
3. Monitor your spend rate. A healthy utilization percentage means nothing if your daily spend rate is accelerating. Watch the trend, not just the snapshot.
4. Alert on danger signs. If your utilizationTrend is "near-limit" or "over-budget", flag this in your reasoning before making any purchase. Explain why the purchase is still justified despite budget pressure.
5. Project your runway. If budgetRunway shows fewer days than remain in the period, you are spending too fast. Slow down or reprioritize.
6. Reserve budget for known upcoming expenses. If you know a renewal or planned purchase is coming, mentally subtract it from your available balance even before it hits.
7. Request budget increases with data. If you genuinely need more budget, present: current utilization, ROI on past spending, specific shortfall amount, and expected return on the additional funds. Vague requests will be denied.

Example Flow

1. Check current status
   → checkBudget { includeProjections: true }
   → Response: $5,000 allocated, $2,100 spent, $2,900 remaining
   → Utilization: 42%, dailySpendRate: $140/day, runway: 20 days
   → Trend: healthy

2. Assess a planned purchase
   → SEMrush Pro costs $129.95/month
   → After purchase: $2,770.05 remaining
   → New utilization: 44.6% -- still healthy
   → Runway would drop to ~19 days -- acceptable

3. Plan for the rest of the period
   → Known upcoming: Google Ads campaign ($500), Canva renewal ($12.99)
   → After all planned spending: $2,257.06 remaining
   → Utilization would reach 54.9% -- on track
   → Proceed with confidence

Budget Health Dashboard

Use this mental model to assess your position:

When to Request a Budget Increase

Request additional budget only when all of the following are true:

1. Your past spending has demonstrable ROI (services purchased are actively used and delivering value).
2. You have a specific, identified need that cannot be met within current allocation.
3. The shortfall amount is quantified (not "I need more" but "I need $300 more for X").
4. The expected return on the additional spend is projected with reasoning.

Budget increase requests go through the Finance agent for review.

Phase-Aware Budget Management

When operating within a phased goal strategy, your standard budget checks are not enough. You must also account for the phase you are in, the budget allocated to that phase, and whether your spending velocity matches the phase timeline.

Before Any Spending Decision

1. Check current phase. Identify which phase is active, its intensity level, and its specific instructions.
2. Calculate phase budget. phase_budget = total_goal_budget * phase_percentage
3. Track phase velocity. velocity = phase_spent / (phase_elapsed_days / phase_total_days)
4. Velocity check:
   • If velocity > 1.2: SLOW DOWN -- you are spending faster than this phase allows. Defer non-essential purchases. Re-evaluate active subscriptions for downgrades.
   • If velocity is 0.8 - 1.2: ON TRACK -- proceed normally within phase guidelines.
   • If velocity < 0.8: EVALUATE -- you may be under-utilizing this phase. If the phase is high-intensity, under-spending could mean missed opportunities. If low-intensity, under-spending is fine.
5. Phase transition protocol:
   • 7 days before transition: compile a phase spending report with ROI data per service
   • Day of transition: cancel subscriptions that were phase-specific (launch tools, blitz campaigns, temporary upgrades)
   • Day after: recalibrate spending velocity to the new phase's budget allocation and intensity

Phase Budget Health Dashboard

Phase Transition Checklist

Use this checklist at every phase boundary:

• All phase-specific subscriptions identified and tagged
• Phase spending report compiled (actual vs planned)
• Underperforming services flagged for cancellation
• High-performing services flagged for continuation
• New phase budget and velocity targets calculated
• Upcoming renewals checked against new phase timeline
• Finance agent notified of phase transition (for business agents)