Skip to content

Align

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

Use align to reconcile related HELIX documents and assess whether a named system or component coherently realizes its intent. A document target defaults to that document and relevant authorities. A system/component target includes its relevant implementation and tests; it does not authorize a whole-project audit. Follow relationships only where they can affect the result.

  1. Read the target, its relevant governing artifacts, and the applicable template or metadata. Preserve the authority order: vision, requirements, features and stories, architecture and ADRs, designs, tests, plans, then implementation.
  2. Compare the affected documents for gaps affecting user outcomes, requirements, scope, design choices, safety, or completion evidence. Lifecycle labels, stale review stamps, and missing graph edges alone are not findings. Resolve ordinary drift from clear higher authority when edits are authorized; ask only for material choices that existing intent cannot resolve. Classify a material gap as ALIGNED, INCOMPLETE, DIVERGENT, UNDERSPECIFIED, STALE_PLAN, or BLOCKED. Keep requirements at their intended strength; code alone does not authorize changing them.
  3. For misplaced content, state its source, destination, and the proposed change. Omit a migration ledger unless the user requests one.
  4. Report simplification opportunities within the selected scope separately from classified gaps, as advisory, per actions/reconcile-alignment.md step 6.

For system/component alignment, inspect relevant code and tests without requiring another audit invocation. Keep document-only alignment bounded to its artifacts. A comprehensive implementation inventory still requires explicit selection. Do not infer that every accepted decision has already been implemented.

Source-Code Boundaries

Check modularity-and-encapsulation selection and realization across relevant Architecture, Contracts, TD, test/build plans and scoped work. Separate legacy structural validity from current source-work readiness. When implementation is in scope, compare relevant imports/public surfaces to the map and check for new violations, redundant surfaces or unsupported claims.

Procedure: workflows/actions/reconcile-alignment.md supplies additional detail.

Fan-out

Use parallel reviewers only when the host supports them and the scope warrants it. Give each reviewer a distinct question and the same scope. Reconcile conflicts and duplicates in the final answer. No reviewer may widen scope or write artifacts unless the user authorized those changes.

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/align.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:831a91a0…525f821b

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/align/",
        "digest": {
          "alg": "sha256",
          "value": "831a91a08bff5c8b52d217889069022d22425d420eb915412c1384b0525f821b"
        }
      }
    ],
    "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": "ggN6h5y2914pNn2WYHsdp4lgVJk6w1MQwhoMv0iF_JjX6Hy0p6O9AB9pFMEafkvYc7zAV9jYeSUGXU-qcoqDAw",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}