notes on building nest.

by nyla. written during the build.

the determinism rule.

every number in nest comes from typescript, not from the language model. the simulation math, the fertility curve, the city scores — all code. the model writes the questions. the model writes the summary. but the model never writes a number. that line was drawn early and i held it the whole build. the reason matters more than the rule: people will trust this tool with one of the most expensive decisions they ever make. if a number on the screen came from a chatbot pattern-matching against a prompt, it shouldn't be there. honest tool, honest math.

the regret-gap reframe.

the demographic crunch is usually framed as people not wanting kids anymore. the data disagrees. every survey shows people want more children than they actually have. the shortfall isn't desire — it's money, timing, support, and the absence of any tool that helps people plan the family they want the way they'd plan anything else important. that shift in framing changed the whole product. you can't make people want kids. but you can help people who already do. that's a problem worth solving.

what 'honest' meant in practice.

an honest tool refuses to lie even when the prettier answer is right there. nest does this in small specific places. it shows null for cities it doesn't have data on, instead of inventing a score. it tells you the fertility number drops as you wait, instead of softening it. it shows the gap between what you want and what you're likely to get, instead of skipping to a comforting summary. it asks the question you've been avoiding. none of that is hard to build. it's hard to commit to — every cheerful default in modern software pushes the other way. but the moment a tool stops being honest, it stops being useful for a decision this big.

more notes might land here as i keep building. — n.