Validate
Generated from workflows/modes/validate.md, the mode contract the HELIX skill loads. Edit that file, not this page.
Use to check a single artifact instance against its governing template and prompt, then edit resolvable findings in place.
- Load the artifact instance and resolve its artifact type: read
ddx:frontmatter when present (ddx.type, else inferred fromddx.idprefix); otherwise resolve by path or filename pattern against the artifact-type catalog the runtime exposes. - Load the artifact-type’s
template.md,prompt.md,meta.yml, and active voice profile from the resolved catalog path (see §Catalog Resolution and §Voice Resolution). - Run the deterministic floor first:
scripts/validate-instance.py <instance>(beside this skill;python3and PyYAML) executes the type’srequired_sections,pattern_checks,automated_checks, placeholder scan, frontmatter checks, and, for a deliverable, the prose audit (prose.*,workflows/references/writing-pass.md) and prints findings with check ids. Treat its findings as evidence to assess, not automatic implementation gates. Report a blocking material gap only with its effect on the scoped outcome, decision, safety constraint, or completion claim. A missing heading can identify missing content; it does not prove that content is unavailable elsewhere. Lifecycle labels, stale review stamps, and missing edges alone are not findings. When the host cannot run scripts, readmeta.yml. - Check applicable requirements from
prompt.md. Omit optional sections when they do not apply; do not addN/Atext to satisfy a template. Check the instance’s statements of status, behavior, location, and count against the code, configuration, and governing artifacts: a claim one of them contradicts isDIVERGENT(cite the source). In fix-mode, correct it only when the contradicting source is authoritative. A corrected artifact makes the guide pages that cite it stale (documentor check, or the agent’s own re-digest without it). - Run voice conformance against the active profile, then classify each finding
keyed to the relevant template, prompt, meta.yml, or voice-profile section
using the Align taxonomy:
ALIGNED,INCOMPLETE,DIVERGENT,UNDERSPECIFIED,STALE_PLAN, orBLOCKED. Forartifact-signal, flag filler, unscoped claims, unsupported implementation-status language in specifications, missing actors, hidden assumptions, and prose that smooths away artifact IDs, paths, commands, metrics, statuses, acceptance criteria, or trace links. If Sloptimizer is available, it may perform this pass using the active HELIX profile as constraints; otherwise apply the profile directly. - Produce updates: when the user invoked validate to fix, apply edits
in place for every finding the template, prompt, metadata, or voice-profile
comparison can resolve mechanically — typically
INCOMPLETEfindings (missing material content, unsupported filler, or unscoped claims). Do not normalize frontmatter, status labels, or headings solely for template parity. For findings classified asDIVERGENT,UNDERSPECIFIED,STALE_PLAN, orBLOCKED, resolve ordinary drift from clear higher authority when edits are authorized. Report evidence and ask for a decision only when unresolved intent materially changes the solution. When the user invoked validate to audit, report each material non-ALIGNEDfinding.
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/validate.md- Signed
- 2026-11-16T15:52:45Z
- Content digest
sha256:98aea56d…37e60125
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/validate/",
"digest": {
"alg": "sha256",
"value": "98aea56dad3c1e3028dc33a358684faa00ca00b377cf3279b6e48c1937e60125"
}
}
],
"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": "BPDohCCgpwMsU7Pj-mORr_fni0pagnp5XANkSfym7ZOwOq0615-8dNo16DBnKDkgHt3b632BazZjc9fyYzWdCw",
"signed_at": "2026-11-16T15:52:45Z"
}
]
}