All plugins
v1.0.0·Core·MIT · forkable

artifi-core-budget-planning

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 the repo
COMMANDS · 4

Slash commands shipped.

/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

Workflow steps · agent runs · validation gates.

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 · 7

Every run must pass.

If any checkpoint fails, the workflow stops and reports the issue. Nothing posts to the ledger until every check passes.

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 · 6 FILES

Structured knowledge included.

Formulas, templates, regulatory rules — not hardcoded values. Forkable per firm, per client.

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

MIT · BUILT FOR ARFITI · OPEN FOR EVERYONE

Designed to work out-of-the-box with the Arfiti ledger. Claude fetches your data, runs calculations, validates results, and submits entries automatically through MCP.

Or fork it. Skills, commands, validation logic, and reference data are all MIT-licensed. Swap the MCP tool calls for your own backend, or use the reference files as standalone Claude project resources.

SUBSCRIBE · NEW POSTS · NO SPAM

Get the next post in your inbox.

Practitioner notes on AI-native finance. One email when something new ships. Unsubscribe any time.