How AI agents use the Artifact Specification

A definition-building agent authors the contract. A document-building agent then uses that contract and its structured guidance to prepare validatable document content.

  1. Artifact Specification + Document Role The shared authoring rules, one role-specific standard, source context, and domain evidence establish the governing inputs.
  2. Definition-building agent Converts knowable intent into exact constraints and structured for-ai guidance.
  3. Governed definition bundle Produces the Data Schema, sanitized example, aligned Template and Process documents, and current definition file.
  4. Document-building agent Follows the selected definitions, exact schema identity, and embedded guidance instead of an ad hoc prompt.
  5. Validated Artifact Documents Data and Template inputs validate independently before a compatible runtime renders the final Report.

Only the Data member is authored locally as a family-specific schema. Template and Process documents consume the published Cuddler role schemas, and Process remains upstream as authoring and controller context.

What the contract protects

Definitive constraints

Turn knowable intent into required fields, types, formats, enumerations, cardinalities, and conditional rules instead of leaving them to examples.

Instructions that travel

Carry schema-node for-ai guidance with the contract so compatible assistants prepare values from the same instructions reviewers can inspect.

Traceable handoffs

Keep governing standards, exact schema identities, publication inventories, examples, and implementation files aligned across the definition-to-document handoff.

Validation before rendering

Validate Data and Template inputs against their exact contracts before rendering, while Process stays upstream as controlled authoring context.

The standard behind every Artifact Definition

Download the Artifact Specification JSON

Cuddler Artifact Specification Use the shared authoring, conformance, versioning, attribution, and publication contract that every public Artifact Definition must follow. Read the Artifact Specification
Document Role Choose whether the artifact is Data, Template, or Process, then pair that role-specific standard with the Artifact Specification. Open Document Role
Artifact Definitions Use the published definition families, exact schema identities, examples, and governing links to implement concrete artifact types. Open Artifact Definitions

Case studies from teams shipping real documents.

Each sponsor used Cuddler differently, but the same pattern held: structure the data, lock the template, and make the output easier to trust.

Boostware used Cuddler to build a workflow system around document generation, turning operational know-how into structured, reviewable outputs that fit human approval gates.

Read case study

Cocoon CS used Cuddler to define reusable document templates for evidence collection, helping audit-facing outputs stay consistent across frameworks, controls, and review cycles.

Read case study

Day Guardian used Cuddler to build child care safety reports that stayed structured, traceable, and ready for review inside a broader compliance reporting system.

Read case study

EZ Support used Cuddler to streamline the development of SOPs autonomously, giving AI a controlled publishing contract for the procedures that support secure IT operations.

Read case study

Choose your side of the contract

Start with the Artifact Specification whether you are defining a new artifact type or using an existing definition to build a document.

Author the contract Give a compatible agent the Artifact Specification, one Document Role Specification, source context, and domain examples to create a synchronized definition bundle. Build an Artifact Definition
Use the contract Choose a published Artifact Definition and use its exact schema identity plus embedded guidance to prepare validatable Artifact Documents. Try a published schema
Implement precisely Use the canonical URLs, release registry, downloads, and validation order intended for assistants and integration tooling. Open Cuddler for AI