Welcome, Guest | Browse

Software Factory Archive

← Previous Work All Works Next Work →

The Pipeline Renders Itself

Rating:
General Audiences
Fandom:
StrongDM Software Factory
Characters:
Jay Taylor Navan Chauhan Justin McCarthy
Tags:
Attractor Graphviz SVG Visualization Map and Territory
Words:
436
Published:
2025-08-19

It happened almost by accident. Someone—Jay would later claim it was Navan, and Navan would later claim it was Jay, and in all likelihood they both did it within minutes of each other—piped an Attractor DOT file through Graphviz and opened the resulting SVG in a browser.

The pipeline rendered itself.

Not a diagram of the pipeline. Not an approximation drawn by a human with a diagramming tool. The actual pipeline definition, the same DOT file that the runner executed, rendered as a clean, structured SVG showing every node, every edge, every condition, every routing path. The visualization was not a separate artifact. It was the same artifact, viewed differently.

"That's cheating," Jay said, staring at the screen. "That's beautiful cheating."

"It's not cheating," Navan said. "The pipeline was always a graph. Graphviz has always been able to render DOT files. We just happen to be using DOT files as our pipeline definition format. The rendering capability was there the whole time. It was already true."

Justin stood behind them, looking at the SVG. Nodes were rounded rectangles in soft blues and greens. Edges were arrows with condition labels. The layout algorithm had arranged everything with the mathematical tidiness that Graphviz was famous for—no overlapping edges, no crossed lines, every path legible.

"The map is the territory," Justin said.

"What?" Jay turned.

"Old philosophy problem. The map is not the territory—the representation of a thing is never the thing itself. Except here. Here, the DOT file is both the map and the territory. The representation IS the executable. The diagram IS the pipeline."

Navan zoomed in on a section of the SVG where the pipeline branched into three paths after the assessment node. The three conditional edges he'd written the week before were rendered as three arrows, each labeled with its condition, fanning out like roads leaving an intersection.

"I can show this to someone who has never seen a line of code," Navan said. "I can show this to a product manager. I can show this to an executive. They will understand the pipeline by looking at the picture. Because the picture IS the pipeline."

"No documentation required," Jay added. "No architecture diagram that gets stale the moment someone changes the code. This diagram is always current because this diagram is what runs."

They sat with it for a while. Three engineers, looking at a picture of a system that was also the system itself. It was a small thing. A dot -Tsvg command. A rendering that had been possible since 1991.

But it felt like the moment in a magic trick when you realize the trick isn't a trick. The rabbit was always in the hat. You just hadn't looked.

Kudos: 95

attractor_orbit 2025-08-21

"The map is the territory" is such a perfect inversion. In most software, the architecture diagram is a lie that slowly diverges from reality. In Attractor, divergence is impossible. The diagram IS the code.

dark_factory_fan 2025-08-22

The rabbit was always in the hat. The best part about this whole archive is the small revelations that feel inevitable in hindsight. Of COURSE the DOT file can be rendered. That's what DOT files are FOR.

← Previous Work All Works Next Work →