Skip to content

Release Notes — HELIX v0.25.0

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 05-deploy/release-notes.md):

ddx:
  id: release-notes
  authoring:
    home: repo
  depends_on:
    - deployment-checklist
  review:
    self_hash: fb47a9c6a156682c88a3f34e22cdb968b09f586f711e82b16ab068d2cb85f553
    deps:
      deployment-checklist: 00556985f9bfc7cabe6c1288473bb2935f3fe4a83fb5fcd53918e95bf29e5d21
    reviewed_at: "2026-10-04T03:52:23Z"

Release Notes — HELIX v0.25.0

Release Scope

  • Release identifier: v0.25.0
  • Release date: 2026-11-12
  • Previous release: v0.24.0
  • Scope: technology assessments can cover engineering practices.
  • Release owner: HELIX maintainer, publishing through the release PR workflow.

Audience and Channels

AudienceImpactChannel
Technology atlas authorsCan document a practice in a technology assessmentHELIX plugin and skill bundles

Highlights

  • Use scope: practice on a technology assessment to describe how a practice works, when to apply it, and what sources support the findings.
  • Practice assessments require Scope, Findings, and Sources. Product comparison sections are optional for this scope.
  • The catalog includes a practice assessment of continuous integration for web applications.

Required Actions Summary

  • Use the new scope when assessing a practice on its own. Existing assessments require no migration.

Changes and Fixes

AreaWhat changedWho is affected
Technology assessmentAdded a practice scope with its own validation rules, authoring guidance, and exampleTechnology atlas authors

Breaking Changes and Required Actions

The existing technology comparison scope keeps its validation rules.

Migration or Rollback Guidance

Pin v0.24.0 to return to the previous assessment catalog.

Known Issues and Support

Open a GitHub issue in the HELIX repository for support.

References

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/release-notes.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:0657b4e0…901a307d

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/release-notes/",
        "digest": {
          "alg": "sha256",
          "value": "0657b4e05799802e398311cae30ad23dd9ca638a5fdab8b01ebcd94c901a307d"
        }
      }
    ],
    "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": "vzpVpB3wUE6taLy75ZpwH4WpU_RS29E4tE5j4kS499gLUQmvD6DjDG5M_FxjQ1pCXJCOas8pTr-cc22UDMp7Cg",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}