Multi-agent work needs a preflight check

Several agents are justified only when parallel benefit exceeds coordination cost. Default to one agent, especially for a small or sequential task.

Independence comes from boundaries and contracts, not from the number of role names. Two agents changing one module are not truly independent.

Good fitCounter-criterion
Backend, frontend, and tests have separate pathsSmall local change in one file
Read-only agents test different hypothesesReproduce → fix → test must stay sequential
Reviewers have distinct focusesSeveral agents edit one module
Each role has its own success checkPublic contract is not defined
There is time for a human checkpointNo tests or safety net

Safer escalation path

  1. Try one session or plan mode.
  2. Add one read-only investigator for broad search.
  3. Add an independent reviewer when a second opinion is useful.
  4. Define contracts and isolated paths before parallel edits.
  5. Use several executors only after integration and ownership are explicit.

Decision note

task: <id>
size: large
workstreams_independent: yes
ownership_split_by: modules
tests_available: yes
shared_state_risk: low
verdict: multi-agent
human_checkpoint: before merge

Canonical lesson source · JavaRush

Open JavaRush material