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