> For the complete documentation index, see [llms.txt](https://claudiu-stanciu.gitbook.io/software-craft/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://claudiu-stanciu.gitbook.io/software-craft/software-architecture.md).

# Software Architecture

All things to think about while building the house of cards from the white tower

[Architecture components](/software-craft/software-architecture/architecture-components.md)Define what and why

**Architecture is to the Stability, what Design is to Appearance**

## Key components

1. Architectural characteristics
2. Architectural decision
3. [Architectural components](/software-craft/software-architecture/architecture-components.md)
4. Architectural style

## Analysis

1. Architecture tradeoff analysis method (ATAM) - for tradeoff analysis.
   1. Everything is a tradeoff
2. Cost benefit analysis method (CBAM) - for ROI analysis

## Documentation

ADR - architecture design record - capture what decision has been made and why

Components:

* title
* status
* context
* decision
* consequences
* governance
* notes