Diagram Atlas

SystemsDRAFT ENTRY

Architecture diagram

A structural map of a system that shows major components, the boundaries that contain them, and the relationships that make the system work.

Use this diagram to generate

USE WHEN

You need a shared mental model of a platform, service landscape, or technical boundary.

AVOID WHEN

The important story is exact request order or an object's lifecycle.

VISUAL GRAMMAR

01components02connections03zones04boundary labels

SEMANTIC RULES

Choose one level of abstraction.
Draw containers before connections.
Reserve accent for the primary path.
Label relationships, not just nodes.

QUESTIONS IT ANSWERS

What exists?
What talks to what?
Where does responsibility change?

DRAFT MACHINE CONTRACT

id: architecture
status: draft
family: systems
reading_task: See components, boundaries, and the main path.
grammar:
  - components
  - connections
  - zones
  - boundary_labels
checks:
  - choose_one_level_of_abstraction
  - draw_containers_before_connections
  - reserve_accent_for_the_primary_path
  - label_relationships_not_just_nodes

Architecture diagram

Choose by the question you need to answer.