Law 20 · Scope & Design
The Cheapest Fix First
Reach for the prompt before the platform.
The principle
When something misbehaves, the cheapest fix that addresses the root cause usually wins, and that's usually clearer instructions, a better tool description, or a concrete example, not a new classifier, preprocessing layer, or pipeline. Infrastructure feels like progress, but it often just wraps an unsolved prompt in more surface area.
Why it happens
Many agent bugs are not platform bugs. They are vague instructions, weak tool descriptions, missing examples, or unclear scope. Adding a classifier, router, or preprocessing service can feel like progress, but it also adds latency, failure modes, and maintenance around the same unresolved ambiguity. Start with the cheapest root-cause fix: sharper words, better examples, clearer tool contracts. Build machinery only after the simple version has failed in a way you can name. Complexity should answer evidence, not anxiety.
Watch for
- A new service or pipeline is being specced before anyone rewrote the failing instruction or tool description.
- Infrastructure was added but the original misbehavior persists.
- The actual defect is a vague description the model cannot act on, masked by surrounding machinery.
In practice
The agent keeps picking the wrong tool, so you spec out an intent-classifier service and a preprocessing layer, and three days of infrastructure later it still misfires, because the real problem was a tool described as 'searches the database' that the model could not tell apart from another. Infrastructure feels like progress while it just wraps an unsolved prompt in more surface area. Exhaust the cheap fixes first: rewrite the tool description, add two concrete examples, tighten the scope. Build the system only after you have proven words genuinely cannot close the gap.
Apply it
- Diagnose the root cause and try clearer instructions, sharper tool descriptions, and concrete examples first.
- Start with the simplest prompt that could work and add complexity only when a real failure forces it.
- Build new infrastructure only after proving that prompt-level fixes genuinely cannot close the gap.
The takeaway
Exhaust the prompt-level fixes before you build systems. Add infrastructure only once you've proven that words, examples, and scoping genuinely can't close the gap.