Review

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

Use for fresh-eyes review of plans, PRs, implementation, or recent work.

Scope the review narrowly.
Inspect governing artifacts, changed implementation, tests, and public projection relevant to the scope.
Report findings first, ordered by severity (blocking | high | medium | low), with concrete evidence.
Run the claims-vs-reality check: any artifact assertion of a test, coverage figure, or emitted metric that does not exist is a blocking phantom-claim finding counted in summary.phantom_claims (zero-floor), not a stylistic note.
File durable follow-up work for actionable medium-or-higher findings in the project’s work tracker.
A clean verdict is necessary but not sufficient: the loop converges only when the work is verified and each finding-class is folded back into a gate so it cannot silently recur. Drive fixes by progressive evolve against the specific finding, not by re-generating the artifact or implementation.
Intrinsic gates block; external adversarial review is advisory. The intrinsic gates — build, test, template conformance, the phantom-claim count — block convergence. An external adversarial reviewer (a separate tool or model) is advisory input only and must never be a hard gate: when it hangs, errors, or is unavailable, convergence is decided by the intrinsic gates.

Procedure: workflows/actions/fresh-eyes-review.md (deeper step detail; this file is the contract).

Fan-out

When the host can run sub-agents, review in parallel by concern: correctness against the governing artifacts, claims-vs-reality (tests, coverage, metrics that are asserted but absent), scope discipline (unrequested features, narrowed capabilities, out-of-scope diffs), and test adequacy (each acceptance criterion exercised, guard branches included). Each agent returns findings with severity and concrete evidence in the modes/_report.md shape. Fan in by severity, then by evidence path; summary.phantom_claims is the sum across agents and stays a zero-floor gate. Without sub-agents, run the concerns in that order.

End with the modes/_report.md block, mode: review.

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

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/review/",
        "digest": {
          "alg": "sha256",
          "value": "754853294014b7637f8b6e61b596f7954bf98163b625e3bf089373638bbe6ee2"
        }
      }
    ],
    "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": "CA43X1LV8LDx39RD5ePHfZm1tD169jQJaix0c5fxONDFf8RBDvT3OKbe9SH93gyEAxYky8UcMNdIJNmRnloFDw",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys