| name | manage-roles |
| description | View and edit jobs/roles in Superposition — list open roles, check a role's status, update comp, the job description, location, or work-auth fields, set pre-interview checks, or draft a new role. Use for "what roles are we hiring for", "update the salary range on the Head of Marketing role", "update the JD to say remote-first", "what's the status of the marketing role", "always ask for a portfolio before flagging", or "open a new role for a staff backend engineer". Also use to set up or copy interview stages between jobs, duplicate a role, or edit the ideal-candidate profile ("prefer IC, no managers", "copy the other job's scheduling config", "duplicate the founding-eng job"). |
Manage roles
Reads are answerable directly from job data; edits and new roles flow through the Master Agent via
invoke_agent (which owns update_job / create_draft_job).
Steps
- For "what are we hiring for" / status:
list_jobs (active roles) and get_job for detail —
answer directly. get_job carries compensationRange, equityRange, locationType/location/
inOfficeDaysPerWeek, isVisaSponsorshipProvided/workAuthorizationRequirement, jobDescription,
and infoToFlagToCandidates.
- For an edit: read the current value with
get_job first (so you can show a diff and not clobber
other fields), then invoke_agent, threading sessionId:
"Update job <id>: set to (e.g. compensationRange to '$120–160K+'; add 'remote
first' to the JD; set infoToFlagToCandidates to ''). Leave other fields unchanged."
- For a new role: gather the essentials (title, comp, location, key requirements) — use
get_supported_roles if the user wants a template — then invoke_agent to create a draft.
- For interview-stage setup or duplication ("set up the stages like the other job", "copy the
scheduling config", "duplicate this role"): read the source job's stages with
list_interview_stages, then invoke_agent to create/copy the stages (or draft the duplicate
role). Confirm interviewers/scheduling URLs carried over.
- Show the diff of what changed and link the role:
https://app.superposition.ai/j/{jobId}.
Guardrails
- Pre-interview checks ("always ask X before flagging") are a job update (
infoToFlagToCandidates),
not an insight. But work-authorization and standard location/work-model belong in the dedicated job
fields, not as free-text checks — the agent handles that routing.
- Confirm before clearing/emptying a populated field.
- Don't invent comp, equity, or requirements; ask if unknown.
Output
Updated [Head of Marketing](https://app.superposition.ai/j/job-789): compensationRange "$110–140K" → "$120–160K+, depending on level".
