Skip to content

Decompose Module

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

Use to decompose an oversized, poorly encapsulated code module into focused units, iteratively, behind a per-iteration verification gate. This is code-structure decomposition, distinct from decomposing requirements into work items (frame / polish).

  1. Name the module, the target unit boundaries, and the verify command before the first extraction.
  2. One extraction per iteration; run the verify gate after each; revert an iteration that fails it.
  3. Preserve public behavior and tests; record any interface change as a design decision.
  4. Stop when every unit is under the agreed size and the gate is green.

Procedure: workflows/actions/decompose-module.md (the full action prompt; this file is the contract).

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/decompose-module.md
Signed
2026-09-23T14:11:58Z
Content digest
sha256:03f4604f…722f9fb2

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/decompose-module/",
        "digest": {
          "alg": "sha256",
          "value": "03f4604f5784f97ae5f2e5702122ff6d3c33d69a6193619d8ba27b70722f9fb2"
        }
      }
    ],
    "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": "rdzNZSMteT8dkjunfUrxqc8YCOW3KNq71VCqb0t0vUYb22uOt4Su3DIymPmbtvgO6AeqIPsPLesyYadzVtLlBQ",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}