# The Shape of It

> A series on directing agents well. Each piece teaches you a fundamental about how software actually works, in plain terms, and hands you a tool to put it to use. The hard part was never building. It is knowing what to ask for.

Source: https://iambenschmidt.com/shape/



The bottleneck was never the machine. It is knowing what to ask it for. This is a series on closing that gap: enough of how software actually works to direct an agent well, whether or not you write code, with something applied at the end of each piece so you can put it to work the same day.


Most advice about working with AI teaches you prompts. Prompts are the easy part. What actually separates a good result from a mess is knowing the shape of the problem underneath: how data survives across machines, what a branch is really protecting you from, why two reasonable-sounding requirements sometimes cannot both be true at once. You do not need to become an engineer. You need enough of the vocabulary to have the conversation.

Each kit does two things. It teaches one fundamental in plain language, with the kind of worked example that makes it stick. Then it hands you something applied, a checklist, a prompt, a small tool, so the fluency turns into a result instead of a nice idea you forget by Friday.

They are few and deep on purpose. A new one lands when it is genuinely worth your time, not on a schedule.

## Start here

**Kit 01: How to read an AI grader's accuracy number.** A vendor says their AI grades short answers with 0.9 correlation to humans. Is that good? By itself the number tells you almost nothing. Two checks tell you whether the grader is any good, in plain terms, with a worked example. [Read it](/guides/how-to-read-an-ai-grader-accuracy-number).

## Where these come from

A kit is different from an essay. The [Writing](/essays) is where I think out loud: essays and field notes from building in the open, things to read. A kit is the opposite of that. It is the few ideas that hardened into a teachable skill with a tool you can actually use, built to be put to work, not just read. When a note earns that, it graduates into a kit here.


---
This is the plain-markdown twin of https://iambenschmidt.com/shape/. The whole site offers one: append index.md to any page URL. Index for agents: https://iambenschmidt.com/llms.txt