Reality-Driven Development
Or why specification is media about a solution, not the solution itself.
The elders kept the old bridge in drawings, unfolded them every morning on a long table in the hall, weighed the corners with brass cups, and spoke in low voices as if the paper were sleeping; on that paper the bridge wore clean ribs, obedient arches, a measured belly over water where no rain bent it, no cart broke it, no child ran too early, no winter entered the joints, so it became the safest bridge in the town, safest because nobody had ever stepped on it.
Beyond the hall the river moved with brown shoulders under the mist, taking branches, foam, dead leaves, once a goat, once half a shed roof, and carrying all of it past the market with the same dull patience, while people still came to the bank and looked across at the mill, the orchard, the road to the northern stones: everything visible, near enough for the eye, too far for the foot.
A mason named Yrjö lived by the kiln and slept badly, hearing at night the river knock stones together like teeth, then in the morning going to the hall to stand near the door and watch the elders slide little wooden markers across the drawings where every future plank had a name, where a support that did not yet exist already had a disputed angle, where sealed jars held river mud labelled by season and mood.
Yrjö said nothing and went to the bank with a rope, three stakes, and a plank from his own shed.
Before noon the first stake slipped, the second split under the hammer, and the wet plank twisted and threw him waist-deep into the river while boys laughed from the grass and an old woman crossed herself; he came out coughing, one shoe gone, blood on his thumb, and dragged the plank back up through the mud until, evening by evening, the bank near the willow taught him false ground, the stone under the reeds taught him good bearing, and by the third day a rope held.
After supper the hall heard of it in fragments: one elder muttered about a disturbed sequence, another about a crossing not approved, a third about work that could not be recognized until it had been named. When morning came he was on the bank again with two apprentices at his heels.
The river took a hammer and returned a lesson, took a badly cut brace and returned a better angle, took pride each day and left a darker knowledge behind, while the bridge climbed its stages: a wound in the mud, a crooked line, a trembling strip a dog could cross, a narrow way for one person holding breath, and each evening Yrjö scarred the drawings with soot and knife scratches because the paper changed only after the wood had changed, the words trailing the bruises.
In spring a stranger brought a speaking box with a glass face and a voice like a clerk, a priest, and a flute played under ice, a thing that could read the elders’ drawings, remember old floods, count loads, compare knots, list weak beams, and suggest where the next support might stand, until the elders feared it, loved it, and began asking for more drawings than any hand could copy.
Yrjö carried the box to the river, set it on a dry stone, and when it spoke of the northern current he checked the water, when it spoke of rot he opened the beam, when it proposed three braces he built the smallest first and listened to it complain under weight, useful sometimes and fog sometimes, treating both the same, mallet within reach.
By midsummer the town had changed its disease but not its hunger: the hall filled with scrolls brighter than the old ones, the box lending language for courage not yet earned, and its descriptions of the finished bridge grew so beautiful that people began to speak as if they had already crossed, praising future timber, imagined railings, the communal promise of a road still ending in mud, while the drawings multiplied like pale mushrooms.
Yrjö stopped visiting the hall because it had turned into a warm room where the town’s nervous system could rehearse order without paying in weight, whereas on the bank that nervous system narrowed to a foot, a board, water, and consequence; two honest rooms, though only one fed flour across the river.
He stayed where the river could interrupt him, where rain loosened a joint, a cart cracked a plank, a child found a gap too wide for a small foot, a horse refused the sound of hollow boards, each trouble arriving without ceremony and staying until the bridge changed; the apprentices learned the note of a beam under load, a low truth in a good piece, a thin lie in a bad one, then tink, tonk, särö, a quiet ring, the hand ahead of the mouth.
One evening Maaria, the youngest apprentice, found Yrjö by the unfinished rail juggling three river stones he threw badly, as if arguing with gravity, dropping one and then another, laughing without softness and starting again from the catch.
“You build like that,” she said.
Yrjö kept the stones moving. “That builds like us.”
In the air the stones were never quite owned, neither part of the hand nor yet lost nor yet caught, living in order only through timing, where too much fear dropped them and too much confidence launched them past reach, each throw correcting the last and accusing the next until Maaria saw the bridge inside the pattern: body, object, weather, mistake, return.
The pattern wore an old blunt name: juggling, the creation, maintenance, and control of an unstable state inside the body–object–environment system, where the object stays free of a permanent rigid grip and control runs on rhythm, impulse, balance, a phase of free movement, and continuous correction; locomotion steadies the body’s instability for movement’s sake, juggling steadies the object’s instability through the deliberate break in holding, and when instability is performed by a living body in real time you may call it juggling, whereas when instability is only represented by a steady machine you have media about juggling.
The speaking box could trace a juggler’s arc with tender precision, yet it could not catch the town’s stone.
At summer’s end the elders descended in formal coats, the stranger behind them with the speaking box wrapped in blue cloth, and they carried the final specification in red ink with the town’s seal pressed deep in wax, which the oldest elder offered toward Yrjö like a relic while he wiped his hands on his trousers, read, and the apprentices closed around him and the river held its old animal patience below.
The document was serious, full of true things drawn partly from the box, partly from the elders, partly from older bridges, and largely from the marks Yrjö had cut into the working drawings after the river had hurt him, a handsome corpse of many living moments.
He folded it once, laid it under a stone against the wind, and lifted the next beam.
Silence held even among the elders while the beam settled and the low note ran through wood, rope, and mud, agreement of the kind wood understands.
The first full crossing came before dawn, without ribbon or speech: Maaria crossed with a sack of flour while Yrjö watched from the bank, and halfway over she stopped when the mist opened and the orchard rose on the far side, wet and silver, close as a hand, the boards trembling under her like something alive enough to answer weight rather than like a drawing or a promise.
When she came back the town was waking with smoke, opening doors, a shout on the air, elders hurrying down too late with ceremony, the speaking box humming inside its cloth, and the river passing beneath them all unchanged in hunger except that people could now cross.
That night by the kiln Yrjö wrote one sentence on the back of the sealed specification, not for the elders, nor the box, nor the apprentices who would find it later: Reality came before the plan; planning without contact was a painted door on a wall.
He slept while the next river was already speaking in his sleep.
Riverbank notes
Fragments for later posts: ledger entries, not promises.
- 2026-05-01
- Pull request as capsule: intent, diff, checks, demo, risk note. What changed in the product, not what calmed the author.
- 2026-05-03
- Tool-calling models widen inspection; trust follows verification, not fluency. The chat surface only routes work.
- 2026-05-04
- When the patient in the room is the planner’s inner weather, the customer’s crossing waits in the mist. Name which session it is.
- 2026-05-06
- Specification after contact: compress the bruises. Specification before contact: sometimes scaffold, sometimes theater, and weight tells.