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
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