> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Job roles

> List the job roles positions are attached to, create one by hand or with the Role Architect, and edit its job description, responsibilities, system prompt, scope and skill and tool grants.

**Workforce → Organization → Job roles** (`/workforce/roles`) is the catalog of jobs your workers fill: each job role holds the description, responsibilities and system prompt a position shares, and the skills and tools workers in that role are granted or denied. A job role is not a Trust Fabric access role; it grants no platform permission to a person. Creating, editing and deleting job roles, and saving their grants, needs `roles:manage`; starting a Role Architect session also needs `org:manage`.

![Job roles (light)](https://mintcdn.com/gloo-b243725a/ahnDPYAsbo1iROpN/forge/images/console/workforce/roles-light.png?fit=max\&auto=format\&n=ahnDPYAsbo1iROpN\&q=85\&s=1caf3d6c1eed66453d08e32ffc8a947f)

Job roles — Forge Console at `/workforce/roles`

## What you can do

* Read every job role with its **Name** and id, **Description**, and whether its job description (**JD**) and **Prompt** are set.
* Create a job role with **Create job role**, or start an assisted session with **With Role Architect**.
* Open a job role to edit its fields, its grants, or delete it.

## The catalog

Each row shows the job role's name and its id, its description, and two badges: **JD** and **Prompt**, each **Set** or **None**. Select a row to open the job role. With no job roles, the page shows **No job roles yet**.

## Creating a job role

* **Create job role** opens a drawer that asks for a name (for example Research Analyst), an id (for example `research-analyst`), a description, and whether to **Mark as template**.
* **With Role Architect** starts a **Role Architect** session in a drawer. Describe the job; the Architect drafts the role and shows a preview card with its data access, write access, environments, maximum spend and maximum duration. Creating it shows **Job role created ✓**.

## Editing a job role

The job role drawer has five tabs:

| Tab | What it holds |
| - | - |
| **Overview** | The role's scope: **Data Access**, **Write Access**, **Environments**, a **Tool Allow List** and **Tool Deny List** when set, and the limits **Max Spend**, **Max Duration**, **Max Concurrent** and **Max Handoffs** |
| **Job Description** | The job description, in prose |
| **Responsibilities** | The responsibilities, in prose |
| **System Prompt** | The instructions given to workers in this role |
| **Tools** | **Capability Grants & Denies**: the skills and tools granted or denied to workers in this role |

On **Job Description** and **System Prompt**, **Generate** (or **Improve**, when the field has content) drafts the text with AI and shows it as **Proposed** beside the **Current** text; accepting it saves the field. **Responsibilities** is edited by hand. Each field saves with **Save**.

On **Tools**, change grants and denies, then **Save**, or **Cancel** to return to the saved grants. **Delete** removes the job role after a second **Confirm delete**.

## Key state to watch

* **JD** and **Prompt** showing **None** — positions attached to the role carry no shared job description or instructions.
* **Denied tools and skills** on **Tools** — a deny applies to every worker in the role.
* **A worker who still cannot act** — check [Your access](https://docs.gloo.com/forge/console/settings/your-access.md) or Trust Fabric; a job role does not grant platform permissions.

## Related surfaces

* [Positions](https://docs.gloo.com/forge/console/workforce/positions.md) — positions attach to a job role as their **Job**.
* [Agents](https://docs.gloo.com/forge/console/workforce/agents) — agents that hold positions with these roles.
* [Skills](https://docs.gloo.com/forge/console/platform/skills) and [Tools](https://docs.gloo.com/forge/console/platform/tools) — the catalogs grants are chosen from.
* [Access](https://docs.gloo.com/forge/console/trust-fabric/access) — Trust Fabric roles and permissions, which are separate from job roles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.