Skip to content

Google Engineering Practices: Small CLs

Source identity:

ddx:
  id: resource.google-small-cls
  authoring:
    home: repo

Google Engineering Practices: Small CLs

Source

Summary

Google’s Engineering Practices recommend small, self-contained changes because they are easier to review, reason about, test, merge, and roll back. The guidance emphasizes that a change should address one coherent thing, include related tests, and leave the system working after it lands.

Relevant Findings

  • Small implementation slices reduce review burden and make defects easier to spot.
  • A change should be self-contained and include the tests needed to understand and validate it.
  • Splitting by files, interfaces, or layers can help large work move through review without losing coherence.
  • Rollback is simpler when each change is bounded and conceptually focused.

HELIX Usage

This resource informs the Technical Design artifact. HELIX uses it to keep story-level technical designs bounded to one vertical slice with explicit file changes, tests, rollback expectations, and implementation sequencing.

Authority Boundary

This resource supports implementation slicing and reviewability. It does not replace HELIX Solution Design, Test Plan, Implementation Plan, or DDx runtime issue tracking.

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/google-small-cls.md
Signed
2026-09-23T14:11:58Z
Content digest
sha256:02a0fa17…ca0c2f99

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/google-small-cls/",
        "digest": {
          "alg": "sha256",
          "value": "02a0fa17341b92ffbf72578869a7ad742bfe6fcdb8e1a513b037dc42ca0c2f99"
        }
      }
    ],
    "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": "WltzyMjVRqMnbqqAQ318uErXq90CWfQPeR5m4qDKssb9w0HO6H7W6mOufWAXMu9BpqB3fbQzEdE4rq_oRpLnAw",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys