Artifi Logo
All Plugins

Budget Planning

v1.0.0Core

Four-mode budget planning system

A full-cycle budget planning system with four distinct modes: build from scratch with growth assumptions, copy forward from prior year with adjustments, mid-year forecast blending actuals with projections, and specialized modes for employee cost budgeting (with burden rates) and project budgeting. Every budget goes through 7 mandatory validation checkpoints before submission, including sanity checks on revenue-to-expense ratios and single-line concentration limits.

View on GitHubClone repository

Commands

/create-budget

Build a new budget from scratch, copy forward from prior year, or use a template. Supports monthly/quarterly/annual granularity. Guides through: entity selection, scenario type (budget/forecast/stretch), method choice, growth assumptions, preview table, and submission.

/forecast-budget

Create a mid-year forecast by blending YTD actuals with projected amounts for remaining months. Shows YTD actual vs budget comparison, offers forecast method choice (run rate, trend, seasonal, manual override), and calculates full-year forecast.

/preview-budget

Calculate and preview budget amounts without submitting. Useful for what-if scenarios. Shows preview table by account and period, total revenue vs expense, and net margin. Supports employee and project budget previews.

/review-variance

Analyze budget vs actual variances with drill-down, interpretation guidance, and corrective action recommendations. Classifies variance type (timing, volume, price, mix, one-time) and highlights top unfavorable variances.

How It Works

Build from Scratch

  1. 1

    Discover chart of accounts — fetch active accounts grouped by type

  2. 2

    Fetch prior year actuals as baseline reference

  3. 3

    Determine growth assumptions: rates, seasonal patterns, step changes

  4. 4

    Calculate monthly amounts and show preview table by account and period

  5. 5

    User reviews and explicitly confirms before submission

  6. 6

    Create budget version and bulk submit all lines

  7. 7

    Optionally tag lines by department, project, or employee

Mid-Year Forecast

  1. 1

    Load the approved budget for the current year

  2. 2

    Load YTD actuals for completed months

  3. 3

    Show YTD comparison: Budget vs Actual with variance %

  4. 4

    Choose forecast method: Run Rate, Budget + Trend, Seasonal Adjusted, or Manual Override

  5. 5

    Replace past months with actuals, project remaining months

  6. 6

    User confirms full forecast vs original budget comparison

  7. 7

    Submit forecast version with all lines (actuals + projections)

Employee Cost Budget

  1. 1

    Fetch active employees with compensation and tax settings

  2. 2

    Calculate fully loaded cost per employee (salary + social tax + unemployment + benefits)

  3. 3

    Add headcount plans: planned hires and terminations with pro-rated partial months

  4. 4

    Preview monthly breakdown per department and employee

  5. 5

    Submit with employee and department dimension tags

Validation Checkpoints

Every run must pass these checks before proceeding. If any checkpoint fails, the workflow stops and reports the issue.

Legal entity has an active chart of accounts

Prior year data available for copy-forward and forecast modes

All account numbers in budget exist in the effective accounts view

No single line exceeds 50% of total unless explicitly confirmed

Revenue vs expense ratio sanity check (expenses within 120% of revenue)

User explicitly reviews and confirms preview before submission

Submission succeeds without validation errors

Reference Data Included

Structured knowledge files that drive the plugin's logic. These contain formulas, templates, and regulatory rules — not hardcoded values.

budget-building-methods.md

Global growth rate, per-account rates, seasonal patterns, and step change calculation methods

forecasting-methods.md

Run Rate, Budget + Trend, Seasonal Adjusted, and Manual Override formulas

employee-cost-planning.md

Burden rate calculations (social tax, unemployment, benefits) and pro-rating for partial months

project-budgeting.md

Cost structure templates and per-project profitability calculations

variance-interpretation.md

Variance type classification (timing, volume, price, mix, one-time) and corrective action guidance

submission-format.md

JSON payload structure for budget version and budget line submissions

Built for Artifi, open for everyone

This plugin is designed to work out-of-the-box with the Artifi MCP server for full automation — Claude fetches your data, runs calculations, validates results, and submits entries automatically.

You can also download and adapt it to your own needs. The skills, commands, validation logic, and reference data are all open source. Swap the MCP tool calls for your own backend, or use the reference files as standalone knowledge resources for your Claude projects.

Subscribe to new posts

Get notified when we publish new insights on AI-native finance.