Artifacts

Artifacts are Fraya's interactive exercise system. They are used when the learner should do something with the content, not just read or watch it.

Why this exists

Interactive exercises need a shared design model. Without one, prompts tend to mix up:

The artifact framework exists to keep those choices aligned.

The framework defines the shared design language for Artifacts:

five cognitive levels, from recognition to synthesis;
three checking types: strict, soft, and self-check;
interaction archetypes such as matching, categorization, ordering, adjusting, and locating;
decision rules for when each interaction pattern is appropriate.

This makes Artifact design more consistent across planning, generation, and evaluation.

Fraya treats Artifacts as a three-step pipeline:

Outline stage — create a high-level blueprint in the context of the topic/module. This blueprint should define the learning goal, guardrails, assessment type, and cognitive action, but not the concrete template or layout.
Section stage — design the actual exercise concept and data payload in the context of the course terminology and previously taught material.
Artifact generation stage — choose the concrete template/layout and produce the final JSON configuration.

This separation keeps blueprinting pedagogical and keeps template-specific reasoning where it belongs: in the later design and generation steps.

interactive sections in section content generation;
localized artifact payloads when a translated course reuses an existing artifact;
planning steps that choose or design Artifact-based learning activities;
assessment design when the right format is interactive rather than text-only.