Architecture as Code · Whitepaper

Chapter 2 · Foundations

Fundamental Principles of Architecture as Code

Key insights from Chapter 2 of "Architecture as Code"

Author Gunnar Nordqvist
Published 23 October 2025
Build number 2025.10
diagram-refresh governance-automation ai-collaboration
Fundamental principles diagram
Fundamental principles diagram

Architecture as Code is founded on core principles that enable successful implementation of codified system architecture. These principles span the entire system landscape and provide a holistic view of architecture management.

The diagram illustrates the key dimensions of Architecture as Code covered in this chapter, including declarative architecture definition, holistic codification, immutable patterns, testability, and documentation as code.

The declarative approach in Architecture as Code describes the desired system state at every level – from application components to infrastructure. This contrasts with imperative programming, where each step must be specified explicitly. Infrastructure as Code tooling draws the same distinction between declarative and imperative approaches (Source [29]).

Primary topics explored

  1. Declarative architecture definition
  2. Holistic perspective on codification
  3. Implementation timeline for Architecture as Code
  4. Architecture as a single source of truth
  5. Immutable architecture patterns
  6. Testability at the architecture level

About Architecture as Code

Infrastructure as Code represents a fundamental change in how we manage and develop IT infrastructure. This book provides organisations with practical guidance for implementing IaC principles whilst fulfilling local compliance requirements and optimising costs.

The book covers everything from fundamental principles and tools to advanced implementation strategies, security aspects, and organisational changes required for successful IaC adoption.

Who should read this

IT architects, DevOps teams, developers, and decision-makers within organisations.

Portrait of Gunnar Nordqvist

Gunnar Nordqvist

Conceived, directed and published the books of The Transformed Architecture.

Continue with the full chapter

Read the full chapter online

Chapter 2: Fundamental Principles of Architecture as Code in Architecture as Code gives the detailed explanations, practical examples and implementation patterns behind this summary.

This whitepaper belongs to “Foundations” and is one of 38 drawn from the manuscript.