Skip to content

Grill

Generated from workflows/modes/grill.md, the mode contract the HELIX skill loads. Edit that file, not this page.

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, recommended answers, facts vs decisions). Full procedure: workflows/actions/grill.md in source checkouts; this section is normative for all installs.

Why a mode (not only input): grill is stop-before-act interview discipline; input converts intent into governed work items. Operators must be able to invoke interview-only without drafting PRDs or filing implementation work.

  1. Bind marker and catalog; load governing artifacts; explore the environment for facts.
  2. Build a decision tree of open choices (dependency-ordered), not a bulk questionnaire.
  3. Interactive: ask one question at a time; wait for the answer. Each question includes a recommended answer and short rationale (cite path:line when known). Decisions go to the operator; facts are looked up.
  4. Headless / non-interactive (a runtime’s headless dispatch, CI, one-shot): emit in one response the full decision tree, recommended answers, assumptions for unresolved operator-only decisions, and the handoff (modes/_report.md fields). Do not block waiting for answers.
  5. Hard floor (all autonomy levels): until the operator confirms shared understanding (interactive) or the headless one-shot completes, do not write or edit product source, file implementation work items, or apply/deploy. This is a stop_at-style checkpoint; it does not rewrite autonomy source precedence for other pauses.
  6. Do not create a free-floating CONTEXT.md as authority. After confirm, durable decisions land via handoff into existing catalog types (PRD, FEAT, ADR, technical-design, concerns, etc.).
  7. On confirm (or headless completion), emit a handoff with the four fields defined in modes/_report.md.
  8. Do not silently start frame/design/build in the same turn unless the operator asks.

Procedure: workflows/actions/grill.md (deeper step detail; this file is the contract).

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/grill.md
Signed
2026-09-23T14:11:58Z
Content digest
sha256:8e892bdc…b5f52b6d

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/grill/",
        "digest": {
          "alg": "sha256",
          "value": "8e892bdcf5be7eb12015d21c03cb46cd3e90d59f73eac7b94450d5bab5f52b6d"
        }
      }
    ],
    "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": "0-nBWrBPyCns4BqhrRBo3yDdzajb-2SzNmue4iCTIdIAuP0zXa1Euxjmo_wystwgI3fKlRxO2bzyHIxFqBnDCA",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}