Stop prompting by hand. The shift from "Prompter" to "Loop Designer" is real.
[WP] Hey everyone,
I’ve been diving deep into recent long-forms on agent orchestration (specifically parsing through the technical frameworks outlined in Loop Engineering.pdf, Anthropic engineering docs, and Addy Osmani's research) and wanted to share a pragmatic breakdown of how to build a recurring weekly agentic loop without blowing up your token budget.
Most of us are stuck in the synchronous prompt loop: write prompt → wait → read diff → repeat.
If you want to transition to automated asynchronous loops that handle routine tasks (dependency bumps, CI triage, lint passes), here is the bare-minimum architecture you need to set up in your repo:
1. The Pre-Flight Check
Before coding a loop, ask yourself: Is the task weekly? Is verification fully programmatic (linter, test suite, type-checker)? Does the agent have a local execution/reproduction env? If any answer is no, a single manual prompt is still cheaper and faster.
2. The 4 Essential Repo Blocks
- The Automation Heartbeat: Using primitives like Claude Code's /loop paired with an objective /goal condition (e.g., /goal "All tests pass").
- The Isolation Layer: Always spin up a background git worktree. If you run parallel agents on your main tree, files will collide instantly.
- The Spine (STATE.md): Agents have short memory. Write an ongoing state file to the root. The agent forgets each run; the file ensures tomorrow's run resumes instead of restarting.
- The Maker-Checker Split: Never let the model that wrote the code run the evaluation gate. Define a separate verifier sub-agent (via TOML in .claude/agents/ or .codex/agents/) to strictly run the tests and grade the output.
The Real Cost: Comprehension Debt
The trap isn't just the API bill; it's comprehension debt. The faster your loop ships code, the wider the gap becomes between what the repo contains and what you actually understand. Keep loops locked down to small, machine-checkable changes—never architecture or payments.
Curious to hear from others building autonomous workflows: What does your orchestration stack look like right now? Are you running cron loops locally or pushing them entirely to cloud routines?