[SC-17811] Document the Create Artifact workflow step

site/guide/workflows/_workflow-step-types.qmd

@@ -41,6 +41,36 @@ SPDX-License-Identifier: AGPL-3.0 AND ValidMind Commercial -->
 Typical **Manual review** pattern: earlier in the intake workflow, a reviewer chooses the path (for example with a **{{< fa arrow-pointer >}} User Action** or **{{< fa maximize >}} Condition Branch**). Configure each path's **Inventory Record Type Change** step with the matching fixed target type and **Manual review** so activity labels the conversion as after manual review.
 :::
 
+### {{< fa expand >}} Create Artifact
+<span id="create-artifact">
+
+- Creates an artifact on the inventory record the workflow is running against.
+- Available on **inventory record workflows only**. An artifact created by this step starts its own artifact workflow, so artifact workflows cannot themselves create artifacts.
+- Requires an artifact type that applies to the workflow's inventory record type.^[[Manage artifact types](/guide/validation/manage-artifact-types.qmd)]
+
+| Field | Description |
+|---:|---|
+| **When These Conditions Are Met** (optional) | Add conditional requirements to qualify for this step.^[ [Conditional step requirements](/guide/workflows/conditional-step-requirements.qmd#create-artifact)]  |
+| **Artifact Type** (required) | The type of artifact to create. |
+| **Title** (required) | The artifact's title. |
+| **Description** (required) | The artifact's description. |
+| **Severity** (optional) | The severity assigned to the artifact. While a step uses a severity, that severity cannot be deleted in settings.^[[Manage artifact severities](/guide/validation/manage-artifact-severities.qmd)] |
+| **Assignee** (optional) | Who the artifact is assigned to. Leave it empty and the artifact is assigned to the user the workflow runs as — the workflow's author on a scheduled run, or the person whose action triggered it. |
+| **Artifact Fields** (optional) | Values for the artifact type's fields. If the artifact type marks a field as required on registration, give it a value here — the workflow cannot be saved until you do, because an artifact cannot be created without it. |
+: **{{< fa expand >}} Create Artifact** step configuration {.hover tbl-colwidths="[40,60]"}
+
+::: {.callout-important title="This step creates a new artifact every time it is reached"}
+If the workflow runs repeatedly while the same situation persists, each run creates another artifact.
+
+This suits conditions describing a **recurring event** — such as *the quarterly attestation was missed* — where each occurrence is a separate failure closed on its own terms, and one artifact per occurrence is what you want.
+
+Take more care with conditions describing a **continuing state** — such as *no validator is assigned* — which stays true until someone fixes it. A monthly workflow would raise the same artifact every month.
+
+Note also that when a condition on this step does not pass, the workflow does not continue past that point — it stops there without reaching an **{{< fa circle-stop >}} End** step. Use a **{{< fa maximize >}} Condition Branch** ahead of the step when something else should happen on the other path, or when you want the workflow to finish cleanly either way.
+:::
+
+An artifact created by this step shows the workflow as its creator in the activity feed, and its detail page shows a **Source** section naming the workflow that raised it, what triggered that workflow, when the artifact was raised, and a link to the run that created it.
+
 ### {{< fa tag >}} Artifact Status Change
 <span id="artifact-status-change">