mirror of
https://github.com/jlengrand/Maestro.git
synced 2026-03-10 08:31:19 +00:00
27677f596d
- Fix logo/favicon paths (build/ → assets/) and copy icons to docs/assets/ - Add page-level metadata (description, icon) to all 19 documentation pages - Fix broken numbered list formatting in about/overview.md - Embed YouTube walkthrough videos in index.md - Standardize terminology: Agent (Maestro workspace), Provider (Claude/Codex/OpenCode), Session/Tab (conversation) - Update Key Concepts table with clear definitions - Redistribute screenshots to relevant pages (git, keyboard shortcuts, general usage) - Transform screenshots.md into Themes Gallery page - Add git diff/logs screenshots to git-worktrees.md - Add command palette screenshot to keyboard-shortcuts.md - Add session management screenshot to general-usage.md Claude ID: ad65a8b7-fc6f-4ebc-86be-ec86f66a0120 Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2.8 KiB
2.8 KiB
title, description, icon
| title | description | icon |
|---|---|---|
| Group Chat | Coordinate multiple AI agents in a single conversation with a moderator AI. | messages-square |
Group Chat lets you coordinate multiple AI agents in a single conversation. A moderator AI orchestrates the discussion, routing questions to the right agents and synthesizing their responses.
When to Use Group Chat
- Cross-project questions: "How does the frontend authentication relate to the backend API?"
- Architecture discussions: Get perspectives from agents with different codebase contexts
- Comparative analysis: "Compare the testing approach in these three repositories"
- Knowledge synthesis: Combine expertise from specialized agents
How It Works
- Create a Group Chat from the sidebar menu
- Add participants by @mentioning agent names (e.g.,
@Frontend,@Backend) - Send your question - the moderator receives it first
- Moderator coordinates - routes to relevant agents via @mentions
- Agents respond - each agent works in their own project context
- Moderator synthesizes - combines responses into a coherent answer
The Moderator's Role
The moderator is an AI that controls the conversation flow:
- Direct answers: For simple questions, the moderator responds directly
- Delegation: For complex questions, @mentions the appropriate agents
- Follow-up: If agent responses are incomplete, keeps asking until satisfied
- Synthesis: Combines multiple agent perspectives into a final answer
The moderator won't return to you until your question is properly answered — it will keep going back to agents as many times as needed.
Example Conversation
You: "How does @Maestro relate to @RunMaestro.ai?"
Moderator: "Let me gather information from both projects.
@Maestro @RunMaestro.ai - please explain your role in the ecosystem."
[Agents work in parallel...]
Maestro: "I'm the core Electron desktop app for AI orchestration..."
RunMaestro.ai: "I'm the marketing website and leaderboard..."
Moderator: "Here's how they relate:
- Maestro is the desktop app (the product)
- RunMaestro.ai is the website (discovery and community)
- They share theme definitions for visual consistency
Next steps: Would you like details on any specific integration?"
Tips for Effective Group Chats
- Name agents descriptively - Agent names appear in the chat, so "Frontend-React" is clearer than "Agent1"
- Be specific in questions - The more context you provide, the better the moderator can route
- @mention explicitly - You can direct questions to specific agents: "What does @Backend think?"
- Let the moderator work - It may take multiple rounds for complex questions