Afrexai Budget Planner

# Budget Planner

Plan and track budgets using your AI agent. Works for personal finance, project budgets, or department spending.

## What It Does
- Creates structured budgets with categories, allocations, and actuals
- Tracks spending against budget with variance analysis
- Flags overspending early with threshold alerts
- Generates monthly/quarterly budget reports
- Supports multiple budget types (personal, project, department)

## Usage

### Create a Budget
Tell your agent: "Create a monthly budget for [purpose] with a total of $[amount]"

The agent will ask about categories and allocations, then create a structured budget file.

### Budget File Format
Budgets are stored as markdown tables in your workspace:

```markdown
# Budget: [Name] — [Period]
Total: $X,XXX

| Category | Allocated | Spent | Remaining | Status |
|----------|-----------|-------|-----------|--------|
| Rent | $1,500 | $1,500 | $0 | ✅ On track |
| Food | $600 | $450 | $150 | ✅ Under |
| Transport | $200 | $280 | -$80 | 🔴 Over |
```

### Track Spending
Tell your agent: "Log $45 under Food" or "I spent $280 on transport this month"

### Get Reports
- "How's my budget looking?" — summary with variances
- "Where am I overspending?" — flags problem categories
- "Project my end-of-month spend" — extrapolates from current pace

### Alert Thresholds
Default alerts:
- ⚠️ **Warning** at 80% of category allocation
- 🔴 **Over budget** when exceeded
- 📊 **Weekly digest** if enabled

## Tips
- Start with broad categories, refine over time
- Review weekly — catching overspend early is the whole point
- Use "rollover" for categories where unspent funds carry forward
- Compare month-over-month to spot trends

## More Business Tools
Get industry-specific AI agent context packs at [AfrexAI](https://afrexai-cto.github.io/context-packs/) — pre-built configurations that make your agent a domain expert from day one.

# Budget Planner 💰

Turn your AI agent into a budget tracker. Create budgets, log spending, get variance reports, and catch overspending before it becomes a problem.

Works for personal finance, project budgets, or department-level tracking.

## Features
- **Structured budgets** with categories and allocations
- **Spending tracking** with simple natural language ("spent $45 on food")
- **Variance analysis** — see where you're over/under at a glance
- **Threshold alerts** — warnings at 80%, flags when over
- **Monthly reports** with trend analysis

## Install
```
clawhub install afrexai-budget-planner
```

## Quick Start
1. "Create a monthly budget for $3,000"
2. "Log $1,500 for rent"
3. "How's my budget looking?"

That's it. Your agent handles the tracking, math, and reporting.

## Part of the AfrexAI Toolkit

Free skills that make AI agents actually useful:
- [Budget Planner](https://clawhub.com/skills/afrexai-budget-planner) (this one)
- [KPI Tracker](https://clawhub.com/skills/afrexai-kpi-tracker)
- [SWOT Analyzer](https://clawhub.com/skills/afrexai-swot-analyzer)
- [Humanizer](https://clawhub.com/skills/afrexai-humanizer)
- [Prospect Researcher](https://clawhub.com/skills/afrexai-prospect-researcher)

Need more? **[Full context packs for 10+ industries →](https://afrexai-cto.github.io/context-packs/)**

Built by [AfrexAI](https://afrexai-cto.github.io/context-packs/) 🖤💛