---
id: process.term-release-spec
title: Release spec (design document of one release)
kind: term
domain: process
description: 'A release spec is a short design-doc-shaped document that says what one release or significant change will do, how it will be checked and how it will be undone, before it is built.'
version: 1.0.1
status: review
authority: uask
applies_to: [core]
sources:
  - title: 'Malte Ubl, "Design Docs at Google" (2020)'
    url: https://www.industrialempathy.com/posts/design-docs-at-google/
    license: LicenseRef-All-Rights-Reserved
    accessed: 2026-11-21
  - title: 'Ryan Singer, "Shape Up" (appetite and the circuit breaker)'
    url: https://basecamp.com/shapeup
    license: LicenseRef-All-Rights-Reserved
    accessed: 2026-11-21
related: [process.release-spec, process.project-lifecycle, req.term-specification, arch.term-blueprint]
last_reviewed: 2026-11-21
review_every: 12
---

## Definition

A **release spec** is a short document, written before building starts, that says what one release or significant change will do and what it will not, how it will be checked, how it will be rolled out and rolled back, and how much time the owner gives it (the appetite). Its shape is a design doc: context and scope, goals and non-goals, design, alternatives considered, then the checks, the rollout and rollback, the work packages and the open questions.

It is not a requirements specification. A [specification](/knowledge/glossary/specification/) describes what a product must do and lasts as long as the product; a release spec describes one change and closes when the release ships.

## Example

`RS-007`: "Add a delivery date to the order. Goals: FR-12 and FR-13. Non-goal: a redesign of checkout. Checks first: two tests, red then green. Rollback: drop the column, ten minutes. Appetite: three agent-days."

## Related

- [Release spec](/knowledge/core/process/release-spec/) — the rules for writing, approving and closing it, and the template.
- [Project lifecycle](/knowledge/core/process/project-lifecycle/) — the phase (Spec) and the gate (G2 Ready) it belongs to.
- [Specification](/knowledge/glossary/specification/) — the requirements side, which this term is kept apart from.
- [Blueprint](/knowledge/glossary/blueprint/) — the system-level document that a release spec changes by section.

## Sources

- [Malte Ubl, "Design Docs at Google"](https://www.industrialempathy.com/posts/design-docs-at-google/) — all rights reserved; summarised, not copied. Accessed 2026-11-21.
- [Ryan Singer, "Shape Up"](https://basecamp.com/shapeup) — all rights reserved; summarised, not copied. Accessed 2026-11-21.
