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.
- 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.
- Check scoped items for concrete acceptance criteria, evidence, dependencies, sizing, and applicable runtime labels. Preserve relevant area labels and concern-specific requirements.
- Verify existing implementation work against code and tests. Close or re-scope work only when evidence shows the acceptance criteria are already met.
- 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"
}
]
}