Open standard · MIT

Finance deserves professional standards.

Code has CLAUDE.md. Design has DESIGN.md. Finance still runs on institutional memory: what the model is for explained on a call, its structure in someone's head, its conventions in an email thread.

FINANCE.md is the standard that fixes this. One file. Versioned. Readable by any agent, any tool, any analyst.

v0.1 draft · Published May 2026

What it looks like

One file. Front matter + prose.

FINANCE.md — front matter
# FINANCE.md
finance_md: "0.1"
model_name: "Distrib SAS — FY2026 budget"
currency: EUR
secondary_units: [tonnes]
language: fr
owners: ["[email protected]"]
sources: [pennylane, manual_excel]
glossary:
  Marge brute commerciale: "Revenue minus purchase cost only. Excludes logistics."
  CA Frais: "Cold-chain revenue — separate margin profile from dry goods."
FINANCE.md — body
## What this model is for

FY2026 budget for Distrib SAS, presented to the bank in March.
Conservative by design: anything that moves covenant headroom gets flagged.

## Statement structure

P&L: revenue by warehouse, gross margin, EBITDA, net income.
Net income flows to retained earnings; the cash flow closing
balance feeds the balance sheet cash line.

## Units and sign convention

All amounts in thousands EUR. Costs appear as positive numbers.
An entry of 1 200 means €1.2 million.

Front matter is machine-readable. Body is human-readable. Both travel with the model.

Where it lives

Next to your other conventions. At every level.

Alongside
AGENTS.md / CLAUDE.md   — AI and coding conventions
DESIGN.md               — visual and product standards
FINANCE.md              — financial modeling conventions
At each scope
Sector template   FINANCE.md  — PE LBO, SaaS FP&A, infrastructure...
  └── Organization FINANCE.md  — group-wide (currency, language, glossary)
        └── Model  FINANCE.md  — this model's objective and statement structure

An AI agent traverses the hierarchy automatically — it knows which convention applies, at which scope, and why. No re-explanation across sessions.

What you can define

Context, structure, glossary, and more.

  • What the model is for — one paragraph: what it produces, for whom, by when
  • Statement structure — the P&L, cash flow and balance sheet sections, and how they connect
  • Model name & currency — the only two facts an agent strictly needs upfront
  • Secondary units — tonnes, SKU, MW, tokens, seats… anything the model tracks alongside money
  • Language — agents reply in your team’s working language by default
  • Owners & sources — who answers the questions, what systems feed the model
  • Glossary — company-specific terms, sector KPIs, redefined metrics
  • Accounting policies — EBITDA, working capital, FX, net debt: optional, in the body prose, when the model has them
  • Rationale — every choice justified next to itself, audit-trail style

Per file. Per team. Per organization.

Read the spec. Or generate yours.

FINANCE.md is open under MIT. Layerz generates one automatically from your model and versions it alongside your model history.