Skip to content
← Back to release · 2.1.271
Improvements / v2.1.271

Smaller default workflow size on Pro

CHANGELOG · original

Changed the default dynamic workflow size to small on Pro plans and lowered the medium size guideline from 15 to 10 agents
Open official changelog ↗

Documentation

Documentation excerpt

Set a size guideline

A size guideline tells Claude how many agents to aim for when it writes a dynamic workflow. Claude Code sends the guideline to Claude as advice, not a cap, so a prompt that calls for a different scale still overrides it. Requires Claude Code v2.1.202 or later.

Each value maps to an agent count:

Value Agent count Claude aims for
unrestricted No guideline: Claude sizes the workflow to the task
small Fewer than 5 agents
medium Fewer than 10 agents
large Fewer than 50 agents

The default is medium, or small when you're signed in on a Pro plan with Claude Code v2.1.271 or later. Until you choose a value, the /config row marks the value as the default, and the workflow's Running in background line names the size in force. Requires Claude Code v2.1.219 or later; earlier versions default to unrestricted.

To change the guideline, pick a value for the Dynamic workflow size setting in /config, or run /config workflowSizeGuideline=small. On v2.1.219 and later, you can also set the workflowSizeGuideline key in any settings file; that value takes precedence over /config, and Claude Code hides the /config row while a settings file provides one.

Changes take effect on the next prompt. The runtime agent caps still apply regardless of the setting.

Documentation snapshot · 2026-09-23

Change details