Roles
A Role file in agents/ holds one Role contract, key for key, and the Worker filling it.
A Role file in agents/ is one Role, written as its contract, and the Worker filling it. It implements Roles.
agents/customer/success-manager.mdxthe Role and its agent
Reference
MDX. Frontmatter is the Role contract, key for key, plus instructions; the body is the Worker's instructions.
| Key | Type | Holds |
|---|---|---|
worker | { agent } or { human } | Who fills the seat; unset, its role agent |
purpose | string | Why the seat exists, in one sentence |
responsibilities | list | Its standing duties, each one checkable |
results | Metric ids | The numbers that judge the seat |
standards | list | Response times and quality bars |
limits | list of { verb, | The most it does per Verb before an Approval |
mandates | list of { id, | Verbs it calls without asking each time |
autonomy | { default, | Its rung, assist, supervised or full, per decision class |
approvals | Verb ids | Verbs that wait for the founder's yes before they run |
schedule | cadence | When it works unprompted, such as daily |
channels | list | Where it answers: email, chat, sms, phone, social |
aliases | list | The founder's words for the seat, such as CFO |
handsOffTo, escalatesTo | Role paths | Where its work goes next, and where it goes past its Limits |
instructions | prompt path | A file in prompts/ used in place of the body |
A seat's Processes are not a key. Each Process file names its owner, and the Role page lists them.
Examples
Minimal
---
purpose: Every resident answers before the renewal date.
---Leaseline
---
worker: { agent: Rae }
purpose: Every resident answers before the renewal date.
responsibilities:
- Send each renewal notice at 60 days.
- Answer residents' questions about the new terms.
- List every resident who has not answered after a week.
results: [renewals-answered]
standards:
- Answers a resident's question within one business day.
limits:
- { verb: Message.create, count: 300, period: 1d }
approvals: [Lease.notify]
autonomy: { default: supervised, byClass: { high: assist } }
schedule: daily
channels: [email, sms]
escalatesTo: founding/What it builds
The StartupBuilder compiles the file and staffs the seat with Role.staff.
- a
Roleand aWorker, an Agent or a Human - a Mandate and its Limits; a call past a Limit waits as an Approval
- the agent's Tools: the Verbs the Role may call
- the Event
Role.staffed
Good to know
- Moving a seat from a person to an agent is a one-line edit to
worker. No caller sees it. - Autonomy climbs per Verb on the Role's tests.