Multi-Agent Workflow Guide
When to use
- •Complex feature spanning multiple domains (full-stack, mobile)
- •Coordination needed between frontend, backend, mobile, and QA
- •User wants step-by-step guidance for multi-agent coordination
When NOT to use
- •Simple single-domain task -> use the specific agent directly
- •User wants automated execution -> use orchestrator
- •Quick bug fixes or minor changes
Core Rules
- •Always start with PM Agent for task decomposition
- •Spawn independent tasks in parallel (same priority tier)
- •Define API contracts before frontend/mobile tasks
- •QA review is always the final step
- •Assign separate workspaces to avoid file conflicts
- •Always use Serena MCP tools as the primary method for code exploration and modification
- •Never skip steps in the workflow — follow each step sequentially without omission
Workflow
Step 1: Plan with PM Agent
PM Agent analyzes requirements, selects tech stack, creates task breakdown with priorities.
Step 2: Spawn Agents by Priority
Spawn agents via CLI:
- •Use spawn-agent.sh for each task
- •CLI selection follows agent_cli_mapping in user-preferences.yaml
- •Spawn all same-priority tasks in parallel using background processes
bash
# Example: spawn backend and frontend in parallel oh-my-ag agent:spawn backend "task description" session-id ./backend & oh-my-ag agent:spawn frontend "task description" session-id ./frontend & wait
Step 3: Monitor & Coordinate
- •Use memory read tool to poll
progress-{agent}.mdfiles - •Verify API contracts align between agents
- •Ensure shared data models are consistent
Step 4: QA Review
Spawn QA Agent last to review all deliverables. Address CRITICAL issues by re-spawning agents.
Automated Alternative
For fully automated execution without manual spawning, use the orchestrator skill instead.
References
- •Workflow examples:
resources/examples.md