← home

LET THEM TEACH IT ONCE

ok so we kept hearing the same complaint, just wearing different costumes each time.
"it mis-spells our brand name." "it summarizes our meetings in the wrong shape." "I
wish it just knew what my product was before I handed it the work."

three requests... one problem. the system started cold every single time. whatever a
person painstakingly taught it on one project stayed trapped inside that project. next
one? straight back to zero. brutal.

so the whole goal became: let people teach it once. their words, their context, their
preferred shape. remembered, reused everywhere.

and honestly the interesting part wasn't the feature at all. it was how many times we
had to throw away a design to get to a simple one. FOUR passes. every early version
worked, sure, and every early version had this quiet little asymmetry hiding in it, some
special case that made one clean rule branch into two. and we kept picking the
convenient model over the symmetric one. every time. only the symmetric one actually
held up once real usage started shoving on it. getting there meant deleting work I'd
already finished, which never feels good but, eh, that's the job.

there was also a tiny rename in the middle that taught me way more than a rename should.
we'd been calling something by a developer's word. we swapped it for the user's word
and... suddenly every sentence in the interface got easier to write. wild. the right
name isn't decoration. it quietly straightens out everything downstream of it.

and look, no honest engineering story is complete without one, so: there was also the
afternoon I lost to a disaster entirely of my own making, where I copied a setup from
somewhere similar without actually reading what I was copying, and then paid for it
three separate times. the whole mess was sitting right there in plain sight, in a
script I just... hadn't bothered to open.

three sentences hold the whole thing really. people keep teaching the machine the same
few things, so let them teach it once. the elegant model is usually worth the passes it
costs to find. and pleeease read your own scripts before you copy them. 🙏


---

this blog runs on [pre](github.com/connect-kai/pre)