Learn

Terminology Model

The core Cuddler terms and how they relate to one another in the publication hierarchy.

Vocabulary map

How the core terms group together

The terms make more sense when you see them as distinct layers rather than one blended idea.

Governing standardsDomain Specification and Artifact Specification

These define the public rules for the domain and the shared authoring model.

Artifact familyArtifact Definition

This is the definition document for one specific artifact type.

Implemented instanceArtifact Document

This is the concrete artifact produced or rendered under the governing contracts.

Input contractData Schema

Validates the data JSON before rendering begins.

Render contractTemplate Schema

Validates the template JSON separately from the data contract.

Final outputRendered Report

The finished HTML output that appears only after both validations succeed.

Precise language keeps the workflow understandable for both people and tools.

Cuddler works best when the language stays precise. The public model uses a small set of terms that map to different responsibilities in the publication and rendering workflow.

Core terms

  • Domain Specification: the governing domain standard that classifies and defines a specific Cuddler domain.
  • Artifact Specification: the shared standard for authoring public Artifact Definitions.
  • Artifact Definition: the definition document for a specific artifact type.
  • Artifact Document: the actual implemented artifact that is produced or rendered from the governed contract.
  • Data Schema: the schema used to validate data JSON before rendering.
  • Template Schema: the schema used to validate template JSON separately from the data.
  • Rendered Report: the final HTML output produced after validation succeeds and rendering is allowed to proceed.

Why the terms matter

These terms are not interchangeable. If you blur them together, the workflow becomes harder to validate and harder to explain. Keeping them distinct makes the publication model easier to review and easier for AI systems to follow.