Knowledge map

Twelve clusters. One new craft:
managing an AI agent.

Not a loose list of pieces — a terrain. Every piece falls into exactly one cluster; twelve clusters stack into three tiers, from foundations to the field. Scroll to walk the whole map.

12topic clustersacross three tiers
58field piecesbilingual · VI / EN
3knowledge tiersfoundations → meta
01
Fig. 01
Cluster one

Steering the agent

4 pieces

Make it understand the right task before it acts — through command structure, forcing functions, and a clarify-first habit, not luck.

Vague vs structured commandFIG. 01
vague command3 divergent guesses
structure + forcing1 right result
02
Fig. 02
Cluster two

Context & memory

4 pieces

Memory is a finite resource: what to keep, what to drop, where to persist it — and when to let a script do the work instead of burning tokens on the AI.

Context window is a budget, not storageFIG. 02
this turnthe contractdrop / let a script do it
keep — needed nowcut — tokens cost more
03
Fig. 03
Cluster three

Orchestrating many agents

4 pieces

When one agent isn't enough: split roles, hand off work, gather results — orchestration patterns so many agents run without stepping on each other.

Split roles · hand off · gatherFIG. 03
A1A2A3gather
04
Fig. 04
Cluster four

Shipping with AI

5 pieces

Four human-control gates — plan · checkpoint · impact · verify — placed at the four moments an agent is most likely to fall on the life of one task.

Four control gates on a task lifecycleFIG. 04
1
Plan
2
Checkpoint
3
Impact
4
Verify
05
Fig. 05
06
Fig. 06
Cluster six

Economics & tradeoffs

5 pieces

The sticker speed and the take-home speed are two different numbers. This cluster measures the take-home one: when an agent actually pays off, when it loses money net, and what not to hand it.

Sticker speed vs take-home speedFIG. 06
Sticker“10×”
Take-homeafter rework
Unseen errorscostliest — hidden
07
Fig. 07
Cluster seven

How you change

4 pieces

The agent does not change. You change — through four predictable stages. This cluster maps them and lingers at stage three: where you are skilled enough to trust but not yet wise enough to know the limit of that trust.

Four stages — stage 3 trips mostFIG. 07
fumblingStage 1fluentStage 2confidentStage 3wiseStage 4⚠ trust trap
08
Fig. 08
Cluster eight

Tools & setup

4 pieces

Most people write CLAUDE.md like a README and wonder why they still have to repeat instructions every session. This cluster draws the line between describing and forcing function — and what a setup actually needs to work on its own.

CLAUDE.md: description ≠ living lawFIG. 08
Like a README
description · still forgets
✓ enforced
Like law
forcing function · enforced
09
Fig. 09
Cluster nine

Autonomy — how far to let go

4 pieces

Autonomy is not a switch. It is a dial — and the right position depends on three dimensions of the task, not on how you feel about the agent. This cluster gives you the framework to let go in the right places instead of letting go more or less.

Autonomy is a dial, not a switchFIG. 09
set by task, not by feeling
watch every steplet it run
Reversibleeasy to undo?
Stakeswhat breaks if wrong?
Trustdone well before?
10
Fig. 10
Cluster ten

Measure & improve

5 pieces

"The agent has felt solid lately" is a metric of your memory, not of reality. This cluster gives you three numbers — catch rate, rework rate, autonomy ceiling — and explains why not measuring means not improving, only getting more comfortable.

Three measurable numbers — no measure, no gainFIG. 10
Catch rate
80% ↑
Rework rate
28% ↓
Autonomy ceiling
highrising ↑
11
Fig. 11
Cluster eleven

Security & trust

4 pieces

Once an agent holds the keys to a real system — running commands, reading data, sending things — the worry is no longer correctness but what it can reach and what leaves your control. This cluster maps the five faces of risk in granting access, and the rule: narrow what it touches, record what it does.

12
Fig. 12
c
The author

Each story here wraps a lesson paid for in full.

craftagentsomeone building and learning at once

What are you building with agents? Want to trade notes, push back, or build something together — drop a line.

58pieces12clustersVI·ENbilingual

Get new pieces by email

Field notes on working with AI agents — occasional, no spam.