What
Claude Code's guidance for how many agents a dynamic workflow should use has changed:
- The "medium" tier now aims for fewer than 10 agents, down from fewer than 15.
- The unset default is now "medium" in general, but "small" (fewer than 5 agents) specifically on Pro plans.
- The
Workflowtool's internal prompt text and theworkflowSizeGuidelinesetting both now factor in whether the account is on the Pro tier when computing this default.
Why
This keeps workflows smaller and cheaper by default, especially for accounts on the Pro plan, where a lighter guideline is now applied automatically instead of a flat medium default for everyone.
Names in the bundleworkflowSizeGuideline
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Confirmed since
Anthropic's documentation has since written up workflowSizeGuideline, on All settings.
| [`workflowSizeGuideline`](#workflowsizeguideline) | Set the agent count Claude aims for in [dynamic workflows](/docs/en/workflows) | Hooks and automation | Any file |settings-reference see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up workflowSizeGuideline, on All settings.