Reading the map

Islands are systems, slabs are containers, and buildings are components. Round buildings are actors; pills are external systems. Hatched zones group components.

Solid means existing; dashed means draft. Arrows show relationships from source to target.

Building sizes

Floors: source files, grouped into 1–5 floors.
Height: lines of code.
Width: files that depend on it.
Depth: files it depends on.
Patterns: file extensions.

Sizes are relative to the project. Shared floors use the largest measurements; lower floors widen to support those above.

How Groma works

Architecture lives in Markdown. Scans update code evidence; people and agents curate its meaning. Select a component → How it’s built to inspect its files.