Ch 2: Tool Registry and Structured Results
Remember the genius from Chapter 1. They could think brilliantly. But they still needed you to do things in the real world.
That gets messy fast if the genius can ask for just anything.
So you prepare a labeled errand box.
Each compartment holds one approved kind of help.
One label might say check the supply closet. Another might say save a note for the volunteers. Another might say count the chairs in the hall.
Each compartment also has a short instruction card. It explains what kind of request fits that compartment and what kind of answer comes back.
Now imagine you are getting ready for tonight's school fair. The genius slides out a note: "Please check the art shelf in the supply closet."
You do not guess. You do not improvise. You look at the box.
If that compartment exists, and the request matches the card, you run the errand and slide back the result. If it does not exist, you simply say no.
That simple box is the idea behind the Tool Registry. It gives the genius more ways to help, but only inside clear boundaries.
Why Labels Matter
Without labels, every new errand turns into a pile of special rules.
That causes three problems.
-
New errands become hard to manage. Every time the genius learns a new way to help, you have to remember one more special case.
-
It is hard to trust each errand on its own. If one compartment is confusing, the whole conversation gets shaky.
-
The genius may ask for errands nobody approved. A smart helper can imagine all kinds of actions. That does not mean they should be allowed to do them.
The labeled box solves all three.
First you check the label. Is this kind of errand actually in the box?
Then you check the card. Does this request fit that compartment?
If both answers are yes, you act. If either answer is no, you stop.
Please help me get ready for tonight's school fair.
Put the errand-box steps in the correct order
Drag to reorder, or use Tab + Enter + Arrow keys.
- Look for the matching compartment
- Read the instruction card
- Run the approved errand
- Slide back what happened
Key Insight
The labeled box is not just tidy. It is a boundary.
The genius can ask for almost anything. That is why the box matters.
Without the box, you would spend all your time guessing what to block. With the box, the rule becomes simple: if it is not in the box, it does not happen.
The label is the first check. The instruction card is the second.
First, is this kind of errand allowed at all? Second, does this particular request fit the card?
Only then do you act.
That is how a smart helper becomes predictable.
What You Learned
You now understand the labeled errand box that builders call the Tool Registry.
It gives the genius more useful ways to help. But it only allows the errands you packed on purpose.
Known errands can run. Unknown errands are refused. Requests that do not fit the card are stopped before anything happens.
In Chapter 3, you will discover what happens when one errand is not enough. The genius needs to plan — breaking a big request into smaller steps that depend on each other. That is the Planner and Task Graph.