Skip to content

Guide

Defensible software release decisions

A defensible release decision is one whose basis can be reviewed and explained long after the decision was made. This guide describes the three elements every defensible release decision needs and the process for producing one.

The three elements

Evidence

The decision must rest on qualified evidence: scanner output, test results, reviewer attestations, or other records that have been evaluated for source, freshness, and corroboration. Belief, verbal assurance, and ticket closure are not evidence.

Policy version

The decision must be bound to the policy version active at the time. Later policy changes do not retroactively rewrite the basis for past decisions.

Reasoning

The decision must record why the evidence satisfied or failed the policy. Without reasoning, a verdict is just an assertion.

How to make a defensible decision

1

Collect qualified evidence

Gather signals from scanners, tests, AI agents, and reviewers. Qualify each signal by source, freshness, and corroboration rather than treating all signals as equal.

2

Identify the active policy version

Determine which version of the release policy applies to this decision. Later policy changes must not retroactively rewrite the basis for this release.

3

Evaluate evidence against policy

Check whether the qualified evidence satisfies each policy requirement. Record where evidence is sufficient, insufficient, or missing.

4

Record the reasoning

Document why the evidence satisfies or fails the policy. Reasoning turns a verdict into a defensible conclusion.

5

Produce and preserve the outcome

Return proceed, stop, escalate, or require authorization. Preserve the evidence bundle, policy snapshot, reasoning, and outcome as a decision record.

Exceptions and escalations

Not every release will satisfy every policy requirement. The doctrine allows exceptions, but they must be explicit. An accepted-risk decision records: the policy requirement waived, the evidence gap that justified the waiver, the authorized party who approved it, and the timeframe or conditions under which the exception expires.

Escalation is the honest alternative to exception. When evidence is insufficient and no authorized party accepts the risk, the outcome is escalate. The release does not proceed on an implied assumption.

Example decision record

Release candidate: payment-service@v2.4.1-rc3
Policy version: release-policy@v2.1
Evidence evaluated: SAST retest pass, dependency scanner pass, reviewer attestation by Jane Doe, runtime telemetry showing no vulnerable call pattern.
Reasoning: All policy requirements for critical-path services were satisfied by corroborated evidence.
Outcome: Proceed

What defensibility does not mean

Defensibility does not mean the decision was perfect. It means the organization can show what evidence was available, what policy applied, and why the outcome followed. The defense is reproducibility, not infallibility.

Frequently asked questions

What makes a release decision defensible?

A defensible release decision can be reviewed long after it was made because its basis — evidence, policy version, and reasoning — is preserved. Defensibility is reproducibility, not infallibility.

What is policy-version binding?

Policy-version binding means the decision is evaluated against the policy version active at the time. Later changes do not retroactively alter the basis for past decisions.

What happens when evidence is missing?

The honest outcome is escalate or require authorization. The missing evidence is recorded, and the release does not proceed on the basis of assumption or status fields.

Who is accountable for the decision?

The decision record names the accountable party and the evidence they relied on. Accountability cannot be outsourced to a tool; it can only be supported by one.

Make every release decision defensible.

GoSentrix preserves the evidence, policy version, and reasoning behind every consequential release decision.