Spoke

workforce-planning

Conductor — position spine, HRIS/ATS/Finance/PM reconciliation, Bayesian ATS↔open-slot matcher, forecasting snapshots.

Character

Workforce reviews collapse when TA, Finance, HRIS, and position-control systems disagree—yet board decks still pretend one headcount oracle exists.

Problem

External. Each system emits conflicting open role counts—you average them because nothing reconciles probabilistically.

Internal. Hiring managers escalate because requisitions linger unmatched to approved headcount buckets with zero auditable Bayesian rationale.

Philosophical. Strategic workforce demands frozen reconciliation snapshots analogous to ledger close—not rolling Excel optimism.

Guide

Persist canonical positions; run immutable reconciliation comparing HRIS × ATS × Finance × Position-Mgmt variances capturing executive storytelling artefacts; automate 30/60/90 forecasts from freshest trusted inputs; ingest ATS webhooks (Greenhouse) with symmetric secret verification posture mirroring PAT wage integrations; Bayesian matcher proposes ATS requisition ↔ open slot hypotheses with propose/accept/reject/override flows plus PAT-D1-B-FU-C operator queue UI (/conductor/matches) guarding human review for low-confidence overlaps. workforce-planning (consumer brand Conductor) centralises probabilistic reconciliation discipline for leaders tired of contradictory spreadsheets silently diverging nightly.

Abstract

Background. Enterprise workforce planning aggregates fragment across finance budgeting, ATS pipelines, HRIS job architecture, specialised position-management tools—risking contradictory narratives precisely when CEOs demand integrated outlooks anchored by probabilistic bridging evidence.

Methodology. PAT-D1-B models positions as durable entities with ingestion + upsert paths; deterministic reconciliation freezes four-view deltas into immutable snapshots; forecast routines emit forward windows with transparent grain metadata; ATS webhook ingestion maps external jobs ↔ toolbox positions keyed through secret rotation + curated JSON mapping tables; Bayesian matcher leverages calibration harnesses enumerated under src/spokes/workforce-planning/tests powering propose flows with audited accept/reject/override semantics plus supplementary queue surfaces for reviewer throughput.

Scope. Operates intentionally at position grain—not duplicating segmentation-studio canonical person ingestion nor anycomp payout evaluation while complementing via job taxonomy references bridged optionally through job-family-agent contracts downstream.

Contribution. MCP + HTTP parity aligning automation + dashboards; probabilistic artefacts communicate uncertainty transparently contrasting deterministic Excel heuristics historically tolerated.

Evidence / Provenance. PAT-D1-B + PAT-D1-B-FU-C session reports referencing demo SQL seeds (seeds/2026-05-22-workforce-planning-demo.sql, Conductor match drill seed).

Plan

  1. 01

    Upsert canonical positions

    Persist structural attributes aligned with toolbox contracts before downstream reconciliation consumes views.

  2. 02

    Freeze reconciliations + forecasts

    Snapshot four-view deltas + rolling forecast horizons for reproducible decks referencing immutable snapshot identifiers.

  3. 03

    Wire ATS + secrets

    Configure Greenhouse webhook verification + JOB mapping JSON aligning vendor ids ↔ toolbox canonical positions responsibly.

  4. 04

    Queue Bayesian matches

    POST matcher proposals accepting/rejecting/overriding hypotheses via MCP or UI queue until SLA metrics satisfied.

Call to Action

Direct. Load README demo seeds executing GET /positions curls with PAT-N7 tenancy headers or query equivalents.

Transitional. Inspect PAT scout + lift dossiers illustrating variance taxonomy scaffolding Conductor narration.

Spoke I/O (visual language v1)

Every toolbox spoke shares the same abstract choreography: typed inputs on the left, distilled verbs in the center, typed outputs on the right, and (when relevant) cross-spoke HTTP composition along the bottom rail. Source package: @people-analytics-toolbox/spoke-illustrations.

Workforce planningINPUTSMAIN ACTIONSOUTPUTSPosition mgmt eventsReqFillExitStreamReconciliation overlaysShadowSheetDiff[]Forecast priorsDemandShockBundleBayesian headcount reconcileFuse conductor truthsUnified planning ledgerConductorApprovedHCCOMPOSES WITHorg-graphworker-resolutionforecasting

Try it now

Copy this curl. Paste in any terminal. Public read — no auth needed.

workforce-planning.health

GET

GET heartbeat; tenancy-sensitive reads require PAT-N7 context—see README for seeded tenant curls beyond health checks.

curl -sS "https://people-analytics-toolbox.vercel.app/api/spokes/workforce-planning/health"

Vendor the contract

The Zod contract is the source of truth. Vendor a copy into your consumer app — you keep it; we don't break it underneath you. Re-vendor when the version bumps.

// Vendor canonical types:
// src/spokes/workforce-planning/contracts/types.ts

Source path: src/spokes/workforce-planning/contracts/types.ts · GitHub

Try in Dev ConsoleRead the explainerOperator match queue (/conductor/matches)Back to all spokes

Failure

Board reviews rely on contradictory headcount artefacts—capital allocation decisions detach from ATS/hiring realism igniting cascading layoff surprises next fiscal half.

Success

Probabilistically scored matches + immutable reconciliation artefacts unify workforce storytelling across finance sponsors, TA leaders, people analytics interpreters—risk conversations reference explicit snapshot lineage not vibes.