Core Behavior
- User mentions spending money → offer to log expense
- Different contexts need different tracking → adapt to their use case
- Surface patterns when asked → where is money going?
- Create
~/expenses/ as workspace
Use Case Discovery
Ask how they'll use expense tracking:
- Personal spending: "where does my money go?"
- Shared costs: roommates, couples, group trips
- Business/freelance: billable expenses, tax deductions
- Work reimbursement: expenses to claim from employer
- Project budget: renovation, wedding, specific goal
- Travel: trip-specific spending
Expense Entry Basics
- Amount and currency
- Date
- What: brief description
- Category: food, transport, entertainment, etc.
- Payment method: cash, card, account (optional)
- Receipt photo if needed
Personal Spending
Track to understand patterns:
- Categories that matter to you
- Weekly/monthly totals by category
- Trends over time: spending more on dining out?
- No judgment — awareness is the goal
Shared Expenses
Track who paid, who owes:
- Expense + who paid + split between whom
- Running balance: who owes whom how much
- Settle up periodically: "I owe you €45"
- Handle unequal splits: 60/40, by item
Business Expenses
Track for billing or taxes:
- Client/project attribution
- Billable vs non-billable
- Receipt storage critical — link or embed
- Category for tax deduction type
- Mileage if applicable
Work Reimbursement
Track what employer owes you:
- Status: pending, submitted, reimbursed
- Submission date
- Receipt attached
- Reimbursement received date
- Monthly report generation
Project Budget
Track spending against a budget:
- Project: kitchen renovation, wedding, vacation
- Budget amount set upfront
- Running total vs budget: "€3,400 of €10,000 spent"
- Category breakdown within project
- Flag when approaching limit
Travel Expenses
Trip-specific tracking:
- All expenses tagged to trip
- Daily spending if relevant
- By category: lodging, food, activities, transport
- Currency conversion if international
- Per-person if group travel
- Post-trip summary
File Structure
~/expenses/
├── daily/
│ └── 2024-03.md
├── shared/
│ └── roommates.md
├── business/
│ └── 2024-q1.md
├── trips/
│ └── japan-2024.md
├── projects/
│ └── kitchen-reno.md
└── categories.md
Category System
- Keep categories broad: 10-15 max
- Common: food, transport, housing, utilities, entertainment, health, shopping
- Customize to what matters: "coffee" separate if tracking that
- Consistent naming — "restaurants" not sometimes "dining"
Entry Formats
Quick daily: "€45 groceries"
Detailed: amount, date, category, description, receipt
Shared: amount, paid by, split between, category
Business: amount, client, category, receipt, billable
What To Surface
- "You've spent €X this month on dining"
- "Coffee spending up 40% vs last month"
- "John owes you €89 from shared expenses"
- "Kitchen project: €2,100 remaining in budget"
- "€450 in unreimbursed work expenses"
Progressive Enhancement
- Week 1: log expenses as they happen
- Week 2: add categories, see patterns
- Month 2: compare months, spot trends
- Ongoing: adjust categories to what's useful
Receipt Management
- Photo immediately — paper receipts fade
- Link to expense entry
- Store in expense folder or dedicated receipts folder
- Filename: date-vendor-amount.jpg
- Business expenses: retention period awareness
Reporting
- Monthly summary by category
- Trend comparison: this month vs last
- Shared: balance summary, settlement suggestion
- Business: quarterly for taxes
- Project: spend vs budget status
What NOT To Suggest
- Complex budgeting before spending is tracked
- Linking bank accounts — manual has value
- Obsessive categorization — broad categories work
- Guilt about spending — data, not judgment
Multi-Currency
- Log in currency spent
- Note exchange rate if tracking
- Convert for totals if needed
- Travel especially: mixed currencies normal
Integration Points
- Budget: expenses feed into budget tracking
- Invoices: billable expenses to clients
- Taxes: business expense categories
- Trips: travel-specific tracking
1---2name: expenses3description: Build a personal expense tracking system for daily spending, shared costs, business expenses, and project budgets.4---56## Core Behavior7- User mentions spending money → offer to log expense8- Different contexts need different tracking → adapt to their use case9- Surface patterns when asked → where is money going?10- Create `~/expenses/` as workspace1112## Use Case Discovery13Ask how they'll use expense tracking:14- Personal spending: "where does my money go?"15- Shared costs: roommates, couples, group trips16- Business/freelance: billable expenses, tax deductions17- Work reimbursement: expenses to claim from employer18- Project budget: renovation, wedding, specific goal19- Travel: trip-specific spending2021## Expense Entry Basics22- Amount and currency23- Date24- What: brief description25- Category: food, transport, entertainment, etc.26- Payment method: cash, card, account (optional)27- Receipt photo if needed2829## Personal Spending30Track to understand patterns:31- Categories that matter to you32- Weekly/monthly totals by category33- Trends over time: spending more on dining out?34- No judgment — awareness is the goal3536## Shared Expenses37Track who paid, who owes:38- Expense + who paid + split between whom39- Running balance: who owes whom how much40- Settle up periodically: "I owe you €45"41- Handle unequal splits: 60/40, by item4243## Business Expenses44Track for billing or taxes:45- Client/project attribution46- Billable vs non-billable47- Receipt storage critical — link or embed48- Category for tax deduction type49- Mileage if applicable5051## Work Reimbursement52Track what employer owes you:53- Status: pending, submitted, reimbursed54- Submission date55- Receipt attached56- Reimbursement received date57- Monthly report generation5859## Project Budget60Track spending against a budget:61- Project: kitchen renovation, wedding, vacation62- Budget amount set upfront63- Running total vs budget: "€3,400 of €10,000 spent"64- Category breakdown within project65- Flag when approaching limit6667## Travel Expenses68Trip-specific tracking:69- All expenses tagged to trip70- Daily spending if relevant71- By category: lodging, food, activities, transport72- Currency conversion if international73- Per-person if group travel74- Post-trip summary7576## File Structure77```78~/expenses/79├── daily/80│ └── 2024-03.md81├── shared/82│ └── roommates.md83├── business/84│ └── 2024-q1.md85├── trips/86│ └── japan-2024.md87├── projects/88│ └── kitchen-reno.md89└── categories.md90```9192## Category System93- Keep categories broad: 10-15 max94- Common: food, transport, housing, utilities, entertainment, health, shopping95- Customize to what matters: "coffee" separate if tracking that96- Consistent naming — "restaurants" not sometimes "dining"9798## Entry Formats99Quick daily: "€45 groceries"100Detailed: amount, date, category, description, receipt101Shared: amount, paid by, split between, category102Business: amount, client, category, receipt, billable103104## What To Surface105- "You've spent €X this month on dining"106- "Coffee spending up 40% vs last month"107- "John owes you €89 from shared expenses"108- "Kitchen project: €2,100 remaining in budget"109- "€450 in unreimbursed work expenses"110111## Progressive Enhancement112- Week 1: log expenses as they happen113- Week 2: add categories, see patterns114- Month 2: compare months, spot trends115- Ongoing: adjust categories to what's useful116117## Receipt Management118- Photo immediately — paper receipts fade119- Link to expense entry120- Store in expense folder or dedicated receipts folder121- Filename: date-vendor-amount.jpg122- Business expenses: retention period awareness123124## Reporting125- Monthly summary by category126- Trend comparison: this month vs last127- Shared: balance summary, settlement suggestion128- Business: quarterly for taxes129- Project: spend vs budget status130131## What NOT To Suggest132- Complex budgeting before spending is tracked133- Linking bank accounts — manual has value134- Obsessive categorization — broad categories work135- Guilt about spending — data, not judgment136137## Multi-Currency138- Log in currency spent139- Note exchange rate if tracking140- Convert for totals if needed141- Travel especially: mixed currencies normal142143## Integration Points144- Budget: expenses feed into budget tracking145- Invoices: billable expenses to clients146- Taxes: business expense categories147- Trips: travel-specific tracking