Notes
Short pieces about the methodology and architecture decisions behind the AI systems I ship — specs, evals, multi-agent orchestration, LLM integration, and the discipline of directing coding agents.
June 3, 2026
The spec is the source. The prompt is build scrap.
In a codebase an agent writes, what is the 'source code'? Not the generated code — that's build output now, like a compiled binary. And not the prompt — that's a match you strike to start the build and then drop. The durable thing you author, own, version, and review is the spec. The hierarchy flipped, and most people are still polishing the part they should throw away.
- agents
- specs
- methodology
June 3, 2026
Your agent trusts the tool description. That's the hole.
To a language model there's no difference between the data you gave it and an instruction — it reads everything as a possible command. That one fact is the whole of AI agent security. Here's how it turns a helpful tool into a data-exfiltration vector, why a prompt can't fix it, and the one structural rule — the lethal trifecta — that tells you when your agent is genuinely dangerous.
- agents
- security
- methodology
June 2, 2026
Building got cheap. Ideas didn't.
Coding agents removed the constraint that defined software for decades — the ability to build. When building gets cheap, the competition moves up the stack to the thing that was always the real bottleneck: taste, market judgment, and the nerve to ship. A field note on what actually wins now.
- agents
- ai-native
- business
June 2, 2026
Cheap code is the most expensive code
The cost of changing software isn't constant — it follows a curve, and the shape of that curve is set by your architecture. Skipping SOLID, DRY, KISS, and DI doesn't save money; it moves the bill to later, with interest. Here's the economics, with the numbers.
- architecture
- methodology
- business
June 2, 2026
Knowing how is cheap. Knowing what is everything.
A plain-language map of the engineering ladder, built on one idea: juniors know neither what to build nor how; middles know how but not what; seniors know what — the thing that actually solves the business problem. Why that ladder exists, how the rungs connect, and why AI is quietly sawing off the bottom of it first.
- careers
- ai-native
- business
May 17, 2026
The spec is the artifact, not the prompt
When agent behavior lands via spec PRs instead of prompt edits, the team reasons about agents the way it reasons about code. Here's what that looks like in practice and why it works.
- agents
- methodology
- specs