← Help Center

Diagrams

Amendary designs diagrams from your code. A generated engineering docs page can get one, and you can ask for one on a mapped Notion page. Every label is checked against what Amendary read, and nothing reaches a page before a person reviews it.

Who can use it?

In early access: turned on per team. Write to hello@amendary.com to try it. Once it is on, watched Notion pages get a Diagrams section in their row on the Pages tab, and generate runs design diagrams for engineering docs. There is no separate Diagrams screen.

What does the result look like?

A system topology diagram Amendary designed and placed on a generated Notion page.
A diagram published in Notion after review. Open the screenshot to inspect it at full size.

How do I suggest a diagram?

  1. On the Pages tab, open the row of a watched Notion page that is mapped to a repo.
  2. In its Diagrams section, select Suggest a diagram.
  3. The confirm step shows the credits the suggestion holds. Select Suggest.
  4. The diagram shows “Designing…” while it runs. When it is done it reads “In the Queue”, or “Not designed” with the reason.

How is a diagram designed?

The model reads the page text and the code of the repo the page was first mapped to, and designs a graph: boxes, arrows, groups and their labels. Code checks the shape (at most 24 boxes, 40 arrows and 6 groups) and checks that every label appears in the page or the code it was shown. A missing label gets one retry. If a label is still missing, nothing is filed and the credits are refunded.

Code then lays the graph out on our server and renders an image and an SVG from the same layout. Each result is saved as a version that never changes.

How do I review it?

The proposal is a card in the Queue. It shows the image, every label with where it was found (the page, or a file in the repo), and Open SVG. Select Add to page, Dismiss, or snooze it.

The check proves that every name exists, not that every arrow is right. Look at the connections before you add a diagram to a page. A diagram always waits for a person, under Review first and under Apply automatically.

What does Add to page do?

The first time, it adds one image to the end of the page with the caption “title (v1)”. A later version replaces that image in place. If someone removed the image or put their own in its place, Amendary adds a new image instead of writing over theirs. If adding fails, the proposal stays in the Queue with the reason.

How do I update a diagram after the page changes?

When the page was edited after its image was added, the diagram’s row on the Pages tab offers Update on page. Amendary designs a new version from the page and code as they are now. It spends credits like a suggestion and waits in the Queue; Add to page replaces the image in place.

Can I edit a diagram?

Not inside Amendary. To get a new version from the page and code as they are now, select Update on page. To use your own picture, replace the image on the page and give it your own caption. Amendary only touches an image whose caption is still the one it wrote, so it leaves yours alone and adds its next version as a new image at the end of the page.

How do I delete one?

Select Delete next to the diagram on the Pages tab. A proposal still waiting in the Queue is rejected with it. If the image is on the page, you choose whether to remove it too; it is only removed while its caption is still the one Amendary wrote. The diagram’s files are removed 30 days later. If you stop watching a page, its diagrams are kept.

What does it cost?

A suggestion spends credits, like generating docs. The credits are held when it starts, settled to what it used when a proposal is filed, and refunded in full when no diagram fits. Credits come with your first paid plan and in one-time packs (see Billing & plans).

What is sent and stored?

The page text and the repo’s code context are sent to the model to design the graph. The graph, the image and the SVG are stored in private storage, and the image is uploaded to Notion when you add it to the page. See Security.

Do generated pages get diagrams?

Engineering docs pages do (not runbooks, playbooks or decision records). The run plans at most one diagram per page, where a picture helps, and designs it after the page is written, with the same label check. You see it in the run’s review, after the page’s first paragraph, and can remove it there. A Notion page gets it as an image; a GitHub docs folder gets an SVG file beside the page. Help center pages and wiki pages get none. If no diagram fits, the page is published without one. Its cost is part of the run’s estimate.

What does it not do yet?

Suggest a diagram works on Notion pages only. Pages in a GitHub docs folder or wiki and Zendesk or Intercom articles cannot get one. Diagrams are not in the API or MCP.

Why does the model not draw the diagram itself?

Models name the parts of a system well and place them badly, so code does the layout. See LLMs are bad at drawing diagrams. Or are they?.

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.