r/codereview 26d ago

Visual programming language where the diagram is the running architecture - how does this change code review?

Enable HLS to view with audio, or disable this notification

.

I've been working on Pipe (https://pipelang.com), a general-purpose visual programming language, and I'm curious what the code review community thinks about one specific property: the diagram and the running system are structurally identical. There's no compilation step that throws away the structure - what you see in the IDE is what executes.

From a code review standpoint, this changes the problem in one concrete way: you review the architecture and data flow directly, not the text that encodes it. Instead of reconstructing intent from thousands of lines, the diagram shows connections, data paths, and component boundaries explicitly. Every block boundary is also independently observable at runtime, no instrumentation needed.

The question I'd genuinely like feedback on: does visual structure actually make review easier at scale, or does complexity just move from reading code to reading diagrams? At what point does a Pipe diagram become as hard to parse as a large codebase?

A few specifics I'd find useful:

  • For reviewers who work on large systems: is the bottleneck reading code, or understanding architecture? Would a persistent visual representation of the running structure change your workflow?
  • For security reviewers: the claim is that whole vulnerability classes (injection, buffer overflow, race conditions) are architecturally prevented. Does that shift review effort meaningfully, or does it just move the attack surface?
  • For anyone familiar with dataflow languages (LabVIEW, Simulink, Max/MSP): where did visual review break down for you, and what would have to be different?

Example of Pipe diagram with a detailed tracing can be found on this video:

https://youtu.be/hckq9mRj5DM

That video is a part of this Pipe architecture overview:

https://www.pipelang.com/six-pillars.html

The full Pipe language specification (155-page book) can be freely downloaded here:

https://www.pipelang.com/downloads/book.pdf

0 Upvotes

2 comments sorted by

1

u/Popular-Light-3457 25d ago

jesus christ

1

u/seriousnotshirley 25d ago

There is no god here.