Tutorial
Lenses and diagrams / Reading diagrams
Reading diagrams
Yichus reads a program and draws pictures of how it is built. These lessons teach you to read those pictures, so that when an agent writes most of a change you can check what it did to the program’s shape without reading every line: whether the router started touching the database, whether anything new depends on a package, whether code was copied.
You don’t need to know Bosatsu, the small typed language the examples are written in; the first lesson shows the little you need.
Each lesson teaches one rule in about five minutes, then gives you statements to judge: the picture confirms it, rules it out, or can’t tell. If you already read dependency graphs, start at Shapes: stacks and hubs. Twelve lessons read the system map, starting at A system map: the wall and its places, and the last three read one route as a tree, starting at What happens when: one route as a tree. Your progress is kept in this browser only.
How to read this lists every mark the lesson pictures draw, with what it means and the lesson that teaches it.
To draw these pictures of your own program, start in the studio with your agent.
Loading the topics.
Ask your agent about anything here; it has the detail.
Where this fits
What this is about: Lenses and diagrams