ExampleForGorCodeMutiAgent

This example project demonstrates GorCode's multi-agent support and how to structure agent delegation, nested sub-agents, and MCP startup.

Layout

• MCP_PIC/: A standalone MCP image server used by the visual_designer agent.
• workspace/.gorcode/config.json: Project-level GorCode configuration (models, default agent, MCP servers).
• workspace/.gorcode/agents/*.md: Agent definitions with YAML front matter.
• workspace/app_describe/: Sample input assets for the demo.

Configure Sub-Agents Each agent is a Markdown file in workspace/.gorcode/agents/ with YAML front matter. Key fields:

• name: Agent identifier used in delegation.
• mode: primary for the main agent, subagent for others.
• tools: Allowed tools for that agent.
• allowsubagents: Which agents it can delegate to.

Example (primary agent):

---
name: architect
description: Primary architect agent coordinating app planning and delegation.
mode: primary
default: true
tools: acceptall
allowsubagents: ["visual_designer", "frontend_architect", "backend_architect", "explore"]
---

Configure Nested Sub-Agents To allow a sub-agent to delegate further, list its children in allowsubagents and make sure those agent files exist.

Example (sub-agent that can delegate to other sub-agents):

---
name: backend_architect
mode: subagent
allowsubagents: ["coder", "tester", "explore"]
---

Example (second-level sub-agent):

---
name: coder
mode: subagent
allowsubagents: ["explore"]
---

MCP Startup This project uses MCP in stdio mode. GorCode reads MCP settings from workspace/.gorcode/config.json:

{
  "mcpServers": {
    "mcp_pic": {
      "command": "python",
      "args": ["../MCP_PIC/mcp_pic_server.py"]
    }
  }
}

You can also run the MCP server manually from ExampleForGorCodeMutiAgent:

python MCP_PIC/mcp_pic_server.py

Or use TCP mode:

python MCP_PIC/mcp_pic_server.py --tcp --host 127.0.0.1 --port 20050