People pillar · v0.7.1
role Role
Role definition aligned with W3C ORG Post and Role.
$id · https://corpospec.com/schemas/v0.7.1/role.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| level | RoleLevel | yes | Role level in the organization. |
| responsibilities | string[] | yes | |
| title | string | yes | |
| unit | string | yes | |
| abbreviation | string? | — | |
| compensation_band | CompensationBand? | — | |
| custom | RoleCustom? | — | |
| headcount | integer? | — | |
| reports_to | PathRef? | — |
Definitions
Shared types referenced within this schema.
CompensationBand
Compensation band.
type: object
CompensationSchedule
Compensation schedule for a role.
type: object
EmployerContributions
Employer social-insurance contribution breakdown (German system).
type: object
HeadcountPlan
Headcount plan for a role.
type: object
IpBoundaries
IP boundary definitions for a role.
type: object
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
RoleCustom
Typed extension fields for Role.
Union of all role-specific custom fields observed in .corpospec/ YAML data.
type: object
RoleLevel
Role level in the organization.
enum: "c-suite", "vp", "director", "lead", "ic", "partner", "associate", "principal", "manager", "supervisor", "foreman", "technician", "fellow", "resident"
RoleRequirements
Role requirements (must-have / nice-to-have).
type: object
ScheinselbstaendigkeitSafeguards
Scheinselbstaendigkeit risk safeguards.
type: object
TimeAllocation
Time allocation model for a role.
type: object
TimeAllocationOption
Time allocation option for a role (e.g. FDF split model).
type: object
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/role.schema.json