Claude Code Loop Engineering: Four Ways to Automate Work Beyond One-Off Prompts

Never report a UI change as complete based on a successful edit alone.

1. Start the development server and open the edited page.
2. Interact with the changed control and confirm the expected state.
3. Capture before-and-after screenshots when relevant.
4. Check the browser console for new errors or warnings.
5. Run a performance trace and review Core Web Vitals.

If any check fails, fix the issue and repeat the process from step 1.

The important idea is not the exact wording. It is that the skill gives Claude access to the same evidence a human reviewer would use.

Quantitative checks work especially well:

- Zero console errors.
- All tests passing.
- A Lighthouse score above a threshold.
- No visual-diff changes outside an approved region.
- A response time below a limit.
- A specific number of acceptance criteria completed.

The more measurable the verification, the less often a human has to guide each turn.

## 2. Goal-Based Loops with `/goal`

A goal-based loop is useful when a single turn may not be enough, but the finish line can be described clearly.

Instead of relying on the working agent to decide that its own result is “good enough,” Claude Code uses a separate evaluator after each turn.

![Claude Code Loop Engineering: Four Ways to Automate Work Beyond One-Off Prompts illustration](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/image/2026/07/855833c7-934e-43db-9be6-6289a4949123-44c2e677-575e-4e41-a822-36bfb6cd749e.png)

### Trigger

The user starts a goal in the current session.

### Stop Condition

The loop ends when:

- The evaluator confirms that the condition is satisfied, or
- A configured turn limit is reached.

### Best Use Cases

Goal-based loops fit tasks with a verifiable end state, such as:

- Making every authentication test pass.
- Reaching a performance score.
- Migrating all call sites to a new API.
- Clearing a labeled issue queue.
- Reducing every file below a size budget.
- Completing all acceptance criteria in a design document.

### Basic Syntax

Anthropic’s official example is:

