budget-review

namespace	aiwg
name	budget-review
platforms	["all"]
description	Project directory path (default current directory)
commandHint	{"argumentHint":"<review-period> [--budget-area value] [--project-directory value] [--guidance \"text\"] [--interactive]"}

Budget Review Command

Analyze marketing budget performance with spend tracking, ROI analysis, and optimization recommendations.

What This Command Does

1. Tracks Spending

   • Budget vs. actual
   • Category breakdown
   • Variance analysis

2. Analyzes ROI

   • Channel efficiency
   • Campaign ROI
   • Cost per acquisition

3. Provides Recommendations

   • Reallocation opportunities
   • Efficiency improvements
   • Forecasting

Orchestration Flow

Budget Review Request
        ↓
[Budget Planner] → Budget Analysis
        ↓
[Marketing Analyst] → Performance Correlation
        ↓
[Attribution Specialist] → Channel ROI
        ↓
[Campaign Orchestrator] → Campaign Efficiency
        ↓
[Reporting Specialist] → Budget Report
        ↓
Budget Review Complete

Agents Involved

Agent	Role	Output
Budget Planner	Lead analysis	Budget tracking
Marketing Analyst	Performance	ROI analysis
Attribution Specialist	Attribution	Channel efficiency
Campaign Orchestrator	Campaigns	Campaign costs
Reporting Specialist	Reporting	Final report

Output Artifacts

Saved to .aiwg/marketing/budget/:

• budget-review-{period}.md - Budget analysis
• roi-analysis.md - ROI breakdown
• variance-report.md - Budget vs. actual
• recommendations.md - Optimization suggestions
• forecast.md - Forward projections

Parameter Handling

--guidance Parameter

Purpose: Provide upfront direction to tailor priorities and approach

Examples:

--guidance "Q4 optimization, reallocate underperforming channels"
--guidance "New budget request justification"
--guidance "Year-end close, maximize ROI"

How Applied:

• Parse guidance for keywords: priority, timeline, audience, focus, constraints
• Adjust agent emphasis and output depth based on stated priorities
• Modify deliverable order based on timeline constraints
• Influence scope and detail level based on context

--interactive Parameter

Purpose: Guide through discovery questions for comprehensive input

Questions Asked (if --interactive):

1. What is the review period?
2. What triggered this review?
3. Are there specific channels to analyze?
4. What is the decision context (optimization, new request)?
5. Who needs this analysis?

Usage Examples

# Quarterly review
/budget-review "Q3 2024"

# YTD paid media
/budget-review "YTD" --budget-area paid-media

# Monthly all areas
/budget-review "October 2024" --budget-area all

# With strategic guidance
/budget-review "Example" --guidance "Your specific context here"

# Interactive mode
/budget-review "Example" --interactive

Success Criteria

• Spending tracked against budget
• Variances explained
• ROI calculated by channel/campaign
• Optimization opportunities identified
• Reallocation recommendations provided
• Forecast updated

References

• @$AIWG_ROOT/agentic/code/frameworks/media-marketing-kit/README.md — Media marketing kit framework overview
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/vague-discretion.md — Measurable ROI thresholds and review criteria
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/subagent-scoping.md — Multi-agent budget analysis orchestration
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference