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 relevant documents or a named system/component, check traceability, find drift or simplification opportunities, or place content in the right artifactalign
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
Explicitly audit a named scope across specs, implementation, and testsproject-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
Give a repository its guide, or one page of it: pages for developers, operators, users, and data consumers, generated, written, evaluated, checked, and assembled into a siteguide
Work on a governed document with people in a shared editing surface (draft, comments, live editing) and land the result in the repository as a patchshared-edit
Hand governed work to the runtime for execution, source control, or packagingruntime-handoff

Contracts

Align
Use align to reconcile related HELIX documents and assess whether a named system or component coherently realizes its intent. A document target defaults to t…
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 when the user asks to review a target, resolve blocking findings, and repeat the review within a stated or agreed limit.
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 the requested change needs design authority before implementation.
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 asks to add, amend, remove, or thread a requirement through existing artifacts.
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,…
Guide
Use to give a repository the documentation its readers need, and to keep it current: pages for developers, operators, users, and data consumers, each a project…
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 when the user asks to decompose or refine work items for a named scope. Infer the scope from the task; ask when it is unclear. Do not select all open work…
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 only when the user explicitly asks for an implementation audit of what is built. Aligning a named system or component (align) already inspects its code a…
Refresh
Use to bring every artifact instance under a project HELIX tree up to date on material content expectations in the current templates and prompts. Refresh is `m…
Review
Use for an explicitly requested fresh-eyes review of a plan, artifact, change, or implementation.
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…
Shared Edit
Use when people and an agent should work on a governed document together in a shared editing surface (live editing, comments the agent answers) while the repos…
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-11-16T15:52:45Z
Content digest
sha256:aabb357d…5c5ae7f5

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/_index/",
        "digest": {
          "alg": "sha256",
          "value": "aabb357d3dfa4de13618c8eaf2136c7198dc7570daa886d144f08c615c5ae7f5"
        }
      }
    ],
    "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": "Y_cHL1urk0qQkJLKB5CQKokodXEUz459O9Hy9-l93gr6cBu8ZQ1aU-S8tGOPwMDTPJ3IPe6cvL0j-NCGOp-_CA",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}