# I started asking Claude for state diagrams when its explanations got hard to follow — retained record

> Retained reddit record from reddit:AI_Agents.

Canonical: https://highsignal.app/data/records/0bd4940edd68cd37

[← sources](https://highsignal.app/data)


source: [reddit](https://highsignal.app/data/reddit) (reddit:AI_Agents)  published 2026-11-01 16:03 ingested 2026-11-02 02:37

[original source ↗](https://www.reddit.com/r/AI_Agents/comments/1xl6re0/i_started_asking_claude_for_state_diagrams_when/)

## retained text



```
I keep having this thing happen where Claude explains a flow, I read the whole thing, and I still can’t picture what happens when something fails.

So I added a state-diagram skill to MEX, an open-source project memory tool I maintain for Claude Code and Codex.

You can already ask Claude for Mermaid. What I wanted on top of that was for the explanation to use the relevant decisions and gotchas recorded in the project, with sources I could inspect.  
The screenshot is MEX’s own setup/recovery flow.  
The first pass over the code covered the normal pauses, retries, and saved files. A project note then surfaced a more awkward case: rebuilding the CLI while an old setup process is still running can remove a module that process still references. Hitting Retry doesn’t replace its cached imports.  
That changes the recovery path. You need a fresh CLI process, but you can still reuse the prepared setup files. The diagram spells out the conditions: the old process has exited, the current build is coherent, and the prepared files still exist.

That was the useful addition from MEX here. A recorded project gotcha became an explicit condition in the diagram, with the note and supporting code references attached. I’ve selected that recovery transition in the screenshot so you can see its condition alongside the full flow.

You can ask for the diagram in the conversation, or open it in the local Hub to inspect transitions, conditions, and evidence.  
The skill also supports TLA+/TLC checks for the modeled rules; those checks apply to the model and its assumptions.  
When you ask an agent for diagrams, is it mostly for planning, or for understanding something it already built?  
Repo link in replies

[](/submit/?source_id=t3_1xl6lmr&composer_entry=crosspost_prompt)


```



document fetched 2026-11-02 00:18 · canonical https://reddit.com/r/AI_Agents/comments/1xl6re0/i_started_asking_claude_for_state_diagrams_when
