Skip to content

Improvement Candidates

Example from HELIX’s own docs. This generated page comes from docs/helix/. Use it to see the method in practice; start with the artifact-type catalog for reusable templates. Historical plans and reports may describe retired architecture.

Source identity (from 06-iterate/improvement-backlog.md):

ddx:
  id: improvement-backlog
  authoring:
    home: repo
  depends_on:
    - metrics-dashboard
  review:
    self_hash: ed5edb10332f47e1faf1ff63ff3bd6d2b47a8ed959acc9aece1b2f1be8e2bf2c
    deps:
      metrics-dashboard: a6eeafc50ce55540e195d0613e8e23f97e05ca23f39b812821324ee74c78a125
    reviewed_at: "2026-10-04T02:22:28Z"

Improvement Candidates

This page records evidence-backed questions for future work. The runtime work tracker owns execution status and priority commitments.

Evaluation

The metrics dashboard reports the first evaluation sample: nine briefs produced 33/36 deterministic checks and a rubric score of 57/62. The alignment target remains unmeasured because the sample used a fixture seeded with drift.

CandidateEvidenceQuestion
Measure alignment on a healthy artifact setThe current alignment sample has 26 findings on a drift-seeded fixture.Does a healthy set average fewer than three findings per alignment run?
Compare first-pass review of template-authored and free-form PRDsTwo template-authored PRDs passed instance validation; no free-form comparison exists.Do HELIX templates improve first-pass review outcomes?
Reassess overlapping catalog typesThe test and discovery activities contain several related analysis and test-plan types.Do these types serve distinct reader needs?
Consider a .docx rendererThe present renderer produces HTML and PDF.Is a Word format needed by adopters?
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
artifacts/improvement-backlog.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:b91794b2…8213d8e8

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/artifacts/improvement-backlog/",
        "digest": {
          "alg": "sha256",
          "value": "b91794b2a83475d3895a29314410a0e24097d2e8617700f65c383fde8213d8e8"
        }
      }
    ],
    "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": "nt_yYCK56wuv4psdnIzYuYMB5ifhwzRF0-0VJERT3Wk7oMjk0Oio2deCBZqFDWvO3a8rB1je1F24D7oe4MPSDw",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}