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.
- 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.
- 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, orBLOCKED. Keep requirements at their intended strength; code alone does not authorize changing them. - For misplaced content, state its source, destination, and the proposed change. Omit a migration ledger unless the user requests one.
- Report simplification opportunities within the selected scope separately
from classified gaps, as advisory, per
actions/reconcile-alignment.mdstep 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"
}
]
}