arc42-section-05

Document the arc42 Building Block View by interactively identifying top-level components, their responsibilities, and external interfaces. The process generates a Level-1 view and adds Level-2 candidates only for complex components.

A Level-1 Building Block View in arc42 represents the top-level decomposition of your system, showing black boxes and their external interfaces. It provides the foundational architectural overview before detailing complex components at Level-2.

Create Level-2 building blocks in arc42 Section 5 only when specific Level-1 components are too complex to understand. The process iteratively adds these deeper decompositions as needed rather than forcing them for every block.

Ensure traceability by generating Building Block View outputs that explicitly reference Section 3 external interfaces and Section 4 decomposition strategies. This maintains alignment across the architecture documentation and runtime mappings.

Architecture diagrams generated for the arc42 Building Block View are stored under the docs/diagrams directory. This keeps visual references organized and accessible within your project structure.

Yes, the arc42 Building Block View is documented using an ask-first approach. It interactively gathers project details about components and interfaces, iterating until you are satisfied with the generated output.