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 with the current canonical templates and prompts. Refresh is modes/validate.md (fix-mode) applied across a whole project in one pass.

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).
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.
Aggregate the per-instance validate outputs into a single report: per-classification counts using the unified taxonomy (ALIGNED / INCOMPLETE / DIVERGENT / UNDERSPECIFIED / STALE_PLAN / BLOCKED) plus the union of every handoff validate produced.
Refresh surfaces handoffs in the report. It does not itself file work items; the runtime decides whether to file work from the block or display it unchanged. This keeps refresh runtime-neutral while preserving modes/align.md’s tracker-mutation rules for runtimes that have a tracker.
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.

End with the modes/_report.md block, mode: refresh.

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-09-23T14:11:58Z
Content digest: sha256:8f826cdd…84fb4503

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-09-23T14:11:58Z",
    "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": "8f826cddae37ea865a4627e3b8720014d370fc22251febeafda3a39b84fb4503"
        }
      }
    ],
    "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": "91xUS7hpWaDRK_Hq742o69sp5XD1UEBJ_BR1U3knOSRXJCUit3r-dOFv9mauJpnKMy113GiHDpx5Adn1tqC_BA",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys