Skip to content

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.

  1. Load the artifact instance and resolve its artifact type: read ddx: frontmatter when present (ddx.type, else inferred from ddx.id prefix); otherwise resolve by path or filename pattern against the artifact-type catalog the runtime exposes.
  2. 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).
  3. Run the deterministic floor first: scripts/validate-instance.py <instance> (beside this skill; python3 and PyYAML) executes the type’s required_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, read meta.yml.
  4. Check applicable requirements from prompt.md. Omit optional sections when they do not apply; do not add N/A text 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 is DIVERGENT (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).
  5. 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, or BLOCKED. For artifact-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.
  6. 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 INCOMPLETE findings (missing material content, unsupported filler, or unscoped claims). Do not normalize frontmatter, status labels, or headings solely for template parity. For findings classified as DIVERGENT, UNDERSPECIFIED, STALE_PLAN, or BLOCKED, 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-ALIGNED finding.
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"
    }
  ]
}