Document Role

Choose the document role that matches what your artifact is supposed to do: store data, produce a report, or drive automation.

Choose the Job Your Artifact Plays

These standards are easier to use if you read them as roles, not as abstract categories. Ask what the artifact is mainly supposed to do, then choose the matching role standard.

Document role

Data

Choose Data when the artifact's main job is to hold structured facts that should validate cleanly before anything is rendered or executed.

  • Best fit: records, catalogs, datasets, and governed documents whose meaning should stay stable independent of presentation.
  • Controls: validation, diagnostics, schema identity, release packaging, and data-oriented conformance rules.
  • Not for: report rendering behavior or workflow execution semantics as the primary job.
Current release: 1.0.0
Open Data Standard
Document role

Report

Choose Report when the artifact's main job is to turn validated data into a readable output with explicit layout and render rules.

  • Best fit: report templates, presentation-oriented document types, and output contracts with bindings and sanitization behavior.
  • Controls: render semantics, template rules, paired contracts, and report-specific security and diagnostics.
  • Not for: using the template layer to replace data validation.
Current release: 1.0.0
Open Report Standard
Document role

Automation

Choose Automation when the artifact's main job is to define workflow behavior such as catalogs, ordered steps, prompts, scripts, and execution-related validation.

  • Best fit: workflow packages, prompt-and-script systems, and automation-oriented artifact bundles.
  • Controls: workflow structure, semantic validation, support artifacts, and automation publication rules.
  • Not for: pure data records or rendered report behavior as the primary artifact job.
Current release: 1.0.0
Open Automation Standard

After You Pick A Role

  1. 1

    Read the shared Artifact Specification

    The role standard tells you what special rules apply because of the artifact's job. The Artifact Specification then tells you the shared rules for publishing a public Artifact Definition in any role.

    Open Artifact Specification
  2. 2

    Then choose the exact artifact type

    After the role is clear, browse Artifact Definitions to find the specific type, version, schemas, and examples your implementation should follow.

    Browse Artifact Definitions