Docs06 · Agents

Agent Role

06-agents

A single agent's definition: when to invoke it, what it does, what it must never do.

What it is

A role definition for one agent — written for the pilot who will call it. It makes a specialist or bench agent's job, and its hard limits, explicit.

When to write it

When you add a specialist or bench agent worth defining — a QA reviewer, a release-note author, a security reviewer.

What goes in it

  • When to invoke it (the trigger)
  • What it does, and the tools it has
  • The hard limit — what it must never do
  • Its type: lead / bench / specialist

How it fits

Referenced by the Agent Team. The executable definition lives in .claude/agents/ (or your toolchain's equivalent); this is the why and the contract.

Get the templatestarter/docs/06-agents/agent-role.md