{"source":{"url":"https://ontology.live/o/job-description-ontology-74f54f","author":"@ssergienko","license":"CC BY 4.0","licenseUrl":"https://creativecommons.org/licenses/by/4.0/","publishedAt":"2026-10-21T19:39:37.387Z"},"ontology":{"name":"Job Description Ontology","description":"Models public-facing job descriptions/postings across industries, capturing the sections, attributes and axes of variation needed to generate a new realistic job posting from a short prompt.","domain":"hiring"},"graph":{"nodes":[{"id":"job_posting","type":"class","label":"Job Posting","description":"The complete document advertising an open position to candidates.","semantics":"Root entity; composed of header metadata and ordered sections whose length and style vary by industry and seniority.","examples":["Senior Data Engineer posting","Store Manager posting"]},{"id":"employer","type":"class","label":"Employer","description":"The organisation hiring, described briefly.","semantics":"Industry, size and stage drive tone and benefits.","examples":["Alderfield Insights, a 200-person Series C startup","Cedar Lane Grocers, a regional grocery chain"]},{"id":"role","type":"class","label":"Role","description":"The position being filled, including title, level, team and reporting line.","semantics":"Determines responsibilities, qualifications and compensation.","examples":["Staff Backend Engineer","Pharmacy Shift Supervisor"]},{"id":"header_block","type":"class","label":"Header Block","description":"Top-of-document summary line(s) with title, company, location, work mode, employment type and pay.","semantics":"Format varies: dot-separated line or labelled fields.","examples":["Title · Remote (EU) · Full-time · €60k–€75k","Company: X — Location: Y — Reports to: Z"]},{"id":"job_title","type":"property","label":"Job Title","description":"Name of the position, often with seniority prefix.","semantics":"Anchors the whole document.","examples":["Senior Data Engineer","Store Manager"]},{"id":"location_mode","type":"property","label":"Location & Work Mode","description":"Where the work is done: remote, hybrid or on-site, with city or time-zone constraints.","semantics":"Remote roles specify time zones; on-site roles specify city.","examples":["Remote (EU time zones)","Denver, CO, on-site"]},{"id":"employment_type","type":"property","label":"Employment Type","description":"Contract basis and hours/status.","semantics":"Appears in header or footer.","examples":["Full-time","Part-time","Full-time, exempt","Contract"]},{"id":"compensation","type":"property","label":"Compensation","description":"Salary range, currency and variable pay or equity.","semantics":"Currency and format follow region; bonus or equity depends on role type.","examples":["€70,000–€85,000 + equity","$55,000–$65,000 + quarterly bonus up to 8%"]},{"id":"reporting_line","type":"property","label":"Reports To","description":"Manager or function the role reports to.","semantics":"Optional; more common in operational roles.","examples":["District Manager","Head of Engineering"]},{"id":"company_intro","type":"class","label":"About Us Section","description":"Short employer pitch with product, scale, size and funding.","semantics":"Often 1–3 sentences; may be omitted or merged into summary.","examples":["We build logistics software used by 800 warehouses."]},{"id":"role_summary","type":"class","label":"Role Summary Section","description":"Brief paragraph of what the hire will do and own, including team size.","semantics":"Sets scope and context.","examples":["You will join a 6-person platform team and own CI tooling."]},{"id":"responsibilities","type":"class","label":"Responsibilities Section","description":"Bulleted list of 4–6 duties starting with action verbs.","semantics":"Content reflects domain: technical stacks vs. operational targets.","examples":["Design and maintain data pipelines","Hire, train and schedule associates"]},{"id":"qualifications","type":"class","label":"Qualifications Section","description":"Requirements the candidate should meet, optionally split into must-have and nice-to-have.","semantics":"Mix of experience years, skills, education, certifications and physical requirements.","examples":["4+ years in QA automation","Forklift certification within 30 days"]},{"id":"must_have","type":"property","label":"Must-Have Requirements","description":"Mandatory qualifications.","semantics":"Typically 3–5 bullets.","examples":["Strong SQL and Python","High school diploma required"]},{"id":"nice_to_have","type":"property","label":"Nice-to-Have Requirements","description":"Optional preferred qualifications.","semantics":"Often tech/startup postings; may appear as 'a plus'.","examples":["Terraform","Bachelor's degree a plus"]},{"id":"experience_years","type":"property","label":"Years of Experience","description":"Minimum experience threshold.","semantics":"Scales with seniority.","examples":["3+ years","5+ years"]},{"id":"skills_stack","type":"property","label":"Skills / Tools","description":"Named technologies, tools or competencies.","semantics":"Technical for knowledge roles; domain competencies for operational roles.","examples":["Airflow, dbt, Kafka","POS systems, inventory software"]},{"id":"physical_legal_reqs","type":"property","label":"Physical & Legal Requirements","description":"Lifting, schedule availability, certifications, background checks.","semantics":"Mainly in on-site hourly or managerial roles.","examples":["Able to lift 40 lbs","Background check required"]},{"id":"schedule","type":"property","label":"Schedule","description":"Hours per week and shift pattern.","semantics":"Explicit for shift-based roles, implicit for office roles.","examples":["45 hours/week, rotating shifts"]},{"id":"benefits","type":"class","label":"Benefits Section","description":"Perks and non-salary benefits, as list or inline.","semantics":"Region-dependent: health insurance and 401(k) in US; holiday days and learning budgets in EU.","examples":["30 days paid holiday","401(k) with 4% match","€1,000 learning budget"]},{"id":"hiring_process","type":"class","label":"Hiring Process","description":"Sequence of interview stages and response time.","semantics":"Detailed in tech/startup postings, usually absent in retail.","examples":["Intro call → take-home → panel interview","We reply within 5 working days"]},{"id":"eeo_statement","type":"constraint","label":"Equal Opportunity Statement","description":"Closing statement of non-discrimination.","semantics":"Nearly always present near the end.","examples":["X is an equal opportunity employer."]},{"id":"application_info","type":"property","label":"Application Deadline / Call to Action","description":"How and by when to apply.","semantics":"Optional.","examples":["Apply by 30 November"]},{"id":"dim_industry","type":"dimension","label":"Industry / Domain","description":"Sector of the employer and role.","semantics":"Drives vocabulary, benefits and requirements.","examples":["healthtech","grocery retail","logistics","finance"]},{"id":"dim_seniority","type":"dimension","label":"Seniority Level","description":"Career level of the role.","semantics":"Modulates experience years, mentoring/leadership duties and pay.","examples":["junior","mid","senior","manager"]},{"id":"dim_work_model","type":"dimension","label":"Work Model","description":"Remote, hybrid or on-site.","semantics":"Changes location format, schedule and physical requirements.","examples":["remote","on-site","hybrid"]},{"id":"dim_region","type":"dimension","label":"Region / Locale","description":"Geography determining currency, legal norms and benefit conventions.","semantics":"EU vs US shifts pay format, holiday terms, and legal wording.","examples":["EU","US-Texas","UK"]},{"id":"dim_collar","type":"dimension","label":"Role Type (knowledge vs operational)","description":"Whether the role is knowledge-work or operational/frontline.","semantics":"Determines formality, process detail and requirement types.","examples":["engineering","store operations"]},{"id":"dim_company_stage","type":"dimension","label":"Company Size & Stage","description":"Headcount and funding stage.","semantics":"Startups mention funding and equity; large chains mention P&L and discounts.","examples":["Series B, 140 people","regional chain, 40 stores"]},{"id":"val_work_modes","type":"value","label":"Work Mode Values","description":"Enumerated work modes.","semantics":"Select one per posting.","examples":["Remote","Hybrid","On-site"]},{"id":"val_emp_types","type":"value","label":"Employment Type Values","description":"Enumerated contract types.","semantics":"One per posting.","examples":["Full-time","Part-time","Contract","Exempt","Non-exempt"]},{"id":"con_structure","type":"constraint","label":"Structural Convention","description":"Postings are concise, scannable and bulleted, with section headings in a consistent order: header, intro/summary, responsibilities, qualifications, benefits, process/legal.","semantics":"Length ~150–300 words.","examples":["Heading + 3–6 bullets per section"]},{"id":"con_consistency","type":"constraint","label":"Internal Consistency","description":"Pay, seniority, experience years and responsibilities must be coherent with each other and the region.","semantics":"Senior roles need more years and higher pay; US pay in USD, EU in EUR.","examples":["Senior role with 5+ years and mentoring duty"]},{"id":"rel_team_scope","type":"relation","label":"Team & Scope Metrics","description":"Quantified scope tying role to the organisation, such as team size, budget or headcount managed.","semantics":"Adds realism.","examples":["Lead 25–35 associates","manage a $4M P&L","5-person team"]}],"edges":[{"source":"job_posting","target":"employer","label":"advertised by","type":"relates_to"},{"source":"job_posting","target":"role","label":"advertises","type":"relates_to"},{"source":"job_posting","target":"header_block","label":"begins with","type":"part_of"},{"source":"company_intro","target":"job_posting","label":"section of","type":"part_of"},{"source":"role_summary","target":"job_posting","label":"section of","type":"part_of"},{"source":"responsibilities","target":"job_posting","label":"section of","type":"part_of"},{"source":"qualifications","target":"job_posting","label":"section of","type":"part_of"},{"source":"benefits","target":"job_posting","label":"section of","type":"part_of"},{"source":"hiring_process","target":"job_posting","label":"optional section of","type":"part_of"},{"source":"eeo_statement","target":"job_posting","label":"closes","type":"constrains"},{"source":"header_block","target":"job_title","label":"contains","type":"has_property"},{"source":"header_block","target":"location_mode","label":"contains","type":"has_property"},{"source":"header_block","target":"employment_type","label":"contains","type":"has_property"},{"source":"header_block","target":"compensation","label":"contains","type":"has_property"},{"source":"header_block","target":"reporting_line","label":"may contain","type":"has_property"},{"source":"role","target":"job_title","label":"named by","type":"has_property"},{"source":"role","target":"reporting_line","label":"reports to","type":"has_property"},{"source":"qualifications","target":"must_have","label":"includes","type":"has_property"},{"source":"qualifications","target":"nice_to_have","label":"may include","type":"has_property"},{"source":"must_have","target":"experience_years","label":"states","type":"has_property"},{"source":"must_have","target":"skills_stack","label":"lists","type":"has_property"},{"source":"qualifications","target":"physical_legal_reqs","label":"may include","type":"has_property"},{"source":"role","target":"schedule","label":"has","type":"has_property"},{"source":"employer","target":"company_intro","label":"described in","type":"relates_to"},{"source":"dim_industry","target":"skills_stack","label":"drives","type":"constrains"},{"source":"dim_industry","target":"responsibilities","label":"shapes","type":"constrains"},{"source":"dim_seniority","target":"experience_years","label":"scales","type":"constrains"},{"source":"dim_seniority","target":"compensation","label":"scales","type":"constrains"},{"source":"dim_work_model","target":"location_mode","label":"determines","type":"constrains"},{"source":"dim_work_model","target":"physical_legal_reqs","label":"influences","type":"constrains"},{"source":"dim_region","target":"compensation","label":"sets currency","type":"constrains"},{"source":"dim_region","target":"benefits","label":"sets conventions","type":"constrains"},{"source":"dim_region","target":"eeo_statement","label":"shapes wording","type":"constrains"},{"source":"dim_collar","target":"hiring_process","label":"determines detail","type":"constrains"},{"source":"dim_company_stage","target":"compensation","label":"equity vs bonus","type":"constrains"},{"source":"dim_company_stage","target":"company_intro","label":"shapes content","type":"constrains"},{"source":"val_work_modes","target":"dim_work_model","label":"values of","type":"has_value"},{"source":"val_emp_types","target":"employment_type","label":"values of","type":"has_value"},{"source":"con_structure","target":"job_posting","label":"governs layout","type":"constrains"},{"source":"con_consistency","target":"job_posting","label":"governs coherence","type":"constrains"},{"source":"rel_team_scope","target":"role_summary","label":"appears in","type":"part_of"},{"source":"rel_team_scope","target":"responsibilities","label":"appears in","type":"part_of"}]},"pipeline":{"classes":[{"id":"job_posting","label":"Job Posting","description":"The complete document advertising an open position to candidates.","parent":null,"properties":[],"relations":[{"type":"relates_to","target":"Employer","label":"advertised by"},{"type":"relates_to","target":"Role","label":"advertises"},{"type":"part_of","target":"Header Block","label":"begins with"}],"examples":["Senior Data Engineer posting","Store Manager posting"]},{"id":"employer","label":"Employer","description":"The organisation hiring, described briefly.","parent":null,"properties":[],"relations":[{"type":"relates_to","target":"About Us Section","label":"described in"}],"examples":["Alderfield Insights, a 200-person Series C startup","Cedar Lane Grocers, a regional grocery chain"]},{"id":"role","label":"Role","description":"The position being filled, including title, level, team and reporting line.","parent":null,"properties":[{"id":"job_title","label":"Job Title","description":"Name of the position, often with seniority prefix.","examples":["Senior Data Engineer","Store Manager"]},{"id":"reporting_line","label":"Reports To","description":"Manager or function the role reports to.","examples":["District Manager","Head of Engineering"]},{"id":"schedule","label":"Schedule","description":"Hours per week and shift pattern.","examples":["45 hours/week, rotating shifts"]}],"relations":[],"examples":["Staff Backend Engineer","Pharmacy Shift Supervisor"]},{"id":"header_block","label":"Header Block","description":"Top-of-document summary line(s) with title, company, location, work mode, employment type and pay.","parent":null,"properties":[{"id":"job_title","label":"Job Title","description":"Name of the position, often with seniority prefix.","examples":["Senior Data Engineer","Store Manager"]},{"id":"location_mode","label":"Location & Work Mode","description":"Where the work is done: remote, hybrid or on-site, with city or time-zone constraints.","examples":["Remote (EU time zones)","Denver, CO, on-site"]},{"id":"employment_type","label":"Employment Type","description":"Contract basis and hours/status.","examples":["Full-time","Part-time","Full-time, exempt","Contract"]},{"id":"compensation","label":"Compensation","description":"Salary range, currency and variable pay or equity.","examples":["€70,000–€85,000 + equity","$55,000–$65,000 + quarterly bonus up to 8%"]},{"id":"reporting_line","label":"Reports To","description":"Manager or function the role reports to.","examples":["District Manager","Head of Engineering"]}],"relations":[],"examples":["Title · Remote (EU) · Full-time · €60k–€75k","Company: X — Location: Y — Reports to: Z"]},{"id":"company_intro","label":"About Us Section","description":"Short employer pitch with product, scale, size and funding.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Job Posting","label":"section of"}],"examples":["We build logistics software used by 800 warehouses."]},{"id":"role_summary","label":"Role Summary Section","description":"Brief paragraph of what the hire will do and own, including team size.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Job Posting","label":"section of"}],"examples":["You will join a 6-person platform team and own CI tooling."]},{"id":"responsibilities","label":"Responsibilities Section","description":"Bulleted list of 4–6 duties starting with action verbs.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Job Posting","label":"section of"}],"examples":["Design and maintain data pipelines","Hire, train and schedule associates"]},{"id":"qualifications","label":"Qualifications Section","description":"Requirements the candidate should meet, optionally split into must-have and nice-to-have.","parent":null,"properties":[{"id":"must_have","label":"Must-Have Requirements","description":"Mandatory qualifications.","examples":["Strong SQL and Python","High school diploma required"]},{"id":"nice_to_have","label":"Nice-to-Have Requirements","description":"Optional preferred qualifications.","examples":["Terraform","Bachelor's degree a plus"]},{"id":"physical_legal_reqs","label":"Physical & Legal Requirements","description":"Lifting, schedule availability, certifications, background checks.","examples":["Able to lift 40 lbs","Background check required"]}],"relations":[{"type":"part_of","target":"Job Posting","label":"section of"}],"examples":["4+ years in QA automation","Forklift certification within 30 days"]},{"id":"benefits","label":"Benefits Section","description":"Perks and non-salary benefits, as list or inline.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Job Posting","label":"section of"}],"examples":["30 days paid holiday","401(k) with 4% match","€1,000 learning budget"]},{"id":"hiring_process","label":"Hiring Process","description":"Sequence of interview stages and response time.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Job Posting","label":"optional section of"}],"examples":["Intro call → take-home → panel interview","We reply within 5 working days"]}],"dimensions":[{"id":"dim_industry","label":"Industry / Domain","description":"Sector of the employer and role.","values":[]},{"id":"dim_seniority","label":"Seniority Level","description":"Career level of the role.","values":[]},{"id":"dim_work_model","label":"Work Model","description":"Remote, hybrid or on-site.","values":[]},{"id":"dim_region","label":"Region / Locale","description":"Geography determining currency, legal norms and benefit conventions.","values":[]},{"id":"dim_collar","label":"Role Type (knowledge vs operational)","description":"Whether the role is knowledge-work or operational/frontline.","values":[]},{"id":"dim_company_stage","label":"Company Size & Stage","description":"Headcount and funding stage.","values":[]}],"constraints":[{"id":"eeo_statement","label":"Equal Opportunity Statement","description":"Closing statement of non-discrimination.","appliesTo":["Job Posting"]},{"id":"con_structure","label":"Structural Convention","description":"Postings are concise, scannable and bulleted, with section headings in a consistent order: header, intro/summary, responsibilities, qualifications, benefits, process/legal.","appliesTo":["Job Posting"]},{"id":"con_consistency","label":"Internal Consistency","description":"Pay, seniority, experience years and responsibilities must be coherent with each other and the region.","appliesTo":["Job Posting"]}],"promptReady":"# Job Description Ontology\n\nModels public-facing job descriptions/postings across industries, capturing the sections, attributes and axes of variation needed to generate a new realistic job posting from a short prompt.\n\n**Domain:** hiring\n\n## Classes\n\n### Job Posting\nThe complete document advertising an open position to candidates.\n\n**Relations:**\n- advertised by → Employer\n- advertises → Role\n- begins with → Header Block\n\n**Examples:**\n- Senior Data Engineer posting\n- Store Manager posting\n\n### Employer\nThe organisation hiring, described briefly.\n\n**Relations:**\n- described in → About Us Section\n\n**Examples:**\n- Alderfield Insights, a 200-person Series C startup\n- Cedar Lane Grocers, a regional grocery chain\n\n### Role\nThe position being filled, including title, level, team and reporting line.\n\n**Properties:**\n- Job Title: Name of the position, often with seniority prefix.\n  Examples: Senior Data Engineer, Store Manager\n- Reports To: Manager or function the role reports to.\n  Examples: District Manager, Head of Engineering\n- Schedule: Hours per week and shift pattern.\n  Examples: 45 hours/week, rotating shifts\n\n**Examples:**\n- Staff Backend Engineer\n- Pharmacy Shift Supervisor\n\n### Header Block\nTop-of-document summary line(s) with title, company, location, work mode, employment type and pay.\n\n**Properties:**\n- Job Title: Name of the position, often with seniority prefix.\n  Examples: Senior Data Engineer, Store Manager\n- Location & Work Mode: Where the work is done: remote, hybrid or on-site, with city or time-zone constraints.\n  Examples: Remote (EU time zones), Denver, CO, on-site\n- Employment Type: Contract basis and hours/status.\n  Examples: Full-time, Part-time, Full-time, exempt, Contract\n- Compensation: Salary range, currency and variable pay or equity.\n  Examples: €70,000–€85,000 + equity, $55,000–$65,000 + quarterly bonus up to 8%\n- Reports To: Manager or function the role reports to.\n  Examples: District Manager, Head of Engineering\n\n**Examples:**\n- Title · Remote (EU) · Full-time · €60k–€75k\n- Company: X — Location: Y — Reports to: Z\n\n### About Us Section\nShort employer pitch with product, scale, size and funding.\n\n**Relations:**\n- section of → Job Posting\n\n**Examples:**\n- We build logistics software used by 800 warehouses.\n\n### Role Summary Section\nBrief paragraph of what the hire will do and own, including team size.\n\n**Relations:**\n- section of → Job Posting\n\n**Examples:**\n- You will join a 6-person platform team and own CI tooling.\n\n### Responsibilities Section\nBulleted list of 4–6 duties starting with action verbs.\n\n**Relations:**\n- section of → Job Posting\n\n**Examples:**\n- Design and maintain data pipelines\n- Hire, train and schedule associates\n\n### Qualifications Section\nRequirements the candidate should meet, optionally split into must-have and nice-to-have.\n\n**Properties:**\n- Must-Have Requirements: Mandatory qualifications.\n  Examples: Strong SQL and Python, High school diploma required\n- Nice-to-Have Requirements: Optional preferred qualifications.\n  Examples: Terraform, Bachelor's degree a plus\n- Physical & Legal Requirements: Lifting, schedule availability, certifications, background checks.\n  Examples: Able to lift 40 lbs, Background check required\n\n**Relations:**\n- section of → Job Posting\n\n**Examples:**\n- 4+ years in QA automation\n- Forklift certification within 30 days\n\n### Benefits Section\nPerks and non-salary benefits, as list or inline.\n\n**Relations:**\n- section of → Job Posting\n\n**Examples:**\n- 30 days paid holiday\n- 401(k) with 4% match\n- €1,000 learning budget\n\n### Hiring Process\nSequence of interview stages and response time.\n\n**Relations:**\n- optional section of → Job Posting\n\n**Examples:**\n- Intro call → take-home → panel interview\n- We reply within 5 working days\n\n## Dimensions\n\n### Industry / Domain\nSector of the employer and role.\n\n### Seniority Level\nCareer level of the role.\n\n### Work Model\nRemote, hybrid or on-site.\n\n### Region / Locale\nGeography determining currency, legal norms and benefit conventions.\n\n### Role Type (knowledge vs operational)\nWhether the role is knowledge-work or operational/frontline.\n\n### Company Size & Stage\nHeadcount and funding stage.\n\n## Constraints\n\n- **Equal Opportunity Statement** (Job Posting): Closing statement of non-discrimination.\n- **Structural Convention** (Job Posting): Postings are concise, scannable and bulleted, with section headings in a consistent order: header, intro/summary, responsibilities, qualifications, benefits, process/legal.\n- **Internal Consistency** (Job Posting): Pay, seniority, experience years and responsibilities must be coherent with each other and the region."}}