Define agent roles

Give an agent a reusable role

A persona is a launch profile: reusable instructions that give an agent a particular job or perspective.

Before you start
A project and a clear role. Reviewer personas inspect a briefed target and return findings.

01 · Define the perspective

Write what the role should produce, what it should pay attention to and what is outside its scope.

02 · Save the persona

Project personas live in .agents/personas/. Use the supported persona format for your installed release.

03 · Brief it on the actual work

A reusable role still needs a concrete assignment: the target, expected outcome and relevant context.

04 · Inspect what it returns

A persona’s role does not make its output correct. Keep human judgment and review in the loop.

What you should have

A useful role you can brief again without rebuilding its instructions each time.

Next: Review the result →

Need more detail? Open the in-app Docs or browse source and contributor references ↗.