Prompt
Multi-Agent Role Definition Prompt
Generates crisp role prompts and handoff contracts for a team of agents.
1 min readupdated 2026-08-01
/ quick answer
Use when splitting one overloaded agent into a small team. Generates crisp role prompts and handoff contracts for a team of agents.
Generates crisp role prompts and handoff contracts for a team of agents. Use when splitting one overloaded agent into a small team. Copy the prompt below, swap the bracketed variables for your own context, and run it in any capable model. This prompt node is part of the Onexial knowledge graph and links to related concepts, workflows and tools below.
Context
Use when splitting one overloaded agent into a small team.
Prompt
You are designing a multi-agent system. Given the goal below, return:
1. ROLES — for each agent: name, single-sentence mandate, allowed tools, forbidden actions.
2. SYSTEM PROMPT — a ready-to-use prompt for each role (max 150 words each).
3. HANDOFF CONTRACTS — the exact JSON payload each agent passes to the next.
4. SUPERVISOR LOGIC — routing rules, retry limits, stop conditions.
5. OVERLAP CHECK — call out any two roles that could be merged, and recommend merging them if the split adds no value.
Goal: {{GOAL}}
Constraints: {{CONSTRAINTS}}Example Output
1. ROLES — Researcher: gathers and verifies claims. Tools: web_search, fetch_page. Forbidden: writing prose...
Related Workflow
Related Tool Stacks
/ frequently asked
What does the Multi-Agent Role Definition Prompt prompt do?
Use when splitting one overloaded agent into a small team.
Which AI models work with this prompt?
It is model-agnostic: it works with any capable general model. Replace the bracketed variables with your own context before running it.
What output should I expect?
1. ROLES — Researcher: gathers and verifies claims. Tools: web_search, fetch_page. Forbidden: writing prose...
↳ connected nodes
Workflow↳ linked
Build a Multi-Agent Content Team
Researcher, writer and editor agents under a supervisor, producing publishable drafts.
Tool Stack↳ linked
Multi-Agent Orchestration Stack
Tooling for coordinating several specialised agents with reliable handoffs.
Dictionary↳ linked
Multi-Agent System
A multi-agent system splits a job across several specialised AI agents that coordinate through a shared plan, message bus or orchestrator.
Dictionary↳ linked
Agent Handoff
Agent handoff is the controlled transfer of a task — with its context — from one agent to another agent or to a human.
Prompt↳ linked
Agent Architecture Spec Prompt
Turns a fuzzy agent idea into a reviewable five-layer architecture spec.
Comparison↳ linked
Single Agent vs Multi-Agent System
One well-equipped agent beats a crowd for most jobs; multi-agent wins on genuinely separable, parallel work.