Przejdź do treści

Model Card v1

Source schema: doc/schemas/model-card.v1.schema.json

Machine-readable schema for deployment-facing manifests describing intended use, exclusions, risks, and provenance of specialized adapters.

Governing Basis

Project Lineage

Requirements

Stories

Fields

Field Required Shape Description
schema/v yes const: 1 Schema version.
model-card/id yes string Stable identifier of the model card.
adapter/id yes string Adapter artifact described by this model card.
base-model/ref yes string Immutable base model on top of which the adapter operates.
created-at yes string Creation timestamp of the model card.
deployment/scope yes enum: private, federation-local, public Deployment visibility for which this card is valid.
intended-use yes string Intended use domain or task family.
out-of-scope yes string Use classes that are explicitly out of scope.
limitations yes string Known operational or epistemic limitations.
excluded-data-classes yes array Data classes explicitly excluded from the training corpus or deployment use.
known-risks yes array Known risks that operators and federations should keep visible.
evaluation/ref yes string Reference to the evaluation report that justifies publication or deployment.
provenance/refs yes array References to source corpora, jobs, or governance decisions that justify the adapter.
maintainer/refs no array Maintainers or governors responsible for ongoing publication and revocation handling.
policy/profile no string Deployment or governance profile associated with the model card.
status no enum: draft, validated, published, deprecated Lifecycle state of the model card.
policy_annotations no object Optional implementation-local annotations that do not change the core model-card semantics.
## Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

Schema version.

model-card/id

  • Required: yes
  • Shape: string

Stable identifier of the model card.

adapter/id

  • Required: yes
  • Shape: string

Adapter artifact described by this model card.

base-model/ref

  • Required: yes
  • Shape: string

Immutable base model on top of which the adapter operates.

created-at

  • Required: yes
  • Shape: string

Creation timestamp of the model card.

deployment/scope

  • Required: yes
  • Shape: enum: private, federation-local, public

Deployment visibility for which this card is valid.

intended-use

  • Required: yes
  • Shape: string

Intended use domain or task family.

out-of-scope

  • Required: yes
  • Shape: string

Use classes that are explicitly out of scope.

limitations

  • Required: yes
  • Shape: string

Known operational or epistemic limitations.

excluded-data-classes

  • Required: yes
  • Shape: array

Data classes explicitly excluded from the training corpus or deployment use.

known-risks

  • Required: yes
  • Shape: array

Known risks that operators and federations should keep visible.

evaluation/ref

  • Required: yes
  • Shape: string

Reference to the evaluation report that justifies publication or deployment.

provenance/refs

  • Required: yes
  • Shape: array

References to source corpora, jobs, or governance decisions that justify the adapter.

maintainer/refs

  • Required: no
  • Shape: array

Maintainers or governors responsible for ongoing publication and revocation handling.

policy/profile

  • Required: no
  • Shape: string

Deployment or governance profile associated with the model card.

status

  • Required: no
  • Shape: enum: draft, validated, published, deprecated

Lifecycle state of the model card.

policy_annotations

  • Required: no
  • Shape: object

Optional implementation-local annotations that do not change the core model-card semantics.