HR Operations Guide
Overview
The HR Operations suite consists of three interconnected modules that manage the full lifecycle of employment governance — from contract creation and policy management through to AI-assisted compliance review. All modules require an authenticated admin session with executive or management role coverage.
Module 1: Contracting Hub
Navigation: People > HR > Contracting Hub
The Contracting Hub is the central interface for creating, managing, and reviewing employment contracts built from organisational templates.
Dashboard
The hub opens with metric tiles summarising contract status across the organisation, followed by the template management and contract generation workflows.
Template Management
| Feature | Description |
|---|---|
| Search & Filter | Find templates by name, role group, or status |
| Edit | Modify template details, clauses, and attached KPIs |
| Toggle | Enable or disable templates without deletion |
| New Template | Create a template from scratch with all required fields |
Contract Generation Workflow
- Staff Context Loading — Load a staff member by UUID or email address.
- Template Selection — Choose from active contract templates.
- Contract Configuration — Set dates, hours, rate, pay level, and probation period.
- KPI Assignment — Template KPIs are auto-attached; additional KPIs can be added manually.
- Review & Send — Review the generated contract. The Send button flips status to
awaiting_signature.
Review History
A chronological log of all contracts generated and their current status. Each entry shows:
- Staff member and template used
- Generation date and current status
- Send status and signature tracking
Probation Monitoring
A dedicated tab tracks staff currently in probation periods:
- Days remaining and milestone progress
- Manager review due dates
- Automated reminders for upcoming evaluations
Module 2: Policies & Procedures Studio
Navigation: People > HR > Policies & Procedures
The Policies & Procedures Studio manages the organisation's policy library, providing full lifecycle support from drafting through versioned publication and procedural step definitions.
Policy Library
The main view presents all policies with filtering by:
- Status — Draft, Published, Archived
- Context — Policy domain or applicable department
Policy Studio
Selecting a policy opens the Policy Studio, which contains four sub-tabs:
Overview Tab
| Field | Description |
|---|---|
| Metadata | Policy name, category, owner, and applicability |
| Tags | Searchable classification tags |
| Version History | Chronological list of all published versions |
Drafting Tab
- Full Markdown editor for policy content authoring.
- Save Draft — Persists the current working draft without publishing.
- Use Last Version — Reverts the editor content to the most recently published version.
## Example Policy Section
All staff must complete the following before their first shift:
1. Online induction module
2. Manual handling assessment
3. First aid certification verification
Publish Tab
| Field | Description |
|---|---|
| Version Title | Human-readable name for this release |
| Version Number | Semantic version identifier |
| Publish Action | Marks the draft as published and writes a new record to policy_versions |
Publishing is an explicit action — drafts are never auto-published.
Procedures Tab
Structured procedural steps linked to the policy. Each step includes:
| Field | Description |
|---|---|
code | Unique step identifier |
title | Step heading |
section | Grouping section name |
content | Markdown-formatted step instructions |
Procedures provide the operational "how-to" counterpart to the policy's declarative "what" and "why".
Module 3: LLM Council of Elders
Navigation: Reggie > LLM Council
The LLM Council of Elders is an AI-powered compliance and advisory review system. It conducts structured evaluation sessions against policies, contract templates, or free-form questions, producing scored verdicts with full transcript transparency.
Dashboard
Metric tiles provide an at-a-glance summary:
| Metric | Description |
|---|---|
| Total Sessions | All-time council sessions conducted |
| Completed | Sessions with final verdicts rendered |
| Pending | Sessions awaiting completion or review |
Session Management
| Feature | Description |
|---|---|
| Filter | Narrow sessions by subject type or status |
| Search | Full-text search across session subjects and summaries |
| Detail Panel | Expanded view of a selected session |
Session Detail Panel
Each completed session provides:
- Verdict Scores — Numerical compliance/quality ratings
- Summary Cards — Condensed findings per evaluation dimension
- Cleaned Transcript — Formatted, readable version of the LLM deliberation
- Raw Transcript — Unprocessed LLM output for audit purposes
Creating a New Session
The new session form accepts three input modes:
| Input Mode | Description |
|---|---|
| Policy Version | Evaluate a specific published policy version for compliance |
| Contract Template | Review a contract template for completeness and legal alignment |
| Free Question | Submit an arbitrary HR or compliance question with context notes |
Each mode accepts optional context notes to guide the council's evaluation focus.
API Integration
Council endpoints span two route groups:
/api/v1/hr/... — HR data and policy endpoints
/api/v1/ai/council/... — Council session management and verdict retrieval
Technical Reference
Authentication
All HR Operations modules require:
- Active authenticated admin session
- Executive or management role coverage
Access is enforced by the standard authenticate middleware with role-based guards.
File Locations
| Component | Location |
|---|---|
| Backend routes | backend/routes_v1p/ |
| Frontend HTML | admin/src/html/ |
| Frontend JS | admin/src/js/pages/ |
Key Pages
| Module | HTML | JS |
|---|---|---|
| Contracting Hub | page_hr_contracting.html | page_hr_contracting.js |
| Policies & Procedures | page_hr_policies.html | page_hr_policies.js |
| LLM Council | page_llm_council.html | page_llm_council.js |
| KPI Gallery | page_hr_kpis.html | page_hr_kpis.js |
Summary
The HR Operations suite provides a complete governance layer for employment management. The Contracting Hub handles contract lifecycle from template to signature, the Policies & Procedures Studio manages versioned policy authoring and structured procedures, and the LLM Council of Elders adds AI-powered compliance review with full auditability. Together, these modules ensure that every HR action is documented, version-controlled, and reviewable.