---
id: arch.term-blueprint
title: Blueprint (architecture and plan)
kind: term
domain: architecture
description: 'A blueprint is a project''s architecture description: the document that says how a product is built to meet its requirements, in twelve sections from goals and stakeholders to risks, plus an annex that maps requirements to sections.'
version: 1.1.0
status: review
applies_to: [core]
sources:
  - title: 'Malte Ubl, "Design Docs at Google"'
    url: https://www.industrialempathy.com/posts/design-docs-at-google/
    license: LicenseRef-All-Rights-Reserved
    accessed: 2026-11-20
  - title: The C4 model for visualising software architecture
    url: https://c4model.com/
    license: CC-BY-4.0
    accessed: 2026-11-20
  - title: SWEBOK Guide v4.0
    url: https://www.computer.org/education/bodies-of-knowledge/software-engineering
    license: LicenseRef-All-Rights-Reserved
    accessed: 2026-11-20
standards: [ISO/IEC/IEEE 42010:2022, arc42 template 9.1 (October 2026)]
related: [arch.c4-model, arch.adr, req.term-specification, mgmt.project-foundation, arch.architecture-description]
last_reviewed: 2026-11-21
review_every: 12
---

## Definition

A **blueprint** is a project's architecture description: the document that says how a product is built to meet its requirements and why. It names the stakeholders and their concerns, then covers, in twelve sections, goals, constraints, context and interfaces, solution strategy, building blocks, runtime, deployment and operations, cross-cutting concepts, decisions, quality requirements, risks and technical debt, and a glossary, with an annex that maps each requirement to a section. Every significant choice in it is recorded as an ADR.

"Blueprint" is the Hub's name for what ISO/IEC/IEEE 42010 calls an architecture description and many teams call a design document or design doc. Its section order follows arc42, cited by reference; the text is the Hub's own.

## Example

"The search runs inside the existing web container **[ADR-0008]**; an external search service was rejected for cost (see the record)." In a Hub project the blueprint is `project/BLUEPRINT.md`, written from `templates/blueprint.md`.

## Related

- [C4 model](/knowledge/core/architecture/c4-model/) — how the context and container views are drawn.
- [Architecture decision records](/knowledge/core/architecture/adr/) — how choices are recorded.
- [Architecture description](/knowledge/core/architecture/architecture-description/) — the sections, the tiers and the rules.
- [Specification](/knowledge/glossary/specification/) — the requirements the blueprint must cover.
- [Project foundation](/knowledge/playbooks/project-foundation/) — the playbook in which the blueprint is stage 5.

## 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-20.
- [The C4 model for visualising software architecture](https://c4model.com/) — CC BY 4.0; summarised, not copied. Accessed 2026-11-20.
- [SWEBOK Guide v4.0](https://www.computer.org/education/bodies-of-knowledge/software-engineering) — all rights reserved; summarised, not copied. Accessed 2026-11-20.
