Technical Writing
Writing
Practical write-ups on building production AI systems - MCP servers, running agents, data pipelines, computer use. Not tutorials; notes from real deployments.
The team-scale version of the reference library - put your coding conventions, patterns, and gotchas in a shared git repo every engineer's AI reads and everyone updates as they learn.
Moving from pasting text into a chat window to giving the model real tools it can call to read files, query a database, and take actions on your behalf.
I develop a Windows-only desktop app from my Mac by splitting the agent's world in two: a mounted share is where it edits, an SSH session into a Parallels VM is where it builds and tests.
Why the first thing a model produces is a draft, and how to build a separate adversarial review pass with a clean context that catches what the generator missed.
The highest-leverage habit in AI-assisted development is making the model write a plan first, correcting it while it is cheap, and only then letting it implement.
An AI navigates your codebase by reading it, the way a new engineer would but with a narrower view. A repo that is discoverable to a human is discoverable to a model, and the same things that confuse people send the model down wrong paths.
Models degrade when a task is too big to hold clearly at once. The fix is decomposition: break large work into scoped units that each fit in the model's working memory with room left for reasoning.
The practical security hygiene of working with AI - keeping secrets out of prompts, treating untrusted content as a prompt-injection vector, scoping tool permissions tightly, and gating consequential actions behind human review.
The model is the least stable dependency in your stack, so pin its exact version, record which model produced which output, and adopt upgrades on purpose instead of by accident.
AI cost accrues a fraction of a cent at a time across thousands of calls, so it hides easily. Instrument token spend, track cache hits, and alert on anomalies.
The skill that separates people who get leverage from AI from people who get burned is knowing which work to hand off and which to keep behind a human gate.
The graduation path from a prompt you keep re-running by hand into a standing agent that fires on a schedule, fetches its own inputs, and writes its own outputs.
A practical look at Claude computer use and browser automation in a real production workflow - what works, what doesn't, and where the real limits are.
How to build a production AI data parsing pipeline that extracts structured data from unstructured documents - architecture, tradeoffs, and what actually works.
Architecture decisions and implementation patterns for a Spring Boot MCP server backing a fleet of autonomous Claude agents.
What production AI agent infrastructure actually requires - the scheduler, the MCP server, agent definitions, observability, and what makes agents reliable vs. unpredictable.
More technical notes are cross-linked from klass.wiki, my broader reference library.