Guides
aaaa.fyi · 2026-07-22 · 8 min read
Every agent, from a weekend script to a production system, is the same four pieces:
The build-from-scratch loop is ~50 lines and worth writing once to understand the shape. For real work, start from an existing agent and extend it:
Tool design beats prompt design. Agents fail mostly by calling the wrong tool with the wrong arguments. Few, well-described, typed tools with data-shaped errors ("branch not found", not a stack trace) fix more failures than any system-prompt tweak.
Bound the loop. Max iterations, budget caps, and a definition of "done" — an unbounded agent loop is an unbounded bill.
Checkpoint the risky steps. Generate → verify → apply, with a stricter model or a human between steps for anything irreversible.
Study what's working: our agents directory ranks every open-source agent and framework by real GitHub activity — the fastest way to see which architectures are winning is to read the code of the ones people actually use.