#45 Docs: recommend Claude as orchestrator in user guide

[Anonymous]

Originally created by: kumaakh

Problem

Gemini Flash is significantly slower than Claude for orchestration tasks. The user guide should clearly communicate this to help users make informed choices.

Requirements

• User guide should recommend Claude (Opus/Sonnet) for the PM/orchestrator role
• Explain why: Gemini lacks background agents, so every execute_prompt blocks — making it fundamentally unsuitable as an orchestrator that needs to dispatch and monitor multiple members concurrently
• Include a provider suitability matrix (orchestrator vs doer vs reviewer)
• This is a recommendation, not a restriction — if the user chooses Gemini as orchestrator, respect their choice

Context

Gemini's blocking nature means a Gemini orchestrator serializes all fleet operations, negating the core value of parallel dispatch. Claude's background agent support is a hard requirement for effective orchestration.

[Anonymous]

Originally posted by: kumaakh

Fixed: docs/user-guide.md:156 has an explicit provider recommendations matrix recommending Claude (Opus/Sonnet) as orchestrator and explaining that Gemini lacks background agents — every execute_prompt blocks, serializing all fleet operations.

[Anonymous]

Ticket changed by: kumaakh

• status: open --> closed