Diagrams
Early accessDiagrams designed from the code
Amendary designs diagrams from the code: one for each engineering page a generate run writes, or one you ask for on a Notion page. Every label is checked, and you review the diagram before it reaches the page.
In early access: turned on per team. Write to hello@amendary.com to try it.
Works with
- Notion: works
- GitHub: worksGenerated pages only
- Zendesk: not availableNot yet
- Intercom: not availableNot yet
What it does
- A generate run gives each engineering page it writes one diagram, when the code has something to draw. You see it in the run’s review and can remove it before you publish.
- On a Notion page mapped to a repo, open the page row on the Pages tab and select Suggest a diagram. Amendary designs it from the page text and that repo’s code. Nobody draws.
- The diagram is rendered on our server as an image and an SVG.
- A suggested diagram waits in the Queue. Add to page puts it on the page as an image with a caption that names the diagram and its version. A later version replaces that image in place.
How it works
- The model picks a kind (a flow, a sequence, a data model or a topology) and designs a graph: boxes, arrows and their labels. It never picks colors or positions.
- Code checks the shape: at most 24 boxes and 40 arrows, one-line labels, no two boxes with the same name. A data model has at most 8 entities, a sequence 2 to 6 actors, and only a topology has groups.
- Code checks that every label appears in what the model was shown: the page text or the code. A missing label gets one retry that names it. If a label is still missing, nothing is filed and your credits are refunded. In a generate run, the page is published without a diagram.
- Code lays the graph out with Graphviz and renders the image and the SVG from the same layout. Each result is saved as a version that never changes.
- A suggestion is filed in the Queue with the image and where each label was found.
Why the model never draws
We tried image generation, Mermaid and Excalidraw first. The model was good at naming the parts of a system and bad at placing them. So it only describes the graph, and code does the layout. The full story is in LLMs are bad at drawing diagrams. Or are they?.
What it never does
- It never puts a diagram on a page without a person. A suggestion waits in the Queue in every review mode, and a generated diagram is shown in the run’s review before you publish.
- It never shows a label it could not find in the page or the code.
- It never writes over an image a person replaced or removed. Add to page adds a new image instead.
- It never removes an image from your page unless you ask for that when you delete the diagram.
Evidence and review
The Queue card shows the image, every label and where it was found (the page, or a file in the repo), and a link to the SVG. You select Add to page, Dismiss or Snooze.
Labels are checked; arrows are not. The check proves that every name exists, not that every connection is right, so look at the arrows before you add a diagram to a page.
Limits
- Notion: Suggest a diagram works on pages mapped to a repo, and generated engineering pages get one. The diagram is designed from the code of the first repo the page was mapped to.
- GitHub: only generated engineering pages in a docs folder get a diagram, saved as an SVG beside the page. A wiki gets none yet, and Suggest a diagram is not available for repo pages.
- Zendesk and Intercom: no diagrams yet. Help articles and other customer pages never get one from a generate run.
- Not in the API or MCP.
- One suggestion at a time per page.
- The files of a deleted diagram are removed 30 days later.
Pricing
In a generate run, diagrams are part of the run’s estimate. A suggestion spends credits too: you see what it holds before it starts, it settles to what it used, and it refunds everything when no diagram fits. See Billing & plans.
Where to go next
Try Amendary on your own help center
Connect Notion, GitHub, Zendesk or Intercom and pick the articles to watch. Your first check shows what Amendary would fix, with the change as proof.
Free for 14 days with no card, and every edit waits for your review. Or free forever with your own Anthropic API key. Code is never touched.