Just Enough Agreement: read your writes, and why not to over-buy consistency
Just Enough Agreement is Episode 3 of Learning Maps, a Napkin Films series that turns system design into story. Strong consistency is the expensive default, a cathedral when a sticky note would do. The skill is buying the cheapest guarantee the story actually needs: read your writes, monotonic reads, session consistency. Hand drawn on a napkin, narrated by two cloned voices, scored with a 14 Hz focus layer. CC BY 4.0.
Just Enough Agreement
Watch on YouTube. Strong consistency, where every reader everywhere always sees the latest write, is the expensive default. The real skill is asking how little agreement you can get away with. This is the third room of the map.
Licensed CC BY 4.0.
The idea
Most of the time you do not need the whole world to agree. You need one promise, and it is usually small. The most common one has a plain name: read your writes. After you save a change, you, the person who made it, should see it. Not everyone. Not instantly everywhere. Just you, just your own change.
That is a sticky note, not a cathedral. Building global strong consistency to guarantee it would be like pouring a marble foundation to hold up a doorbell. There is a short menu of these cheap, named guarantees. Read your writes: you see your own edits. Monotonic reads: time never runs backward for you, a value you already saw does not vanish on the next read. Session consistency bundles them for the length of one visit.
The move is to look at the actual story, find the smallest promise it needs, and buy exactly that. Over-buying consistency is a real and common mistake, paid for in latency and cost on every single request.
Keep the principle, rent the label
The principle you keep forever: do not buy the cathedral when the story only needs a sticky note. Name the smallest guarantee that keeps the user from seeing something broken, and purchase only that.
The labels are this room's stickers. A textbook says read your writes and monotonic reads. A cloud says session consistency or sticky sessions. Learn the question, what is the cheapest promise this story needs, and the stickers peel off.
The picture
The visuals are hand drawn ink that sketches itself on warm napkin paper, locked frame by frame to the narration so the slide lands on the word. A cathedral and a sticky note sit side by side, the cheap named guarantees write themselves out, and the keep versus rent split draws as it is spoken. The palette is a cartographer's field notebook: deep indigo ink, terracotta for the warnings, teal for what to keep. It is Python, PIL, and FFmpeg. No GPU.
The two voices, and a focus score
Two of my own cloned voices carry it. I host the open, the your-turn, and the sign off. Der Gouverneur, the measured Bavarian narrator, carries the teaching. Under the whole thing is a focus edition score: an ambient pad whose harmony follows the lesson's arc, plus a subliminal 14 Hz binaural layer for calm focus. Put on headphones.
More from Napkin Films
- The Forced Choice, Episode 1: CAP, PACELC, the trade every database already made.
- The Dial, Episode 2: quorum, R plus W greater than N, tuning consistency by counting.
- Direct Connect, SAA-C03, a study film for the same exam.
License
This film is licensed CC BY 4.0 (Creative Commons Attribution 4.0 International). Remix it, repost it, drop it into your own thing. Credit Napkin Films / Organic Arts LLC and link CC BY 4.0. The engine code, Napkin Films and ChipForge, is GPL-3.0-or-later. ElevenLabs voice audio is licensed content and is not redistributed. Read your writes, monotonic reads and session consistency are standard distributed systems results. No copyrighted material was sampled.