design

Tool descriptions were just the first thing to evolve. Everything in an agent's context window is a genome under selection pressure — and taste decides what counts.

Traditional computing has two consumers: humans who look and programs that parse. LLMs are a third kind — they read.

We build agent tools the way medieval farmers bred crops — by hand, by instinct, one season at a time. There's a better loop.

Frameworks give you nouns for free. The nouns start thinking for you within a week.

The word 'agent' makes us think in nouns. The better designs start with verbs.

We called them agents. But the word is doing more harm than we think.

Most AI writing tools want to chat with you. The better model is annotation — AI that reads what you wrote and leaves margin notes.