Auditors
CORRESPONDING PILLAR Auditors drive the Audit pillar. They verify conformance by navigating the standard like readers, correlating through
.prmmappings to find implementation elements, and viewing.pws/evidence like operators.
Who they are
Auditors are the people who verify conformance against a reference model by following the structural chain from requirement to evidence. Common auditor types:
- External auditors — certification-body auditors (BSI auditors for ISO certification, OIML-appointed assessors, etc.).
- Internal auditors — org staff performing first-party audits ahead of external ones.
- Regulators — market-surveillance or sector regulators checking that certified organisations remain compliant.
- Customer auditors — procurement teams auditing suppliers against standards their supply chain requires.
- Second-party assessors — industry bodies or large buyers performing assessments on member organisations.
What they’re trying to accomplish
For each requirement in the reference model, an auditor follows three steps:
- Navigate the standard — using reader-style spec-browser capability, find the requirement being audited.
- Correlate through the mapping — the auditor’s distinct
skill: follow the
.prmfrom the reference element to its mapped implementation element(s). - View the evidence — using operator-style workspace-browser
capability, look at the
.pws/records the implementation produces, and evaluatevalidate_provision/validate_measurementagainst them.
The output is a compliance verdict — per requirement, passing or failing — with a traceable evidence path from standard clause to workspace record.
The auditor inherits from readers and operators
This is the structural insight. Auditors do not have a wholly new capability set; they combine two existing capability sets and add one distinct skill:
| Capability | Source | What it lets the auditor do |
|---|---|---|
| Standard navigation | Readers | Find provisions, processes, and references in the published .prl |
| Evidence viewing | Operators | Read .pws/ records; follow references between them |
Correlation via .prm |
Auditor’s own | Follow the mapping from a reference element to its implementation element(s) |
Tools built for Readers and Operators can be reused by Auditors without modification. The Auditor-specific tool is the mapping navigator — a tool that, given a reference element, finds the implementation element(s) it maps to and the workspace records those elements produce.
Artifacts they consume / produce
| Artifact | Role |
|---|---|
Reference .prl |
Consumed — the standard being audited against |
Optional .prd |
Consumed — the source clause text |
Implementation .prl |
Consumed — the org’s digital twin |
.prm mapping |
Consumed — how each reference element maps to impl element(s) |
.pws/ workspace |
Consumed — the actual records produced by running the org |
| Compliance verdict + evidence trace | Produced — the audit deliverable |
Tools they use
- Spec browsers — borrowed from Readers; navigate the reference model.
- Workspace browsers — borrowed from Operators; navigate
the
.pws/directory, follow record references. - Mapping navigators — auditor-specific; given a reference
element, walk the
.prmto find implementation element(s) and their evidence. - Provision evaluators — run
validate_provisionandvalidate_measurementexpressions against workspace records to produce pass/fail verdicts. - Audit report generators — produce the compliance verdict document with traceable evidence paths.
A worked example
An auditor verifying Acme against the OCS standard would:
- Open the OCS reference model in a spec browser. Navigate to
clause 4.2 (Bean sourcing). Find
OCS#Provision4-2-1(“The organization shall source beans only from approved suppliers”). - Open Acme’s
acme-to-ocs.prmin a mapping navigator. See thatOCS#Provision4-2-1is mapped to Acme’sSourceBeansprocess (via thevalidate_provisionbinding in the implementation.prl). - Open Acme’s
sample-workspace.pws/workspace. See thatSupplierRegistry/sup-001.yamlshows Highland Beans Co. was approved on 2026-01-05 byoperations.manager@acme.example. See thatBeanLotRegistry/lot-2026-001.yamlreferences that supplier. - Verdict: the requirement is satisfied — beans were sourced from an approved supplier.
Each step uses a different capability. Step 1 uses reader-style
navigation. Step 3 uses operator-style evidence viewing. Step 2 —
the auditor’s distinct skill — correlates via the .prm.
See also
- Audit pillar — the architectural activity this audience drives.
- Readers — whose capability set Auditors inherit (standard navigation).
- Operators — whose capability set Auditors inherit (evidence viewing).
- Implementers — who built the implementation and mapping Auditors verify.