```Plaintext
/goal get the homepage Lighthouse score to 90 or above, stop after 5 tries.

Another practical example is:

/goal all tests in test/auth pass and the lint step is clean

According to the current Claude Code documentation, /goal requires Claude Code version 2.1.139 or later.

How the Evaluator Changes the Loop

After Claude completes a turn, a small, fast evaluator model checks the condition.

If the condition is not met, another turn starts automatically. If it is met, the active goal clears and the session returns control to the user.

This separation matters because the working model is not the only judge of its own output.

A strong completion condition should be:

• Observable.
• Specific.
• Difficult to satisfy accidentally.
• Connected to a real user or system outcome.
• Bounded by a maximum number of attempts or another hard limit.

Weak and Strong Goal Conditions

Weak:

/goal improve the homepage

The word “improve” does not define a measurable endpoint.

Stronger:

/goal raise the mobile Lighthouse performance score to at least 90,
keep accessibility at 95 or above, and stop after 5 tries

Weak:

/goal fix the tests

Stronger:

/goal all tests under test/payments pass with no skipped tests
and npm run lint exits with code 0

The model should not have to guess what success means.

/goal Does Not Change Permissions

A goal continues across turns, but it does not automatically approve every tool call.

In the default permission mode, Claude may still pause for commands that are not already allowed.

For an unattended goal, Anthropic suggests combining /goal with auto mode where that feature is available and appropriate. That should be done only after reviewing the allowed tools, repository boundaries, and possible side effects.

3. Time-Based Loops with /loop and /schedule

Some work is not triggered by the completion of the previous turn. It is triggered by time.

The task stays similar, but the input changes:

• New Slack messages arrive.
• A pull request receives review comments.
• CI moves from passing to failing.
• A dependency publishes a new version.
• An operations dashboard reports a new event.

Trigger

A configured time interval or schedule starts each run.

Stop Condition

A local loop stops when you cancel it, shut down the environment, or the monitored work is complete.

A cloud routine continues according to its configuration until it is paused or disabled.

Best Use Cases

Time-based loops work well for:

• Pull-request monitoring.
• Daily or weekly summaries.
• Periodic issue triage.
• Dependency checks.
• Recurring test runs.
• Documentation-drift checks.
• Monitoring systems that do not provide an event trigger.

Local Interval Loop

The official example uses /loop:

/loop 5m check my PR, address review comments, and fix failing CI

This prompt is rerun at the configured interval.

A local loop depends on the current machine and session. If the computer is turned off or the process stops, the loop stops.

Cloud Scheduling

For work that should continue while the laptop is closed, Claude Code can create a cloud routine with /schedule.

A proactive routine might begin with:

/schedule every hour: check #project-feedback for new bug reports

Claude Code routines run on Anthropic-managed cloud infrastructure and can be triggered by:

• Recurring schedules.
• A one-time future schedule.
• API calls.
• Supported GitHub events.

At the time of writing, routines are in research preview, so behavior, limits, and the API surface may change. Availability also depends on the relevant Claude plan, organization policy, and Claude Code on the web being enabled.

Choose the Interval Carefully

A common mistake is running the loop far more often than the external system changes.

Checking an issue queue every minute does not help if new issues appear only a few times per day. It increases token usage, tool calls, and noise without improving the result.

Match the interval to the expected change rate:

External change pattern	Reasonable starting cadence
CI status after an active push	Every 5–10 minutes
Team feedback channel	Every 30–60 minutes
Daily Slack summary	Once each morning
Dependency updates	Daily or weekly
Documentation drift	Nightly or weekly

These are starting points, not universal rules. Event triggers are often better than polling when the external system supports them.

4. Proactive Loops

A proactive loop is a composition of the earlier primitives.

It runs without a human present, reacts to scheduled or incoming work, and carries each item through a defined process.

Trigger

A schedule, API request, GitHub event, message, issue, or another external signal begins the work.

Stop Condition

Each individual task exits when its goal is met.

The surrounding routine continues to accept future work until a human disables it.

Best Use Cases

Proactive loops suit recurring streams of well-defined work:

• Bug-report triage.
• Issue classification.
• Dependency upgrades.
• Routine migrations.
• Repetitive code review.
• Alert investigation.
• Deployment verification.
• Backlog maintenance.

A Complete Proactive Pattern

Anthropic’s example combines several Claude Code features:

1. /schedule checks for new reports.
2. /goal defines what must be completed during the run.
3. Skills describe how each item should be verified.
4. Dynamic workflows coordinate multiple agents.
5. Auto mode reduces interactive permission pauses.

A combined instruction might look like this:

/schedule every hour: check #project-feedback for bug reports.

/goal: do not stop until every report found in this run
has been triaged, actioned, and answered.

When fixing a bug, use a workflow to explore three solutions
in parallel worktrees and have a separate judge review them.

This is no longer just a repeated prompt. It is a small operating system for a narrow stream of work.

Dynamic Workflows

Dynamic workflows are scripts that coordinate subagents at scale.

Claude writes a JavaScript orchestration script, and the runtime executes it in the background. Intermediate results can remain in script variables instead of filling the main conversation context.

Anthropic positions workflows for tasks such as:

• Auditing many files for the same issue.
• Migrating hundreds of files.
• Running independent research passes.
• Comparing several proposed solutions.
• Reviewing each changed file and producing one final report.

Current documentation says dynamic workflows require Claude Code version 2.1.154 or later. They can coordinate dozens or hundreds of agents, so a small pilot should be run before a large production job.

What Actually Changed: Verification and Stop Conditions

Scheduled tasks, orchestration, feedback loops, and worker queues are not new engineering concepts.

The meaningful shift is that coding agents can now participate in more of the loop:

• Reading the current state.
• Choosing tools.
• Making changes.
• Interpreting errors.
• Comparing results with a target.
• Trying another approach.
• Escalating only when the system cannot proceed safely.

The prompt has not disappeared. It has become one component inside a larger control system.

The more important design questions are now:

• What does “done” mean?
• Who decides that the condition is satisfied?
• Which checks are deterministic?
• What evidence can the agent inspect?
• What is the maximum number of attempts?
• What is the token or cost budget?
• How is lack of progress detected?
• Which actions require human approval?
• What happens after a failed run?

A well-written prompt cannot compensate for a missing stop condition.

Verification Is the Highest-Leverage Improvement

Anthropic repeatedly emphasizes verification: give Claude a way to inspect and measure its own output.

A human engineer asked to build a page without browser access would be working partially blind. The same is true for an agent.

Useful verification tools include:

• Test suites.
• Type checkers.
• Linters.
• Build commands.
• Browser automation.
• Screenshots and visual comparisons.
• Performance traces.
• Database queries.
• API response assertions.
• Security scanners.
• Static analysis.
• Reproducible acceptance scripts.

Prefer Deterministic Checks Where Possible

A script that returns exit code 0 or 1 is usually cheaper and more reliable than asking a model to reason from scratch about whether a requirement has been met.

For example:

npm test
npm run lint
npm run typecheck

A combined verification script could be:

#!/usr/bin/env bash
set -euo pipefail

npm run typecheck
npm run lint
npm test

Claude can run this script after each change. The loop does not need to reinterpret the entire acceptance process every time.

Use a Second Agent for Review

Anthropic also recommends using a reviewer with fresh context.

The implementation agent has seen its own reasoning and may repeat the same assumptions. A separate reviewer is less anchored to that path and can inspect the result from another angle.

For high-value changes, the system may use:

• One agent to implement.
• One agent to review correctness.
• One agent to review security.
• One deterministic test suite as the final gate.

More agents are not always better. Add them when the review value justifies the additional cost.

The Danger of Loops Without Gates

A loop that can continue indefinitely is powerful and risky.

There are three major failure modes.

1. Cost Runaway

Each turn may consume input tokens, output tokens, tool calls, and paid model usage.

Without a turn or budget cap, an open-ended loop can continue spending while producing little additional value.

The Claude Agent SDK supports both:

• max_turns / maxTurns
• max_budget_usd / maxBudgetUsd

The official SDK documentation states that neither limit is set by default.

For production agents, explicit limits are a sensible baseline.

2. False Progress

An agent may repeatedly edit the same files without producing a new passing test or measurable improvement.

The transcript may look active even though the system is cycling through variations of the same failed approach.

Useful no-progress signals include:

• The same tests fail for several consecutive turns.
• No new acceptance criterion becomes satisfied.
• The same files are repeatedly reverted and rewritten.
• The score remains unchanged.
• The queue size does not decrease.
• The agent returns to a previously rejected solution.

A robust loop should stop or escalate when progress stalls.

3. Growing Confidence in a Wrong Approach

Iteration can make a flawed solution more elaborate rather than more correct.

The agent may add layers around a mistaken assumption, producing code that appears increasingly complete while drifting further from the intended behavior.

Independent review, deterministic tests, and a clear rollback path help prevent this failure.

Three Gates Every Loop Should Have

A practical loop should include at least three kinds of gate.

1. Machine-Checkable Completion

The finish condition should be observable by a test, script, evaluator, or external state.

Examples:

• All tests pass.
• The queue is empty.
• The pull request is merged.
• The score is at least 90.
• Every checklist item is marked complete.
• No high-severity findings remain.

2. Hard Limits

Set at least one hard ceiling:

• Maximum turns.
• Maximum attempts.
• Maximum elapsed time.
• Maximum token usage.
• Maximum monetary cost.
• Maximum files changed.
• Maximum number of parallel agents.

A limit converts an infinite failure into a bounded failure.

3. No-Progress Detection

Stop when the system is no longer moving toward the goal.

For example:

Stop and report the blocker if three consecutive attempts
produce no new passing tests and modify the same files.

A production implementation may track this with a script or workflow state rather than depending only on an instruction.

Managing Token Usage

Loops should be designed to spend reasoning where it has the highest value.

Anthropic recommends several cost controls.

Use the Simplest Primitive

A small task does not need a multi-agent workflow.

Start with:

1. A normal turn.
2. A skill for repeatable verification.
3. /goal when more turns are needed.
4. /loop or /schedule when time should trigger work.
5. A proactive workflow only when the task stream is recurring and well-defined.

Use Smaller Models for Routine Work

Fast, lower-cost models can handle:

• File discovery.
• Simple classification.
• Repetitive edits.
• Formatting.
• Running deterministic checks.
• Summarizing structured results.

Reserve the most capable model for:

• Architecture decisions.
• Ambiguous bugs.
• Security judgment.
• Adversarial review.
• Evaluating conflicting solutions.

Pilot Before Scaling

A dynamic workflow may create many agents.

Run it against a small slice first:

• Ten files before five hundred.
• One issue category before the whole backlog.
• One repository before every repository.
• One day of messages before a month.

The pilot reveals token usage, tool bottlenecks, common failures, and missing gates.

Replace Reasoning with Scripts

When the procedure is deterministic, write code once and let Claude run it.

Examples include:

• Parsing logs.
• Checking file counts.
• Comparing output schemas.
• Filling a known form.
• Finding files matching a rule.
• Testing a URL list.
• Calculating a performance threshold.

Do Not Poll More Often Than Necessary

Time-based loops should reflect how quickly the underlying system changes.

An interval that is too short multiplies cost without creating a better outcome.

Review Usage During the Run

Anthropic documents several commands for inspecting consumption:

/usage

This breaks down recent usage by areas such as skills, subagents, and MCP integrations.

Running /goal without an argument can show the active goal’s turn and token usage, while /workflows shows workflow-agent usage and provides controls for stopping agents.

Availability may vary by Claude Code version and enabled features.

Permissions and Safety

Automation should not be confused with unrestricted access.

Claude Code supports permission modes that control which tools and commands can run.

For autonomous work on a development machine, Anthropic recommends retaining explicit allow rules or using a mode that auto-approves limited, common actions while still gating higher-risk commands.

A bypass-permissions mode should be reserved for isolated environments such as:

• Disposable containers.
• Sandboxed CI workers.
• Temporary virtual machines.
• Environments without sensitive credentials or important mounted data.

A proactive loop that can edit files, run shell commands, access external systems, and create pull requests should also have:

• Narrow repository permissions.
• Restricted network access where possible.
• Auditable tool allowlists.
• Version-control checkpoints.
• Separate credentials with limited scope.
• Human approval for production deployment or destructive actions.

The goal is not to remove every human decision. It is to reserve human attention for the decisions that actually require it.

How to Choose the Right Loop

Use the following decision process.

Choose Turn-Based When

• You are still exploring the problem.
• The next step depends on human judgment.
• The task is small and irregular.
• The finish line is subjective.
• A failed change would be easy to inspect manually.

Choose Goal-Based When

• The result has a measurable acceptance condition.
• The agent may need several attempts.
• Each attempt can be verified.
• You can define a hard turn or cost limit.
• The work belongs to one active session.

Choose Time-Based When

• The same task repeats.
• Only the input changes.
• An external system should be checked periodically.
• A schedule is simpler than an event integration.
• You can tolerate the delay introduced by polling.

Choose Proactive When

• Work arrives continuously.
• Each item follows a stable process.
• The outcome can be checked.
• The workflow can run with limited permissions.
• Failures can be escalated rather than hidden.
• The token and tool budget has been tested.

A Practical First Loop

Anthropic recommends starting with a task where you are currently the bottleneck.

Ask three questions.

1. Can I Write the Verification Check?

Examples:

• A test command.
• A browser interaction.
• A score threshold.
• A queue-size check.
• A schema comparison.
• A visual-diff rule.

2. Is the Goal Clear Enough?

A useful goal describes a state, not just an activity.

Better:

All payment tests pass and no TypeScript errors remain.

Weaker:

Keep improving the payment module.

3. Does the Work Arrive on a Predictable Rhythm?

If the task appears hourly, daily, weekly, or after a known event, it may fit a loop or routine.

If any answer is yes, you have a candidate for your first loop.

Example: From Manual Prompting to a Safe Loop

Imagine a team repeatedly fixing failing pull-request checks.

Stage 1: Turn-Based

Check the current PR, fix the failing CI tests, and explain the changes.

The developer manually reruns this each time CI changes.

Stage 2: Add Verification

Create a skill that:

1. Reads the CI result.
2. Reproduces the failure locally.
3. Runs the relevant tests.
4. Checks the complete test suite.
5. Reviews the final diff.

Stage 3: Add a Goal

/goal all required CI checks pass, stop after 4 tries

The session can continue across several repair attempts.

Stage 4: Add a Local Time Loop

/loop 10m check the PR, address new review comments,
and fix any failing required checks

The agent checks for external changes.

Stage 5: Move It to a Routine

Create a cloud routine triggered by a pull-request event or a schedule.

Restrict it to:

• The relevant repository.
• A feature branch.
• Draft pull requests.
• A defined set of commands.
• A maximum spend or run size.

The evolution is gradual. Each stage adds automation only after the earlier stage has a reliable check.

Common Mistakes

Using a Loop for an Unclear Task

“Improve the codebase” can continue indefinitely.

Break it into observable outcomes.

Letting the Working Agent Be the Only Judge

Use tests, scripts, or a separate evaluator.

Adding Multi-Agent Complexity Too Early

A single agent plus a strong verifier may outperform a large workflow with weak coordination.

Scheduling Work Too Frequently

Polling every minute is not automatically more responsive in a meaningful way.

Omitting a Cost or Turn Limit

A loop without a ceiling can fail expensively.

Treating Prompt Instructions as Hard Security Controls

Use permissions, hooks, sandboxes, and isolated environments for deterministic enforcement.

Fixing Every Failure Manually

When the same error repeats, improve the skill, rule, verifier, or workflow that produced it.

Frequently Asked Questions

What is loop engineering in Claude Code?

Loop engineering is the design of repeated agent workflows that continue until a stopping condition is reached. It focuses on triggers, verification, limits, permissions, and escalation rather than only the wording of one prompt.

What are the four Claude Code loop types?

Anthropic groups loops into turn-based, goal-based, time-based, and proactive patterns. They differ mainly in what triggers another cycle and who or what decides that the work should stop.

What does /goal do in Claude Code?

/goal sets a completion condition for the current session. After each turn, a separate evaluator checks whether the condition is satisfied and starts another turn when it is not, until the goal or the configured limit is reached.

What is the difference between /loop and /schedule?

/loop repeats a prompt at an interval on the local machine, so it stops when the machine or session stops. /schedule creates a cloud routine that can continue on Anthropic-managed infrastructure while the laptop is closed.

Do Claude Code loops run forever?

They can run longer than intended if the workflow lacks boundaries. Define a measurable completion condition, a hard turn or cost limit, and a no-progress rule before allowing unattended execution.

Do I need multiple agents to create a loop?

No. A normal Claude Code session with a reusable verification skill may be enough. Dynamic workflows and multiple agents are useful when the task requires broad parallelism or independent review.

How can I reduce the cost of agent loops?

Use the simplest loop type, choose smaller models for routine work, pilot on a small workload, replace deterministic reasoning with scripts, reduce unnecessary polling, and set explicit turn or budget limits.

Are proactive Claude Code loops safe?

They can be operated responsibly when their permissions, repositories, credentials, budgets, stop conditions, and escalation paths are tightly controlled. Do not use bypass-permission modes on a normal machine containing sensitive or valuable data.

Related Tools

• Claude Code: Anthropic’s agentic coding environment for reading repositories, editing files, running commands, and automating development work.
• Claude Agent SDK: A software development kit for embedding Claude Code’s tool-using agent loop in custom applications.
• Claude Code Skills: Reusable procedural instructions, scripts, and resources stored in SKILL.md.
• Dynamic Workflows: Script-based orchestration for coordinating many subagents on large tasks.
• Claude Code Hooks: Deterministic lifecycle automation for validating, blocking, or responding to tool actions.
• Model Context Protocol: An open standard for connecting AI agents to external tools and data sources.
• Chrome DevTools MCP: A browser-debugging MCP server useful for frontend verification loops.

Related Links

• Loop Engineering: Getting Started with Loops: Anthropic’s official definition of the four loop patterns and their recommended use cases.
• Keep Claude Working Toward a Goal: Official /goal syntax, evaluator behavior, status controls, and requirements.
• Run Prompts on a Schedule: Documentation for local recurring prompts and scheduled Claude Code tasks.
• Automate Work with Routines: Official guidance for cloud routines triggered by schedules, APIs, and GitHub events.
• How the Agent Loop Works: Technical documentation for tool calls, turns, permissions, context, and budget limits.
• Orchestrate Subagents with Dynamic Workflows: Official workflow architecture, limits, examples, and cost controls.
• Steering Claude Code: Anthropic’s guide to choosing between skills, hooks, rules, subagents, and other controls.
• Original BAAI Community Page: The Chinese-language republished article supplied as the starting reference.

Summary

Claude Code loops are not simply prompts that repeat. They are controlled systems in which triggers, tools, verification, permissions, budgets, and stopping conditions work together.

Turn-based loops keep the human in charge of each next step. Goal loops delegate the finish condition to an evaluator. Time-based loops delegate the trigger. Proactive loops combine those primitives into recurring, unattended workflows.

The most important improvement is usually not adding more agents. It is giving the existing agent a reliable way to inspect its work, defining exactly what completion means, and stopping the system when progress or budget runs out.

A useful loop is not one that can run forever—it is one that can prove when it should stop.