finance-manager

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: finance-manager
description: Comprehensive personal finance management system for analyzing transaction data, generating insights, creating visualizations, and providing actionable financial recommendations. Use when users need to analyze spending patterns, track budgets, visualize financial data, extract transactions from PDFs, calculate savings rates, identify spending trends, generate financial reports, or receive personalized budget recommendations. Triggers include requests like "analyze my finances", "track my spending", "create a financial report", "extract transactions from PDF", "visualize my budget", "where is my money going", "financial insights", "spending breakdown", or any finance-related analysis tasks.
---

# Finance Manager

A comprehensive toolkit for personal finance management that processes transaction data, performs sophisticated financial analysis, generates actionable insights, and creates beautiful visual reports.

## Core Capabilities

1. **Transaction Data Processing**: Extract financial data from PDFs, CSVs, or JSON files
2. **Financial Analysis**: Calculate key metrics, identify spending patterns, and track savings
3. **Visualization**: Generate interactive HTML reports with charts and graphs
4. **Budget Recommendations**: Provide personalized, actionable advice based on spending patterns
5. **Trend Analysis**: Identify spending patterns, anomalies, and opportunities for optimization

## Workflow

### 1. Data Extraction and Preparation

**For PDF files:**
```bash
python scripts/extract_pdf_data.py <input.pdf> <output.csv>
```

**For CSV/JSON files:**
- Ensure data has columns: `Date`, `Description`, `Income` (category), `Type`, `Amount`
- Date format: YYYY-MM-DD or parseable date string
- Amount: Positive for income, negative for expenses

### 2. Financial Analysis

Run comprehensive analysis on transaction data:
```bash
python scripts/analyze_finances.py <transactions.csv> > analysis_output.json
```

**Output includes:**
- Summary statistics (total income, expenses, net savings, savings rate)
- Spending trends (daily averages, top expenses, category percentages)
- Budget recommendations (personalized based on spending patterns)
- Visualization data (prepared for charting)

### 3. Report Generation

Create interactive HTML report with visualizations:
```bash
python scripts/generate_report.py <analysis_output.json> <report.html>
```

**Report features:**
- Summary dashboard with key metrics
- Interactive pie chart showing spending by category
- Bar chart comparing income vs expenses over time
- Color-coded indicators (green for positive, red for negative)
- Personalized recommendations section
- Responsive design for all devices

### 4. Complete Workflow Example

```bash
# Extract data from PDF
python scripts/extract_pdf_data.py finance_data.pdf transactions.csv

# Analyze the data
python scripts/analyze_finances.py transactions.csv > analysis.json

# Generate visual report
python scripts/generate_report.py analysis.json financial_report.html
```

## Key Metrics and Benchmarks

### Savings Rate
```
Savings Rate = (Total Income - Total Expenses) / Total Income × 100
```

**Benchmarks:**
- Below 10%: Needs improvement
- 10-20%: Good
- 20-30%: Excellent  
- Above 30%: Outstanding

### Category Guidelines (% of income)
- Housing: 25-30%
- Transportation: 10-15%
- Food: 10-15%
- Utilities: 5-10%
- Savings: Minimum 20%

For detailed frameworks and methodologies, see `references/financial_frameworks.md`.

## Analysis Features

### Summary Statistics
- Total income and expenses for the period
- Net savings (can be positive or negative)
- Savings rate percentage
- Transaction count
- Date range covered

### Spending Trends
- Daily average spending
- Top 5 largest expenses with details
- Category percentage breakdown
- Spending patterns over time

### Budget Recommendations

The system generates personalized recommendations based on:
- Savings rate thresholds
- Category spending percentages
- Income