The world is a budget.Matter goes round, energy runs out.
The paper spec that sits under the Design Charter. It fixes what is conserved and how it moves — the foundation every later rule is built on. A rule defines the physics, never the outcome.
The one idea everything rests on — energy is an open river, matter is a closed wheel.
01
Currency layer
● LOCKED
The conserved quantities, their forms, and how they move. Three currencies: one that flows, two that cycle.
1.1 Conserved quantities
Two conserved matter elements — carbon (C) and nitrogen (N). Each exists as inorganic (dissolved, in local fields) or organic (in biomass / dead matter).
Total C and total N across the whole board are fixed. Nothing is minted or destroyed.
Energy is a one-way flux, never a stored pool. In as light, degrades at every conversion, out as heat. Banked only as reduced (organic) carbon.
Organic matter returns to inorganic by two paths: excretion — a living cell dumping the element it ate but can't use (§1.4) — and death. Death deposits the body's organic C/N into an organic detritus pool; only decomposition then returns it to inorganic. Death never mineralizes directly: a dead cell's carbon still holds its energy, so skipping the organic step would destroy that energy and starve decomposers.
Division conserves. Daughter cells partition the parent's structure and reserve — their C, N and stored energy sum to the parent's. (When/how to divide is §3/§5; the conservation is §1's.)
1.2 Spatial modellocal fields + diffusion
Inorganic C and N sit in local per-cell fields, coupled by diffusion. The diffusion rate is a single dial — and global / well-mixed is just its high-diffusion limit, so we model one mechanism, not two.
One dial spans the whole space — from sharp local depletion zones to a single shared pool.
Guardrail: no directional transport that can move matter permanently out of reach. Plain diffusion spreads regenerated nutrients back out — which is exactly what avoids the prior detritus-stranding failure.
Biomass isn't one lump. Following dynamic-energy-budget theory, a cell is split into two compartments:
Reserve — mobilizable stores of C and N (and energy, banked as reserve carbon). Costs no maintenance. This is where variable stoichiometry lives: reserve C:N is whatever's been taken up, so luxury uptake and lean-time draw-down both happen here.
Structure — the built body, at a near-fixed structural C:N. It costs maintenance in proportion to its amount, and it can't be reclaimed — burning structure to survive is death.
Growth = converting reserve → structure, gated by Liebig × Droop: limited by the scarcest of {energy, reserve C, reserve N} measured relative to a subsistence minimum, via a saturating (hyperbolic) response. Below the subsistence reserve level, growth stops and the cell starves.
Reserve is bounded — capped as a density (reserve per unit structure), not an absolute amount. To bank more you must build more structure, which costs maintenance — so hoarding is never free, and there are no immortal dormant hoarders locking matter out of circulation. At the cap, surplus uptake / fixation overflows to the local field (conserved — real carbon exudation by nutrient-limited cells).
Uptake scales with surface, upkeep with volume — so growth flattens to a max size on its own. No hard cap needed.
Max size emerges — because uptake scales with surface area but maintenance with volume, growth slows to an asymptote where upkeep eats all income. This retires the old hard "max quota" constant; the ceiling is now physics.
Homeostasis emerges — a cell's stoichiometric flexibility is its reserve fraction. Reserve-heavy cells (autotrophs banking carbon) are flexible; structure-heavy cells (consumers) are naturally more homeostatic. The producer/consumer split falls out — it isn't coded.
This is the keystone addition. One extra compartment buys three things at once: a size cap that's earned not imposed, a clean definition of starvation (burn reserve; die when structure can't be maintained), and the producer–consumer homeostasis gradient for free. It also adds a real size tradeoff — bigger cells pay more just to exist.
1.4 Energy & matter bookkeepingper-tick budget
energy budget (this tick) = light captured + carbon respired → spent on: maintenance (∝ structure) · uptake · movement · growth · optionally carbon fixation → anything unspent dissipates. Nothing carries to the next tick.
Maintenance is paid first and scales with structural biomass — bigger cells owe more just to persist (metabolic theory). If the budget can't cover it, the cell draws down reserve; when reserve can't cover it either, it dies.
A battery that loses charge both ways — you can never burn what you fixed for a net gain.
Why no separate energy pool: energy storage is carbon storage in real bioenergetics. Folding it into carbon removes a state variable, makes energy's one-way nature structural rather than policed, and lets light fund immediate work directly (no fix-then-burn tax). Energy↔carbon is a fixed exchange rate — a constant.
Excretion & remineralization closing the matter loop
A consumer that eats off-ratio food (say, carbon-rich prey) keeps the element it's short on and excretes the surplus straight back to the inorganic field. This is mandatory for conservation — the atoms must go somewhere — and it's also the main way consumers and decomposers hand the limiting nutrient back to producers. Consumer-driven nutrient recycling is a real feedback, not a side effect.
The surplus element a consumer can't use is exactly what producers are starving for.
Inter-cell transfer the multicellularity substrate
When clonally-bonded cells share resources, the physics is fixed even though the decision to bond or share is an effector (§3):
Matter is conserved in transit — C and N moved between cells are never lost. A matter leak would be the mirror of minting matter, so it's forbidden.
The bond is structure — it costs matter to build and upkeep to hold (the §1.4 maintenance ∝ structure). This is the always-on tax on staying together.
Active transport burns energy — moving resources to a neighbour costs a per-unit energy drawn from the §1.4 budget, dissipated as heat. The loss lives in the energy currency, never in matter.
Sharing has to earn its keep — upkeep + transport energy — but no atom is ever lost doing it.
This is all §1 owes multicellularity: conservative transfer with a real cost. The adhesion and sharing effectors, and the benefits that make colonies pay (a predation size-refuge, division of labour), are §3/§4 — and they must stay emergent, never coded as a bonus.
1.5 Scope & deliberate omissions
Energy sources: light or eaten organic carbon only. Chemoautotrophy (energy from chemical gradients) is out of scope — addable later as an energy-input effector, not a stored pool.
No oxygen / redox. Real aquatic systems track O₂ too (photosynthesis makes it, respiration and decomposition consume it), which creates anoxic zones and redox-gradient niches. We model only C, N and energy — so those niches simply don't exist here. A clean, conscious omission, not an oversight.
Transport is diffusion only — no directional currents/advection (consistent with the §1.2 anti-stranding guardrail).
N is a representative second element. The biology would read the same with P (often the freshwater limiter); we picked one to keep it at two elements.
1.6 The emergent payoff — and its limita result, not a coded rule
Because energy is stored carbon, one genuine axis falls out of the mechanism: autotrophy. Autotroph → mixotroph → heterotroph is a real, monotonic gradient — the fraction of your carbon you fix yourself vs. acquire pre-made. (It collapses to a single axis only because we scoped out chemoautotrophy in §1.5; in full microbiology, carbon source and energy source are orthogonal.)
But that axis does not linearise the guilds. Predator, grazer and decomposer are all full heterotrophs — they sit at the same point on the autotrophy axis. What separates them is a second, orthogonal axis: the source / state of the organic carbon they eat — living autotroph (graze), living cell (predate), or dead matter (decompose).
Two axes, not one. Predator and decomposer share an axis-A position; the band is what tells them apart.
So guild identity = (axis A position) × (axis B band), and the decomposer band exists because death now deposits a distinct organic detritus pool (§1.1). Both axes still emerge — neither is a hard-coded guild label; we classify after the fact, we don't build guilds in.
1.7 Open threads handed forward
O1 · DETRITUS FORM Partly resolved by the pressure-test: death must deposit an organic detritus pool (§1.1), so detritus exists. What's left is its form & dynamics — dissolved vs particulate, whether it sinks, how decomposers access it — → §3.
O2 · MAINTENANCE COST Maintenance scales with structural biomass (§1.4); the per-unit rate, plus the subsistence reserve level, the max reserve density, and the surface/volume exponents that set max size, are constants → §6.
O3 · LIGHT COMPETITION Nutrients are local & depletable, but light is currently a static gradient nobody depletes — so autotrophs compete for N, not light. Decide whether light is attenuated by biomass (self-shading → vertical niches, motility pressure) or stays static → §2.
02
World & environment
TODO
Geometry, the photic light gradient, field-diffusion specifics, time / tick structure, boundaries.
Carried in from the §1 pressure-test: resolve O3 (is light depletable / self-shading?); and conservation requires closed or periodic field boundaries (no-flux) plus a conservative diffusion stencil, or total C/N silently leaks.
03
In / out — sensing & effectors
TODO
What a cell senses (inputs) and what it can do (effectors): uptake, photosynthesis, respiration, movement, predation, decomposition, division. Resolves O1's form question.
Carried in from the §1 pressure-test: the decisive anti-generalist tradeoff lives here, not in §1. §1 gives only the shared budget + size cost; §3 must make being good at one function (photosynthesis / feeding / movement apparatus) cost being good at another — or "no tradeoff → generalist wins" returns.
04
The simulation
TODO
Tick order, how the world updates each step, conservation accounting per step.
Carried in from the §1 pressure-test: single-pass accounting per tick (no respiring the same carbon twice, demand-driven respiration), and a running C/N total that must stay flat — the canary for any conservation leak.
05
Genome
TODO
Representation (GRN or reconsider) and mutation operators.
06
Constants
TODO
Every tuned number in one place: diffusion rate, η_fix, η_resp, energy/carbon exchange, structural C:N, subsistence reserve level, max reserve density, surface/volume exponents (→ max size), maintenance rate, bond upkeep, per-unit transport energy.
Decision log — why, not just what
3 pools, not 2
energy + C + N, to get nutrient limitation (Liebig) and stoichiometric tradeoffs — the charter's richest lever — for one extra pool.
Local fields + diffusion
spans local ↔ global through one constant; avoids a second system; diffusion counteracts matter-stranding.
Variable quotas, not fixed C:N
richer (ecological stoichiometry) and cleaner given C and N are tracked separately regardless.
Energy as flux + carbon-reserve
faithful to real bioenergetics, removes a state variable, and makes the trophic web emerge from one mechanism. It yields one genuine axis (autotrophy: self-fixed ↔ eaten); the guilds at the heterotroph end are split by a second axis (carbon source: live autotroph / live cell / detritus). Per-tick budget added so light can power work directly.
Reserve / structure split (DEB)
the keystone of the v0.4 revision. Buys an emergent max size (surface-uptake vs volume-maintenance), a clean starvation definition, a size tradeoff, and the producer/consumer homeostasis gradient — all from one extra compartment. Retires the hard-coded max-quota cap.
Liebig × Droop on quota-vs-subsistence
kept Liebig minimum (beats the multiplicative rule empirically) but moved the per-nutrient term onto reserve quota relative to a subsistence minimum, via a saturating response — the validated phytoplankton-growth form. The subsistence level doubles as the death floor.
Excretion / consumer-driven recycling
off-ratio feeders excrete the surplus element back to inorganic — conservation-mandatory, and the feedback that returns the limiting nutrient to producers.
Oxygen, currents, P — declared out of scope
O₂/redox, advective currents, and phosphorus are conscious omissions (parsimony), now stated so the missing niches are a choice, not an accident.
Inter-cell transfer — conservative, with a cost
matter conserved in transit (a leak would be anti-conservation); the tradeoff comes from bond upkeep + per-unit transport energy. This is all §1 owes multicellularity — effectors and benefits stay emergent in §3/§4. The cell remains the unit of accounting; colonies are emergent.
Bounded reserve density (pressure-test fix)
reserve is capped per unit structure, with overflow exuded to the field — closes the unbounded-hoarder / immortal-dormancy exploit and keeps matter circulating.
Death routes to organic detritus (pressure-test fix)
because a dead cell's carbon still holds energy, death must deposit organic detritus and let decomposition mineralize it — direct mineralization would destroy that energy and re-create the decomposer-starvation failure.
Division conserves (pressure-test fix)
daughters partition the parent's structure, reserve and stored energy — stated explicitly so reproduction can't mint or lose matter.