Design
Generated from workflows/modes/design.md, the mode contract the HELIX skill loads. Edit that file, not this page.
Use when the requested change needs design authority before implementation.
- Read the requested scope and the governing artifacts that can affect it.
Inspect the affected implementation, producers, consumers, tests and existing
work before proposing interfaces or mechanisms. Keep the outcome bounded;
mechanical propagation across callers is part of completing that outcome.
Prefer evolving a clear existing concept over adding an overlapping one.
Before defining a schema, structured interface, or domain model, apply
workflows/references/umf-schemas.md: inspect UMF core, extensions, and domain packs; reuse or compose suitable definitions by default, and record specific gaps for alternatives. Declare applicable schema references for publication. - Draft the applicable requirements, decisions, interfaces, failure behavior, security, tests, dependencies, risks, and observability. Omit sections that do not apply; do not add empty data-model or security sections for ceremony.
- Preserve acceptance criteria and give each implementation slice a verifiable outcome. Resolve dependencies that materially affect the slice; missing graph edges alone do not delay writing or implementation handoff.
- Resolve material unknowns with evidence or a bounded spike; state unresolved
assumptions. Check governing authority before asking. If a decision only the
operator can make still blocks the design, ask, at any autonomy level; a guess
recorded as an assumption is still a guess. Follow the skill’s
planning-question discipline. Route to
grillwhen the operator asks for an interview or several open decisions interlock. - Stop when the design is implementable and no material ambiguity remains. Treat a requested round count as an upper bound, not a minimum.
- Derive ordered work items only when the user requests them or the runtime requires them.
Source-Code Boundaries
For handwritten source, apply modularity-and-encapsulation: Architecture records Module Boundaries per its practices; Contracts own exact shared interfaces, and TD applies the map. Name actual modules, owned types, public APIs, allowed/forbidden imports, integration owners, construction policy, and a concrete project boundary command. Review semantic correctness; instance structure alone cannot establish readiness.
When the project keeps an architecture model (docs/helix/02-design/architecture-model.toml, format in workflows/references/architecture-model.md), update it with the architecture: add or retire the elements and relations the change touches, each citing the code that shows it, and regenerate the views.
Procedure: workflows/actions/plan.md supplies additional detail.
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/design.md- Signed
- 2026-11-16T15:52:45Z
- Content digest
sha256:1981df38…0ad07d58
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/design/",
"digest": {
"alg": "sha256",
"value": "1981df3805caaaed4fe3db64b2c9eccc29ef74b52d631667ee07aee70ad07d58"
}
}
],
"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": "F3JveO_vyTbEtxTHhKAl71uFHu_ii2RJaabIScpRb7JV5FbHmZ23__8ZdzZXpCFzLx68OAHrq6_0udAZyRptBA",
"signed_at": "2026-11-16T15:52:45Z"
}
]
}