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.

Put Your AI's Reference Library in a Shared Git Repo the Whole Team Owns
Put Your AI's Reference Library in a Shared Git Repo the Whole Team Owns

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.

Give Your AI Tools, Not Just a Chat Box
Give Your AI Tools, Not Just a Chat Box

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.

One Repo, Two Machines: Running an AI Agent Across a Mac and a Windows VM
One Repo, Two Machines: Running an AI Agent Across a Mac and a Windows VM

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.

Have AI Review AI: Building a Verification Loop You Can Trust
Have AI Review AI: Building a Verification Loop You Can Trust

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.

Plan First, Code Second: Spec-Driven Work with AI
Plan First, Code Second: Spec-Driven Work with AI

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.

Structure Your Repo So AI Can Find Its Way Around
Structure Your Repo So AI Can Find Its Way Around

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.

Scope the Task to the Context Window: Decomposing Big Work for AI
Scope the Task to the Context Window: Decomposing Big Work for AI

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.

Guard Your Secrets: Security Hygiene When Working with AI
Guard Your Secrets: Security Hygiene When Working with AI

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.

Pin Your Model Versions: Reproducibility in AI Workflows
Pin Your Model Versions: Reproducibility in AI Workflows

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.

Make AI Cost Visible: Observability for Token Spend
Make AI Cost Visible: Observability for Token Spend

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.

Know What to Delegate to AI and What to Keep Human
Know What to Delegate to AI and What to Keep Human

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.

Turn Repeatable Prompts into Scheduled Agents
Turn Repeatable Prompts into Scheduled Agents

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.

Claude Computer Use in Production: What I Actually Use It For
Claude Computer Use in Production: What I Actually Use It For

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.

Building AI Data Parsing Pipelines: Structured Extraction From Messy Documents
Building AI Data Parsing Pipelines: Structured Extraction From Messy Documents

How to build a production AI data parsing pipeline that extracts structured data from unstructured documents - architecture, tradeoffs, and what actually works.

Building a Production MCP Server with Spring AI
Building a Production MCP Server with Spring AI

Architecture decisions and implementation patterns for a Spring Boot MCP server backing a fleet of autonomous Claude agents.

Running AI Agents in Production: What the Architecture Actually Looks Like
Running AI Agents in Production: What the Architecture Actually Looks Like

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.