Concepts
Drawn by Concepts, about Concepts

This repo’s own
concept library.

Every commit to Concepts, diagrammed by the tool it builds. Open one to see what changed and what it teaches.

  • 4diagrams
  • 33concepts
  • 11kinds
State diagram: the loop before the fix.
dbab40astateNov 6, 2026

Breaking a commit feedback loop

Automatic skips are now derived from each commit’s files instead of saved, so diagram commits stop creating new work.

Derived vs stored state · Self-triggering feedback loops

Flow diagram: separating boundaries after layout.
5d04c47flowNov 6, 2026

Making room between boundaries

After layout, colliding boundary boxes get space inserted between them, repeated until nothing overlaps.

Bounding-box intersection · Overlap removal by inserting space · Iterate until stable

Flow and data-model diagrams: from record to files, and what the agent sends.
26af3fbflow · data modelNov 6, 2026

Diagrams become system-design models

The agent sends shaped views marked new, changed or existing; explanations move out of the picture into the README.

Intermediate representation · Discriminated unions · Compound graph layout · +7 more

Architecture, sequence and data-model diagrams of the first concepts-mcp release.
9931945architecture · sequence · data modelNov 6, 2026

concepts-mcp: an MCP server that draws commits

An agent talks to a local MCP server over stdio, which reads git, validates, lays out and writes the diagrams.

Model Context Protocol · JSON-RPC over stdio · Git hooks · +15 more