Skip to content

Polish

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

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 by default.

  1. Prefer one item per coherent goal; split requested tracking only for independent scheduling, ownership, parallel execution, or deferred work, keeping dependencies in the order required by the governing plan.
  2. Check scoped items for concrete acceptance criteria, evidence, dependencies, sizing, and applicable runtime labels. Preserve relevant area labels and concern-specific requirements.
  3. Verify existing implementation work against code and tests. Close or re-scope work only when evidence shows the acceptance criteria are already met.
  4. Stop when requested decomposition is complete, scoped items are ready, and no material ambiguity remains. A requested round limit is an upper bound.

Require execution-ready work items to name exact files, commands, checks, fields, or observable outcomes that establish success. If those cannot be specified, mark the item not execution-ready and route it back through planning.

Source-Code Boundaries

Apply modularity-and-encapsulation and the source-code baseline in workflows/references/concern-resolution.md. Feature work is not execution-ready without baseline selection, populated boundary evidence, and sequenced project-local enforcement. Name destination modules and applicable check commands in scoped work items. Bounded adoption/checker work may establish those prerequisites; do not block it on the gate it creates.

Procedure: workflows/actions/polish.md supplies additional detail.

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/polish.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:b41b0f17…505c5229

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/polish/",
        "digest": {
          "alg": "sha256",
          "value": "b41b0f1701a84c0be453e865e2cb44430c060b0cdbdb4d1fc6d68d75505c5229"
        }
      }
    ],
    "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": "k7XHXoGdap39H8ZS7x0I89ZDOqxH2jzsN133D7XsX0Sl_Llmfw3r-_zJYdNfIXZ952jzHXFYmlQaQakTxAa5Dw",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}