Bohea

Why I lead with a runnable demo

16 Jul 2026

When you're hiring someone you've never worked with, every proposal sounds confident and every one is a promise. A promise puts the risk on you: you pay, then you find out. So instead of telling you I can do the thing, I'd rather hand you a small version of it that runs — and let the running code carry the argument.

How I WorkProof before promisesMock-first

A claim is cheap; a running thing isn't

Anyone can write "expert in X." The words cost nothing, and by the time you can tell whether they were true, you've already spent your budget and your weeks. A working demo collapses that gap: you see the behaviour before you commit, and if it doesn't hold up, you've lost a click instead of a contract. That asymmetry is the whole point — it moves the risk off you and onto me, where it belongs.

Mock-first: prove the logic before spending trust

Most integrations ask you to spend something just to find out if they work — an API key, a paid credit, write access to a live system. I build the demo the other way round: on stand-in data, so the whole pipeline runs and can be watched without a single real credential. You verify the behaviour on evidence first; the real keys come after, when there's nothing left to doubt. Where a value can't be trusted, the demo flags it for review rather than guessing — because "confidently wrong" is worse than "honestly unsure."

It gives your reviewer something to read

If you have a technical person who vets the work, a demo is the most useful thing I can put in front of them: real code, in your stack, that they can read and run — not a résumé to take on faith. It answers the question a track record can't fully settle: not "has this person done something," but "do I trust how they build?"

The honest limit

A demo runs on stand-in data, not yours, so I say that plainly and never dress a sample up as a shipped result — the point it proves is the method, and the method is what ports onto your problem. That honesty is deliberate: if I'll tell you exactly what a demo does and doesn't prove before you've paid me anything, that's the same care you'll get when something is genuinely uncertain mid-project. Proof before promises isn't a slogan; it's just the cheapest way for both of us to find out early whether we should work together.

If a machine you build needs an interface, a device connection, or data that has to land somewhere else, tell me what it's costing you now. You'll get an honest read on whether it's solvable, and usually something running to look at. Start here →

← All notes