Skip to content

Evolve

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

Use when the user asks to add, amend, remove, or thread a requirement through existing artifacts.

  1. Start with the named entry artifact and the relevant authority. Follow ddx.links only where a relationship can affect this change; use the activity hierarchy when links are absent. Do not traverse the whole project by default.
  2. Identify affected downstream artifacts from relevant links, direct references, and the requested behavior. Preserve legacy relationship fields as written; do not migrate them incidentally.
  3. Resolve ordinary lower-layer drift from clear higher authority within the authorized scope. Surface a material choice only when existing intent cannot resolve it. An ADR establishes direction, not implementation completion.
  4. Update the affected artifacts from highest authority to lowest. Preserve the user’s intended requirement strength and edit only within the authorized scope. Revise affected artifacts in place so each states the current intent; source control keeps the history.
  5. Summarize changed, unchanged, and unresolved artifacts with evidence.

Procedure: workflows/actions/evolve.md supplies additional detail.

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/evolve.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:c339d879…178dcfec

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/evolve/",
        "digest": {
          "alg": "sha256",
          "value": "c339d8792708613fac7b02915c5b3bc6e2d4435b7ec697af51f62fd3178dcfec"
        }
      }
    ],
    "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": "BKsk0MSPgc9p5NFlVJLVq74AwOKK7m7dkOzU_dxwg6h2CDZHtl4DhH64VBq1nVlvwdvFltWkkfivw0chvbn_CQ",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}