Family Benchmark Depth Traceability

Status: proposed and not evaluated
Ontology source: ONTOLOGY/releases/0.1.0/capability-families.json
Depth artifact: ONTOLOGY/fde/0.1.0/family-benchmark-depth.proposed.json
Typed public-site module: apps/public-site/src/data/familyBenchmarkDepth.ts

Purpose and authority

This layer gives every released v0.1.0 capability family a proposed set of observable behaviors, minimum evidence, an applied task, a changing constraint, failure indicators, acceptable alternatives, reference prompts, observable outcomes, and explicit non-inference limits. It is intended to make future assessment-design review concrete.

The released ontology remains authoritative for family identity, domain, name, and definition. The new depth records are authored proposals. They are not a validated measurement model, rubric, score, cutoff, certification rule, or authorization for employment use. A listed artifact is a possible observation source; producing it would not by itself establish workplace performance or individual contribution.

Field contract

Exact release coverage

The artifact retains source order and covers 55 unique IDs: Discovery 6, Software 7, AI Native 8, Architecture 6, Enterprise 7, Production 7, Outcomes 4, Leadership 4, Modernization 2, and Specialization 4.

Structural validation

Run from the repository root:

node scripts/check-family-benchmark-depth.mjs

The focused check compares the proposal with the immutable v0.1.0 family release. It requires exact count, ID set, source order, domain, name, and per-record source binding; rejects duplicate IDs and scoring fields; checks the minimum depth of every structured field; and requires unique task titles, constraint injections, and reference prompts. Passing this check establishes structural coverage only. It does not validate task content or measurement quality.

Public-site integration

Components beneath apps/public-site/src/ can import the proposed layer with:

import {
  familyBenchmarkDepthById,
  familyBenchmarkDepthRecords,
  getFamilyBenchmarkDepth,
  type CapabilityFamilyId,
} from "./data/familyBenchmarkDepth";

For a known family:

const depth = getFamilyBenchmarkDepth("AI.EVALUATION_AND_GUARDRAILS");

For an existing runtime string, first check it against capabilityFamilyIds; do not coerce arbitrary strings into CapabilityFamilyId. The module performs count, membership, duplicate, and source-binding checks when loaded and exposes both the ordered records and an ID-indexed view.

Any UI using this module should display the proposed/not-evaluated state and the relevant non_inference_limits. It should not derive numeric values, readiness labels, rankings, or certification language from these records. No explorer or homepage component is wired to this layer in this change.