Skip to content

Review

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

Use for an explicitly requested fresh-eyes review of a plan, artifact, change, or implementation.

  1. Define the target and keep the review within that scope. Read the governing requirements, decisions, tests, and changed material that bear on it. Assess cohesion, redundant mechanisms and consequential operations or costs where relevant. Existing test success alone does not justify the design.
  2. Report actionable findings first, with severity, location, and evidence. Verify factual claims about tests, coverage, or metrics before relying on them. Preserve security, correctness, and user-authorized stop rules.
  3. Separate defects from optional improvements.

Source-Code Boundaries

For source changes, review modularity-and-encapsulation against Architecture, Contracts, and the project checker evidence. Inspect relevant imports, exports, mutable state/invariants, vendor-type leakage, integration translation and construction ownership. Respect the chosen style and authorized exceptions. Report missing adoption or new violations; do not infer semantics from a populated table.

Procedure: workflows/actions/fresh-eyes-review.md supplies additional detail.

Fan-out

Apply workflows/references/work-item-first.md spending and review rules. One pass is the default; additional reviewers must answer distinct risk questions within the shared ceiling, not duplicate a full review for consensus.

Use parallel reviewers only when available and useful. Give each a distinct question within the same scope. Resolve duplicate or conflicting findings before reporting; no reviewer may widen the scope or make edits without authorization.

OpenTelemetry Diagnostics

Apply selected o11y-otel practice sections, including agent run diagnostics where commands/tests need persistent evidence. Preserve applicability without silently re-selecting concerns. Require safe run/attempt evidence references, verification outcome and capture limits at execution closeout; a quiet console is not a pass. Shared schemas stay in Contracts, with actual OTel receiver proof for claimed integrations. See workflows/references/agent-diagnostics.md.

UX coverage

For affected interactive UI work, apply ux-interaction-patterns and the selected component owner. Use workflows/references/ux-evidence.md: a missing STP UX Coverage map is an adoption/readiness gap, not retroactive invalidity. Require populated AC mappings and review exclusion reasons. For planning/readiness, check named planned tests, commands, component gaps and evidence capture; do not demand future passing results. For implementation/completion claims, check actual test source and observed runtime results; SDK audit evidence cannot prove interaction flows.

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-11-16T15:52:45Z
Content digest
sha256:95af03c0…0a5b64eb

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/review/",
        "digest": {
          "alg": "sha256",
          "value": "95af03c07acb93b78b815f36a107dfdde3fd1e20d3d74e7e677d8b7d0a5b64eb"
        }
      }
    ],
    "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": "42Y3qGPh37XjdJ2XJb9Nrg06bJeTSl0oZz5tNeHbqQPlU94fkWJg0IrwYJsCxDiDj33ARd7gOKQ6VnlImC0qBQ",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}