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 intent | Workflow mode |
|---|---|
| Convert rough intent into governed HELIX work | input |
| 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 stories | frame |
| Reconcile relevant documents or a named system/component, check traceability, find drift or simplification opportunities, or place content in the right artifact | align |
| Check an artifact instance against its template and prompt; edit resolvable findings in place | validate |
| Bring every artifact instance up to date with the current templates and prompts | refresh |
| Thread a new, changed, removed, or incident-driven requirement through existing artifacts | evolve |
| Create a technical design before implementation | design |
| Reconstruct missing or incomplete docs from evidence | backfill |
| Fresh-eyes review of recent work, PRs, plans, or implementation | review |
| Refine work items for execution readiness | polish |
| Plan or report a human iteration — sequence a roadmap, define workstreams, cut an iteration/sprint plan, write a status report | iterate |
| Decide the next safe HELIX action | check |
| Run an optimization experiment | experiment |
| 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 clean | converge |
| Explicitly audit a named scope across specs, implementation, and tests | project-audit |
| Decompose an oversized code module/file into encapsulated units behind a verify gate | decompose-module |
| Build up end-to-end coverage as a ladder of increasingly complex real-client scenarios | e2e-ladder |
| Turn governed artifacts into a deck, one-pager, or brief for clients, sponsors, or executives | present |
| 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 site | guide |
| 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 patch | shared-edit |
| Hand governed work to the runtime for execution, source control, or packaging | runtime-handoff |
Contracts
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…Use to reconstruct missing or incomplete HELIX artifacts from evidence.
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…
Use when the user asks to review a target, resolve blocking findings, and repeat the review within a stated or agreed limit.
Use to decompose an oversized, poorly encapsulated code module into focused units, iteratively, behind a per-iteration verification gate. This is code-structur…
Use when the requested change needs design authority before implementation.
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…
Use when the user asks to add, amend, remove, or thread a requirement through existing artifacts.
Use for metric-driven optimization loops.
Use for creating or refining product vision, PRD, feature specs, and user stories.
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…
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,…
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…
Use for sparse user intent that needs to become governed HELIX work.
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…
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…
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…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…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…
Use for an explicitly requested fresh-eyes review of a plan, artifact, change, or implementation.
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…
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…
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"
}
]
}