Architectural Decision Records

Source identity:

ddx:
  id: resource.adr-github-organization
  authoring:
    home: repo

Architectural Decision Records

Source

URL: https://adr.github.io/
Accessed: 2026-05-12

Summary

The ADR GitHub organization describes an architectural decision as a justified design choice that addresses architecturally significant requirements. An ADR captures one decision and its rationale, tradeoffs, and consequences. A project’s ADRs form a decision log that helps teams understand why the architecture changed over time.

Relevant Findings

ADRs should capture the reason for a chosen decision, not only the final choice.
A useful ADR focuses on one architecturally significant decision.
Tradeoffs and consequences are central; an ADR without them is just a note.
ADR collections create durable architectural knowledge across iterative work.

HELIX Usage

This resource informs the Architecture Decision Record artifact. HELIX uses it to keep ADRs compact, single-decision records that preserve rationale for agents and humans working from shared context.

Authority Boundary

This resource does not define HELIX’s artifact stack or lifecycle rules. HELIX keeps ADRs subordinate to architecture for structural coherence and treats accepted ADRs as write-once history except for status changes.

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: research/adr-github-organization.md
Signed: 2026-09-23T14:11:58Z
Content digest: sha256:9c82e364…da7102f1

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-09-23T14:11:58Z",
    "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/research/adr-github-organization/",
        "digest": {
          "alg": "sha256",
          "value": "9c82e3642fdbdec8561367a73ac1df78ad33b93403511adc0039f87dda7102f1"
        }
      }
    ],
    "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": "HETyKMJmtwfpTWNkX8t8hMwGgHi3m-G2d_UxkCD9-KgQs3qyrDIh9eBRG7N3fPWB6Oc4a4sYI_b4xuYYXuRyAA",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys