Diagrams

Illustrate a concept

A diagram, in this house, is a combination of attractive 2D or 3D forms that illustrates a concept before any word is read. It is not the engineer's box-and-arrow figure: it is composition, material and light saying the idea.

Method: skill concept-diagrams. Engine research: image models for skills.

The two banks, combinable

Every diagram is one pick from each bank: a structure that says the concept, dressed in a material that gives it beauty. The banks are open: every approved diagram adds its pair. There may be many other subjects; this is the start.

Materials: what it is made of

A material can be photoreal (the Earth, a delta) or crafted (clay, paper). Both are welcome; childish is not.

Structures: how the forms say it

The structure is the argument: pick the one whose geometry IS the concept.

The founding examples

Eight studies made on day one, all with the cheap default engine, centimes in total. The first three play the same concept (an institutional world above, a living territory below, one new bridge) in three materials; the other five each play a different concept. No image carries a single word: real text always sits on the page, above.

spectacularThe Earth at night, Colombia glowing with a green network
DThe network lights up
Material: the Earth from space · Structure: a network · Plays: ten thousand promotores connecting across a country.
A constellation forming a rising path over dark mountains
EThe rising path
Material: a starry sky · Structure: a constellation · Plays: a cohort forms, step by step, valley to sky.
best of the bridge studySoft 3D clay: blue institutional platform, warm territory platform, green bridge
BThe bridge between two worlds
Material: soft 3D clay · Structure: a bridge · Plays: institutions above, territory below, one new link.
A green planet with two rings of shapes crossing at a glowing point
FTwo worlds in orbit
Material: clay cosmos · Structure: orbits that cross · Plays: need and offer meeting at one point of light.
A clay cylinder of earth strata with roots and a living green top
GRegeneration
Material: earth strata · Structure: layers and roots · Plays: results accumulate; the living grows on top.
Aerial view of a river delta branching across warm land
HThe program branches out
Material: aerial water and land · Structure: branching · Plays: one policy reaching a thousand places.
Paper collage scene with a folded green bridge
CThe bridge, in paper
Material: cut and torn paper · Structure: a bridge · Dignified and handcrafted; the institutional side reads less.
kept as counter-exampleFlat 2D attempt where the green ribbon reads as a logo
AWhat failing looks like
Material: flat 2D shapes · The ribbon reads as a logo, the bands say nothing. Weak results are discarded before Frank sees them; this one stays as the lesson.

The four ways to draw one

One family, four recipes. The picture under each is a real thing it made.

The Earth from space with a red network over it

concept-diagrams

Say: illustrate this concept

The house kind, above: forms that carry an idea before a word is read. Made with the cheap image engines, the text laid over the picture afterwards, never inside it.

An architecture diagram in the editorial style

diagram-design

Say: draw the architecture of this

The engineer kind, twenty-seven sorts: architecture, flow, sequence, timeline, quadrant. One self-contained page, one ink, one accent.

An explorable architecture map with a legend and a trace bar

archify

Say: a map I can explore, checked against the code

The same subjects, but the reader hovers to trace a route and the map can be checked against a real repository. It can move, and it exports a picture or a film.

An isometric board of servers and stores

FossFLOW

Say: the isometric board

Machines, stores and documents as blocks seen from the corner, with a built-in icon set. Driven headlessly to a picture, so it lands in a page or a slide.

Looked at and refused, so nobody proposes them again. The whiteboard helpers (Miro, FigJam, Lucid) and the slide-visual makers need a human at the mouse, which fails the one test the studio applies: we must drive it end to end. arch-flows-visualizer makes the same self-contained page as the two above from five commits and no real licence. Datadef is the only one worth remembering: it exposes a machine interface and puts real product icons on an architecture, so it is a candidate the day a page needs vendor icons that FossFLOW does not carry.

The recipe

  1. Say the concept in one sentence. If you cannot, no image will.
  2. Pick the structure whose geometry is the argument (a network for connection, layers for accumulation, a bridge for two worlds).
  3. Pick the material that dresses it with the right dignity for the audience and page.
  4. Generate with the default engine; the prompt always ends with the no-text law. Several candidates cost centimes.
  5. Judge before showing. Open the image yourself; discard the weak; regenerate. Frank never sees a first draft you would not defend.
  6. Render in context. For a page that matters: three directions inside the real page, one recommendation marked.
  7. Real text on top. Labels, titles and numbers live in HTML/SVG above the image, never inside it.
  8. After the verdict, grow the banks. An approved diagram adds its material and structure here.

Engines and cost

EngineUse it forCostState
Gemini image API (gemini-3-pro-image)The default: every study on this page. Photoreal and crafted materials both.Fractions of a centime per imageLive, key in the keys file, proven pattern in the skill
GPT Image 2 (OpenAI API)Complex compositions; keeping one style across a family of pages (16 reference images + mask editing)~$0.05 per image, pay as you goWaiting for top-up
Recraft V4.1Editable vector SVG shapes; a trainable house style$0.08–0.30 per vectorWaiting for top-up
FLUX.2 on RunPodBatches and upscales at open-model prices~1.3 centimes per jobLive in the video toolkit

The laws