Portfolio member · home repo

Lives in its own CI and deploy — not listed in toolbox /api/registry or aggregate /api/health.

Principia

Source-graded scholarship that turns fragmented measurement folklore into citeable primitives.

Character

You need defensible constructs for surveys — not anecdotal summaries of papers someone half-read — paired with tooling that acknowledges HR systems and longitudinal designs.

Problem

External. Glossaries collide: one vendor defines engagement, another rebrands burnout scales, reviewers ask for evidence you cannot trace to a citation or grading rubric.

Internal. Analysts reinvent literature reviews quarterly; MCP agents invent instruments because no deterministic catalog binds them yet.

Philosophical. Organizational measurement behaves like observational astronomy — painstaking catalog discipline matters as much as flashy charts.

Guide

Principia owns the scholarly layer: graded sources, constructs, instrumentation evidence, eventually surfaced as research product plus database. People Analytics Toolbox subscribes via principia-connector (catalog-shaped consumption documented in toolbox specs under docs/principia/) — distinct audience, deliberately outside src/spokes/*/contracts.

Abstract

Background. Measurement claims in HR tooling rarely publish provenance at the granularity applied sciences expect; Principia fronts that gap via curated corpora aligned with toolbox strategy docs ( companion spec docs/principia/00-toolbox-vision-and-specification.md).

Methodology. Principia aligns with MCP-forward catalog ergonomics enumerated there — keyed lists for models, constructs, instruments, citations, and evidence rows — while keeping editorial voice outside this Next.js deploy.

Scope. Book/research/database product plus planned native transports; the connector spoke is toolbox-local scaffolding.

Contribution. Supplies measurement vocabulary authoritative enough for calculators and psychometric spokes to cite without hallucinated instrument definitions.

Evidence / Provenance. Public exposition today lives under PeopleAnalyst research URLs; curls below inspect that surface without claiming unreleased MCP responses.

Plan

  1. 01

    Read the companion toolbox spec

    Begin with docs/principia/00-toolbox-vision-and-specification.md for terminology alignment before bridging code.

  2. 02

    Wire toolbox consumers deliberately

    Use principia-connectorfor in-repo bridge work; escalate to Principia transports when MCP modules ship from Principia's repo.

  3. 03

    Keep provenance surfaced

    Pair marketing claims with bibliography-grade citations — Principia inherits the toolbox rule that agents read sources, not folklore.

Call to Action

Direct. Inspect the hosted research exposition — GET curl below confirms the HTML surface today.

Transitional. Vendor Principia-aligned contract snapshots only once Principia publishes immutable semver artefacts; track principia-connector for bridging milestones.

Spoke I/O (visual language v1)

Portfolio members reuse the toolbox’s Spoke I/O visual language — composition view vs. toolbox microservice boundaries documented in PAT-PROTOCOL-A §15. Source package: @people-analytics-toolbox/spoke-illustrations.

Principia — curated corpus → many consumersINPUTSMAIN ACTIONSOUTPUTSPeer-reviewed studiesPDF · DOI corpusMeta-analyseseffect-size tablesTextbooks · handbooksmeasurement loreCodifyGrade provenanceOperationalize constructsConstruct entries · variablescatalog rowsInstrument schemasSurveyItem envelopesToolbox bridgeprincipia-connectorsource-gradedCatalog 6 slotCOMPOSES WITHmetrics-catalogreincarnationcalculuspreference-modelerMCP lookups

Try it now

Copy this curl — it targets https://peopleanalyst.com/research/principia on its own deploy, not People Analytics Toolbox production URLs.

research.principia-public

GET

Public exposition route — verifies live storytelling Principia occupies outside this deploy.

curl -sS "https://peopleanalyst.com/research/principia"

Source repository · separate build

There is nothing to vendor from src/spokes/*/contracts inside this toolbox deploy — the portfolio member publishes its contracts from its home repository and ships on its own CI.

Failure

Consumers keep inventing phantom constructs; MCP tools regress into generic search because no deterministic catalog anchors their outputs.

Success

Contracts cite graded measurement rows; Principia narratives and toolbox calculators stay synchronized instead of drifting silently.