architecture-building-blocks

Document architecture building blocks using arc42 §5 conventions by defining top-level blocks with their names, responsibilities, and interfaces, then map them directly to your code structure layout.

The arc42 §5 building block view documents the static structure of your system, capturing the hierarchy and black-box or white-box views needed to plan and communicate system architecture effectively.

Decompose an architecture block into a white-box view by detailing its inner structure within the Building Blocks section, showing contained sub-blocks and their interactions alongside the black-box top-level definitions.

Yes, arc42 building blocks apply to both greenfield projects and architectural refreshes, allowing you to redefine top-level blocks, responsibilities, and interfaces while mapping the updated architecture to your existing code layout.

Map architecture documentation to your code structure by aligning the hierarchical block table from the Building Blocks section with your actual directories like src/, backend/, or frontend/ to ensure documentation matches the codebase.

No specific framework is required to start documenting building blocks; you simply create or update the docs/architecture/05-building-blocks.md file with the formal Building Blocks section following arc42 §5 conventions.