Skip to content

Refresh

Generated from workflows/modes/refresh.md, the mode contract the HELIX skill loads. Edit that file, not this page.

Use to bring every artifact instance under a project HELIX tree up to date on material content expectations in the current templates and prompts. Refresh is modes/validate.md (fix-mode) applied across the requested project. Do not normalize lifecycle fields, review stamps, headings, or graph edges for parity. Template changes matter when they expose a material content gap.

  1. Resolve the project HELIX root per §Project Root Resolution. Enumerate every artifact instance under it. Group instances by activity directory (00-discover, 01-frame, …, 06-iterate). Skip anything that isn’t an artifact instance (READMEs, plan sub-directories, generated files).
  2. For each instance, run modes/validate.md in fix-mode. When the runtime supports sub-agent dispatch, parallelise across the activity groups (one agent per activity); otherwise execute the groups in activity order.
  3. Summarize the material changes and unresolved findings.
  4. Refresh is read-only against templates and prompts in the skill catalog. If refresh reveals that a template itself needs to change, route through evolve against the catalog separately.
Innsigle seal: model-primary by HELIX

The signature covers the markdown source of this page, not these HTML bytes. This page quotes that seal; verify it against the source file.

Composition
model-primary
Issuer
HELIX helix
Signing key
ed25519:b0865d76d834a52c48506414d16f4e5a (build key)
Signed source
reference/workflow-modes/refresh.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:ec308523…e6abec59

This build key is endorsed by the human key for build signing; the signature is not a detector and not a truth guarantee.

Raw attestation JSON
{
  "payload": {
    "innsigle": "1",
    "type": "https://innsigle.dev/claim/colophon/v1",
    "issued_at": "2026-11-16T15:52:45Z",
    "issuer": {
      "id": "helix",
      "name": "HELIX",
      "key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
      "key_url": "https://documentdrivendx.github.io/helix/.well-known/innsigle/keys.json"
    },
    "subjects": [
      {
        "uri": "https://documentdrivendx.github.io/helix/reference/workflow-modes/refresh/",
        "digest": {
          "alg": "sha256",
          "value": "ec3085231366a5ccae0dafb2bf40606d62298a2287d74a2745fa2023e6abec59"
        }
      }
    ],
    "colophon": {
      "schema_version": "1",
      "composition": "model-primary",
      "ingredients": [
        {
          "kind": "model",
          "name": "Claude",
          "role": "draft"
        },
        {
          "kind": "tool",
          "name": "sloptimizer",
          "role": "rewrite"
        },
        {
          "kind": "human",
          "name": "operator",
          "role": "structure-edit"
        }
      ],
      "notes": null
    }
  },
  "payload_encoding": "json",
  "signatures": [
    {
      "key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
      "alg": "ed25519",
      "sig": "i3cRoEsHvnyn6o33tHStrrjPuOT8bIg0y7DbOB3i9CtAmzWeL-NsZ3Kiv1vPP4b_QnGKxALKPlM_CVfeWGkrDQ",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}