Writing

Writing on AI systems that create real leverage.

Agents, automation, and decision systems — for builders who want depth and operators who want results.

A mental model for Claude Code (and every other modern agent)

A mental model for how modern AI agents actually work — small enough to hold in your head. Plus the npm packages I built to make it concrete.

AI AgentsOpen SourceTypeScript

MARCO: the loop inside a harness, in code

Companion code to my article on AI agent architecture. A small TypeScript harness that makes the loop-inside-a-harness split literal — readable in an afternoon.

AI AgentsArchitectureTypeScriptOpen Source

How AI agents work: a control flow breakdown

Most agent explainers name the parts. This one shows the control flow: loop inside a harness, step by step with diagrams.

AI agentsArchitectureSystemsAutomation