Team Roles and Permissions
Exclusive essesseff team roles, lifecycle combo roles, who can assign them, and how they map to GitHub teams and promotion gates.
Every team membership has exactly one essesseff role (exclusive / XOR). That role drives app permissions, lifecycle promotion gates, and GitHub team membership synchronized by the essesseff GitHub App.
Only Account Admins (owners) and DevOps Engineers can invite members or change another member’s role. Assignment uses a single dropdown on invite and on the team Members page—not multi-select checkboxes.
Exclusive elevated and read-only roles
These roles stay single exclusive options (they cannot be combined with lifecycle facets):
- Account Admin (owner) — Full account control, billing, and user/role management; includes all other role capabilities.
- DevOps Engineer — Organizations, repositories, DevOps operations, and user/role management; includes all other role capabilities except Account Admin.
- Read-Only User (member) — View-only access to account resources. Not an admin role.
Lifecycle roles
Lifecycle promotion work uses three capabilities (“facets”):
| Capability | Typical actions |
|---|---|
| Developer | Write to development repos; declare release candidates |
| QA Engineer | Accept/reject release candidates; declare stable/rejected after QA |
| Release Engineer | Deploy stable releases to staging and production |
You can assign each as a singleton role, or as a named combo that grants the union of those capabilities:
| Role (dropdown label) | Capabilities |
|---|---|
| Developer | Developer |
| QA Engineer | QA Engineer |
| Release Engineer | Release Engineer |
| Developer + QA Engineer | Developer + QA Engineer |
| Developer + Release Engineer | Developer + Release Engineer |
| QA Engineer + Release Engineer | QA Engineer + Release Engineer |
| Developer + QA Engineer + Release Engineer | Developer + QA Engineer + Release Engineer |
Combo roles appear as separate options in the same invite / members dropdown. In the members table they show as one badge per capability (same colors as the singleton roles).
Account Admin and DevOps Engineer can also perform lifecycle actions. Read-Only cannot.
GitHub team mapping
Role changes reconcile GitHub team membership (in addition to sticky Read-Only for members as applicable):
| essesseff role | GitHub team(s) |
|---|---|
| Account Admin (owner) | Admin |
| DevOps Engineer | DevOps_Engineering |
| Developer | Development |
| QA Engineer | QA_Engineering |
| Release Engineer | Release_Engineering |
| Developer + QA Engineer | Development + QA_Engineering |
| Developer + Release Engineer | Development + Release_Engineering |
| QA Engineer + Release Engineer | QA_Engineering + Release_Engineering |
| Developer + QA Engineer + Release Engineer | Development + QA_Engineering + Release_Engineering |
| Read-Only User | Read-Only only |