OpenCode Village: A Multi-Role Collaborative Agent Workflow Framework

OpenCode Village is an innovative plugin for the OpenCode platform. By simulating human division of labor and collaboration models, it introduces five roles—Mayor, Worker, Inspector, Guard, and Messenger—to build a multi-agent collaborative workflow. This enables automated processing of complex tasks and quality assurance, improving efficiency while ensuring output reliability.

OpenCode Village was created to address the efficiency and quality issues in complex task processing. Drawing on the division of labor and collaboration models in human society, it breaks down tasks into responsibilities for different roles. Through checks and balances and collaboration between roles, it not only improves processing efficiency but also ensures the reliability of output quality.

• Mayor: The task scheduling and decision-making hub, responsible for receiving requests, analyzing tasks, allocating resources, and monitoring progress;
• Worker: The main executor, responsible for operational tasks such as code writing and document generation, supporting parallel execution of multiple instances;
• Inspector: Quality control, responsible for code review, logic verification, etc., of the Worker's output, and feeding back issues for correction;
• Guard: Safety and compliance guardian, responsible for checking security vulnerabilities, sensitive information leaks, and compliance issues;
• Messenger: External interaction, responsible for calling third-party APIs, querying data, and providing data support for other roles.

1. Task Decomposition and Allocation: The Mayor analyzes user requests, decomposes them into subtasks, and assigns them to corresponding roles (e.g., Web application development is split into database design, backend API, etc.);
2. Iterative Quality Improvement: After the Worker completes a task, the Inspector reviews it. Issues are returned for correction, and this cycle continues until the task meets the standards;
3. Flexible Orchestration: Independent subtasks are executed in parallel, while dependent tasks are executed serially, balancing efficiency and correctness.

• Role State Management: Each role has a complete lifecycle state machine (Standby → In Execution → Under Review → Completed), and event-driven design ensures determinism;
• Message Passing Protocol: Standardized message types (task allocation, progress reporting, etc.) support independent evolution of roles;
• Extensible Role Definition: Allows developers to add new roles (e.g., Architect, Tester) to adapt to different scenarios.

• Complex Software Development: Simulates the complete workflow of a development team, enabling end-to-end automation;
• Content Production and Review: Division of labor for generation, verification, and compliance checks ensures content quality and safety;
• Data Analysis and Reporting: The Messenger collects data, the Worker handles visualization, the Inspector verifies conclusions, and the Mayor integrates the report.

OpenCode Village provides a new organizational paradigm for agent systems through its multi-role collaborative workflow design. It draws on human division of labor models to improve efficiency and incorporates multiple check mechanisms to ensure reliability and security. For developer teams building complex automated workflows, it is a framework worth exploring in depth.