Skip to content

Workflow Modes

The HELIX skill routes every request to one workflow mode: a bounded document or workflow action with its own contract. The table below maps user intent to the mode the skill selects; each linked mode opens the full contract the skill follows.

Generated from skills/helix/SKILL.md, the HELIX skill. Edit the skill, not these pages.

User intentWorkflow mode
Convert rough intent into governed HELIX workinput
Grill / interview / stress-test a plan or design until shared understanding (one question at a time)grill
Create or refine product vision, PRD, feature specs, or user storiesframe
Reconcile artifacts, check traceability, find drift, align documents, or move content between artifact layersalign
Check an artifact instance against its template and prompt; edit resolvable findings in placevalidate
Bring every artifact instance up to date with the current templates and promptsrefresh
Thread a new, changed, removed, or incident-driven requirement through existing artifactsevolve
Create a technical design before implementationdesign
Reconstruct missing or incomplete docs from evidencebackfill
Fresh-eyes review of recent work, PRs, plans, or implementationreview
Refine work items for execution readinesspolish
Plan or report a human iteration — sequence a roadmap, define workstreams, cut an iteration/sprint plan, write a status reportiterate
Decide the next safe HELIX actioncheck
Run an optimization experimentexperiment
Bootstrap a brand-new project from bare intent (name, research, vision, scaffold)genesis
Drive a plan or completed work to convergence: review adversarially, fix, re-review until cleanconverge
Audit where a project stands (specs↔impl↔tests↔ACs aligned? complete? next action?)project-audit
Decompose an oversized code module/file into encapsulated units behind a verify gatedecompose-module
Build up end-to-end coverage as a ladder of increasingly complex real-client scenariose2e-ladder
Turn governed artifacts into a deck, one-pager, or brief for clients, sponsors, or executivespresent
Hand governed work to the runtime for execution, source control, or packagingruntime-handoff

Contracts

Align
Use for reconciliation, traceability audits, drift checks, and artifact content placement reviews.
Backfill
Use to reconstruct missing or incomplete HELIX artifacts from evidence.
Check And Next
Use when the safe next action is ambiguous, when the user asks "what’s next" / "what’s blocked" / "plan the change", or when a single ask straddles two or more…
Converge
Use to drive a plan or completed work to convergence: review adversarially, resolve every blocking finding, and re-review until the review comes back clean.
Decompose Module
Use to decompose an oversized, poorly encapsulated code module into focused units, iteratively, behind a per-iteration verification gate. This is code-structur…
Design
Use when implementation needs design authority before build work.
E2E Ladder
Use to build end-to-end coverage as a ladder of scenarios of increasing complexity, each rung a durable automated test that drives the real runtime boundary an…
Evolve
Use when the user wants to add, remove, amend, or thread a requirement through the HELIX artifact stack.
Experiment
Use for metric-driven optimization loops.
Frame
Use for creating or refining product vision, PRD, feature specs, and user stories.
Genesis
Use to bootstrap a brand-new project from bare intent: name it, research the prior art, draft a vision shaped by that research, and scaffold the HELIX structur…
Grill
Use to stress-test a plan, design, or change via a decision-tree interview until shared understanding. Distills the grilling technique (one question at a time,…
Input
Use for sparse user intent that needs to become governed HELIX work.
Iterate
Use to plan or report a human iteration: sequence a roadmap, define workstreams, cut an iteration plan from the backlog and roadmap, or record status against t…
Polish
Use to refine work items before execution.
Present
Use to turn governed artifacts into a deck, brief, or one-pager a client, sponsor, or executive can read or watch on the first try. Output: a deliverable art…
Project Audit
Use on entry to a project with stale context to answer one question: where does this project stand? Are specs, implementation, tests, and acceptance criteria a…
Refresh
Use to bring every artifact instance under a project HELIX tree up to date with the current canonical templates and prompts. Refresh is modes/validate.md (fi…
Review
Use for fresh-eyes review of plans, PRs, implementation, or recent work.
Runtime Handoff
Use when a workflow mode concludes that the next step is execution, source control, packaging, or a long-lived operator loop. HELIX does not own those surfaces…
Validate
Use to check a single artifact instance against its governing template and prompt, then edit resolvable findings in place.
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/_index.md
Signed
2026-09-23T14:11:58Z
Content digest
sha256:1759234d…0bb5b4e2

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/_index/",
        "digest": {
          "alg": "sha256",
          "value": "1759234df0372081d186662dac6daa1ca62e74e9cc80daad43a9b53a0bb5b4e2"
        }
      }
    ],
    "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": "g8Smdx56ZQOPqSu-RRX3ZDXikSuIhS9N_d7qtDVZKynVJK7Xs1M90jk23IdOKUBP4ajR9BMvca2JSXyMA8ImBw",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}