<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Sheel Khanna</title>
    <description>The latest articles on DEV Community by Sheel Khanna (@sheel_khanna_418791d4d635).</description>
    <link>https://dev.to/sheel_khanna_418791d4d635</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4245304%2Fb97c5d9c-1fb7-4bc0-8ce8-242d421641c2.jpg</url>
      <title>DEV Community: Sheel Khanna</title>
      <link>https://dev.to/sheel_khanna_418791d4d635</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/sheel_khanna_418791d4d635"/>
    <language>en</language>
    <item>
      <title>Turn any repo into a shareable architecture board with Claude Code (step by step)</title>
      <dc:creator>Sheel Khanna</dc:creator>
      <pubDate>Sun, 15 Nov 2026 14:56:17 +0000</pubDate>
      <link>https://dev.to/sheel_khanna_418791d4d635/turn-any-repo-into-a-shareable-architecture-board-with-claude-code-step-by-step-2ncf</link>
      <guid>https://dev.to/sheel_khanna_418791d4d635/turn-any-repo-into-a-shareable-architecture-board-with-claude-code-step-by-step-2ncf</guid>
      <description>&lt;p&gt;Most architecture diagrams are stale the day after they're drawn, because drawing them by hand is tedious and nobody wants to redo it. Here's a way to get a &lt;em&gt;first draft&lt;/em&gt; in about a minute, from the code you already have open — and end up with a board your team can actually edit, not a picture you'll never touch again.&lt;/p&gt;

&lt;p&gt;The short version: connect &lt;a href="https://modelcontextprotocol.io" rel="noopener noreferrer"&gt;Claude Code&lt;/a&gt; to &lt;a href="https://drawlyhub.com/demo?ref=devto" rel="noopener noreferrer"&gt;DrawlyHub&lt;/a&gt; over MCP, point it at a repo, and ask it to document the thing. This is the step-by-step. (If you want the &lt;em&gt;why&lt;/em&gt; — why a board beats a Mermaid snippet — I wrote that up &lt;a href="https://drawlyhub.com/blog/ai-agent-architecture-diagrams-over-mcp?ref=devto" rel="noopener noreferrer"&gt;here&lt;/a&gt;; this post is the how.)&lt;/p&gt;

&lt;h2&gt;
  
  
  What you'll build
&lt;/h2&gt;

&lt;p&gt;A DrawlyHub board with a shareable URL: your services as boxes, the request path and data stores wired up with labelled connectors, laid out on a frame you can pan, zoom, and drag. Made from your actual code — you don't describe the boxes, the agent finds them.&lt;/p&gt;

&lt;h2&gt;
  
  
  Before you start
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Claude Code&lt;/strong&gt; installed and working in a terminal. (Any MCP-capable client works; the commands below are Claude Code's.)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A repository open&lt;/strong&gt; — one you know well, so you can sanity-check what the agent inferred.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A DrawlyHub account.&lt;/strong&gt; Driving boards from an agent is a Pro feature; there's a two-week trial with no card if you just want to try the flow.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step 1 · Add the MCP server
&lt;/h2&gt;

&lt;p&gt;MCP is the standard that lets an AI client discover a tool's capabilities and call them with &lt;em&gt;your&lt;/em&gt; authorization — so instead of printing diagram syntax, the agent calls real tools like "create a board." Add DrawlyHub as a server:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude mcp add --transport http \
  drawlyhub https://drawlyhub.com/mcp
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Your DrawlyHub &lt;strong&gt;Profile&lt;/strong&gt; page shows the exact command for your account, so you can copy it rather than type it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2 · Connect and approve it
&lt;/h2&gt;

&lt;p&gt;Run &lt;code&gt;/mcp&lt;/code&gt; in Claude Code and choose &lt;strong&gt;drawlyhub&lt;/strong&gt;. Your browser opens DrawlyHub's consent page — sign in if asked, then &lt;strong&gt;Allow&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;That consent screen is the whole security model, so it's worth understanding what you're agreeing to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The client registers itself automatically (open Dynamic Client Registration, RFC 7591 — the standard for MCP), so there's &lt;strong&gt;no API key to paste or leak&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;You approve what the agent may do, in your own browser, before it touches anything.&lt;/li&gt;
&lt;li&gt;Once approved, the agent acts &lt;strong&gt;as you&lt;/strong&gt;: it can only reach the boards your own account can. A client that isn't a first-party app is labelled &lt;strong&gt;unverified&lt;/strong&gt;, so a look-alike can't impersonate something you trust.&lt;/li&gt;
&lt;li&gt;You can revoke it any time from &lt;strong&gt;Profile ▸ Connected apps&lt;/strong&gt; — it's a scoped, revocable session, not a standing key.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step 3 · Ask it to document the repo
&lt;/h2&gt;

&lt;p&gt;Open the project and ask in plain words:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;Build a DrawlyHub board that documents this repository.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Claude Code reads the code it already has access to — entry points, services, the data layer — composes the whole diagram as one board document, validates it, and creates it. A few seconds later it hands back a URL. Open it: the boxes are there, wired up, on a frame you can move around.&lt;/p&gt;

&lt;p&gt;Here's what the agent is doing behind that one sentence, if you're curious:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="nf"&gt;describe_format&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;              &lt;span class="c1"&gt;# learn the board schema&lt;/span&gt;
&lt;span class="c1"&gt;# ... agent reads your repo and composes the whole board as one document ...&lt;/span&gt;
&lt;span class="nf"&gt;validate_board&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;board&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;# dry-run: catches a dangling link before anything is created&lt;/span&gt;
&lt;span class="nf"&gt;create_board&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;board&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;   &lt;span class="c1"&gt;# creates it, returns the board's URL&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Connectors reference box ids, so they stay attached when you move a box later — which matters for the next step.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 4 · Refine it — by dragging, not re-prompting
&lt;/h2&gt;

&lt;p&gt;This is the part you can't do with a snippet. The agent gave you a draft; now make it yours:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Move things.&lt;/strong&gt; Grab a box and drag it; the connectors follow.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Annotate.&lt;/strong&gt; Drop a sticky note — &lt;em&gt;"autoscaling TBD"&lt;/em&gt;, &lt;em&gt;"owned by payments team"&lt;/em&gt; — right on the canvas.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Iterate with the agent.&lt;/strong&gt; Ask it to change the board in place:&lt;/li&gt;
&lt;/ul&gt;

&lt;blockquote&gt;
&lt;p&gt;Add a Redis cache between the API and the database, and a queue for the worker.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;It uses &lt;code&gt;regenerate_board&lt;/code&gt;, which &lt;strong&gt;saves a version first&lt;/strong&gt;, so you can always roll back.&lt;/p&gt;

&lt;p&gt;Mix the two freely: let the agent do the bulk placement, then nudge the three boxes it got wrong by hand.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 5 · Share, present, export
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Share a link.&lt;/strong&gt; View-only for anyone, or give a teammate edit access. Link it from the PR or the ticket.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Present it.&lt;/strong&gt; Boards organize into frames (think slides), so one board can hold the request path, the data model, and the deploy pipeline — step through them frame by frame.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Export.&lt;/strong&gt; PNG or SVG of a frame, or the whole board as a &lt;code&gt;.drawly&lt;/code&gt; file you can re-import later.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Prompts worth keeping
&lt;/h2&gt;

&lt;p&gt;Start broad, then narrow. A few that work well:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Goal&lt;/th&gt;
&lt;th&gt;Prompt&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Whole-system overview&lt;/td&gt;
&lt;td&gt;&lt;em&gt;Build a DrawlyHub board that documents this repository.&lt;/em&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Just the hot path&lt;/td&gt;
&lt;td&gt;&lt;em&gt;Draw only the request path for a logged-in user, from the edge to the database.&lt;/em&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Data model&lt;/td&gt;
&lt;td&gt;&lt;em&gt;Create a board showing the main entities and how they relate.&lt;/em&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;A specific flow&lt;/td&gt;
&lt;td&gt;
&lt;em&gt;Add a frame with a sequence diagram of the login flow.&lt;/em&gt; (The agent can drop a &lt;strong&gt;Mermaid container&lt;/strong&gt; when text beats boxes — it renders from code but lives on the same canvas.)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Tidy up&lt;/td&gt;
&lt;td&gt;&lt;em&gt;Group the AWS services into a labelled zone and align them.&lt;/em&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Troubleshooting &amp;amp; good to know
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;It got the shape wrong.&lt;/strong&gt; On an unfamiliar or sprawling repo, the agent infers — check what it drew against what you know, and correct it with a follow-up prompt or by hand. It's a head start, not an architect.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;It's a whiteboard, not a modeling tool.&lt;/strong&gt; Great for thinking visually, fast. If you need validated infrastructure-as-code or a cost estimate, this isn't that.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Want tighter layouts?&lt;/strong&gt; There's a small skill that teaches an agent DrawlyHub's layout rules, at &lt;code&gt;/drawly/skill&lt;/code&gt; — point your agent at it and the boards come back cleaner.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The toolbox&lt;/strong&gt; behind the consent screen is small and named: &lt;code&gt;list_boards&lt;/code&gt;, &lt;code&gt;get_board&lt;/code&gt;, &lt;code&gt;validate_board&lt;/code&gt;, &lt;code&gt;create_board&lt;/code&gt;, &lt;code&gt;regenerate_board&lt;/code&gt;. Nothing else.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;See the canvas first on the live &lt;a href="https://drawlyhub.com/demo?ref=devto" rel="noopener noreferrer"&gt;demo board&lt;/a&gt; — no account needed.&lt;/li&gt;
&lt;li&gt;Then run the three steps above against a repo you know, and see whether it got the architecture right.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The whole point is that the output &lt;em&gt;is&lt;/em&gt; the shared artifact — built from the code on your disk, editable by your team, living at a URL instead of evaporating in a chat transcript. If you draw something good with it, I'd like to see it.&lt;/p&gt;

</description>
      <category>mcp</category>
      <category>ai</category>
      <category>tutorial</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Mermaid, hand-drawn, or AI-generated: which diagram should you reach for?</title>
      <dc:creator>Sheel Khanna</dc:creator>
      <pubDate>Sun, 15 Nov 2026 03:39:01 +0000</pubDate>
      <link>https://dev.to/sheel_khanna_418791d4d635/mermaid-hand-drawn-or-ai-generated-which-diagram-should-you-reach-for-1f08</link>
      <guid>https://dev.to/sheel_khanna_418791d4d635/mermaid-hand-drawn-or-ai-generated-which-diagram-should-you-reach-for-1f08</guid>
      <description>&lt;p&gt;If you've ever written a Mermaid diagram, you know the two feelings. The first is delight: four lines of text and you have a sequence diagram, versioned in Git, rendered in your README. The second comes about twenty nodes later, when the auto-layout drops a box exactly where you don't want it and there is &lt;em&gt;nothing you can do about it.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;That whiplash is the whole topic. There are three ways to get a diagram today — write it as text, draw it by hand, or have an AI generate it — and they are good at different things. Reaching for the wrong one is why diagrams feel like a chore. Here's how to pick.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Text-based (Mermaid): when the structure &lt;em&gt;is&lt;/em&gt; the diagram
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://mermaid.js.org/" rel="noopener noreferrer"&gt;Mermaid&lt;/a&gt; turns text into diagrams. Its superpower is that the diagram is &lt;strong&gt;code&lt;/strong&gt;: it diffs in a pull request, it lives next to the thing it documents, and for certain shapes it's simply the fastest way to get a correct picture.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Reach for it when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The diagram is a &lt;strong&gt;known type with a standard layout&lt;/strong&gt; — a sequence diagram, a state machine, an entity-relationship diagram, a Gantt chart. Mermaid has a grammar for these, and the auto-layout is usually right because the shape is conventional.&lt;/li&gt;
&lt;li&gt;It belongs &lt;strong&gt;in the repo&lt;/strong&gt; and should change when the code changes. A sequence diagram of an auth flow that lives in the README and diffs with the handler is worth its weight.&lt;/li&gt;
&lt;li&gt;You want &lt;strong&gt;zero visual fuss&lt;/strong&gt; — no dragging, no alignment, just the facts.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;It fights you when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;You need &lt;strong&gt;control over layout&lt;/strong&gt;. Mermaid decides where nodes go; past medium complexity you're fighting the layout engine, adding invisible nodes and direction hints to coerce it.&lt;/li&gt;
&lt;li&gt;The diagram is &lt;strong&gt;freeform&lt;/strong&gt; — a system architecture with a particular spatial story, a design sketch, anything where &lt;em&gt;where things sit&lt;/em&gt; carries meaning.&lt;/li&gt;
&lt;li&gt;You want to &lt;strong&gt;annotate and discuss&lt;/strong&gt; on top of it. Mermaid is render-only; there's no sticky note, no "why is this here?" in the margin.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  2. Hand-drawn on a canvas: when layout and annotation matter
&lt;/h2&gt;

&lt;p&gt;A whiteboard canvas — boxes you place, connectors you route, sticky notes you drop — is the opposite trade. You give up diffability and gain total control.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Reach for it when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Position is part of the meaning.&lt;/strong&gt; Cloud architecture, network topology, a seating chart, a service map — anything where the spatial arrangement is information, not decoration.&lt;/li&gt;
&lt;li&gt;You're &lt;strong&gt;thinking, not documenting.&lt;/strong&gt; Early design is messy: you move things, group them, cross them out. A canvas is built for that; a grammar isn't.&lt;/li&gt;
&lt;li&gt;The artifact is &lt;strong&gt;for people to work on together&lt;/strong&gt; — annotate, present, hand off. A board has a URL you share; it isn't trapped in one chat or one file.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;It fights you when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;You want it &lt;strong&gt;versioned and diffable&lt;/strong&gt; — a canvas is a visual artifact, not a text diff (export to SVG or &lt;code&gt;.drawly&lt;/code&gt; helps, but it's not a code review).&lt;/li&gt;
&lt;li&gt;The diagram is a &lt;strong&gt;standard type&lt;/strong&gt; Mermaid would nail in four lines — hand-placing a sequence diagram is busywork.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  3. AI-generated: when you want a first draft in seconds
&lt;/h2&gt;

&lt;p&gt;The newest option: describe the diagram and let an AI agent draft it. Done well — for example, an agent that builds boards over &lt;a href="https://modelcontextprotocol.io" rel="noopener noreferrer"&gt;MCP&lt;/a&gt; — this collapses the blank-canvas problem. You say "three-tier web app on AWS," and you get boxes and connectors already placed, ready to refine.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Reach for it when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;You want to &lt;strong&gt;skip the blank page.&lt;/strong&gt; The agent's first pass gets you 80% of a layout to react to, which is far faster than starting from nothing.&lt;/li&gt;
&lt;li&gt;The diagram is &lt;strong&gt;tedious but not subtle&lt;/strong&gt; — lots of boxes, obvious connections, the kind of thing you'd draw correctly but slowly.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;It fights you when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Correctness matters more than speed.&lt;/strong&gt; The agent places what you said; it doesn't know your system is wrong. Every generated diagram needs a human read.&lt;/li&gt;
&lt;li&gt;You need it &lt;strong&gt;exactly right the first time&lt;/strong&gt; — generation is a draft tool, not an authority.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  The decision table
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Your situation&lt;/th&gt;
&lt;th&gt;Reach for&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Sequence / state / ER / Gantt diagram&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Mermaid&lt;/strong&gt; — standard layout, diffs in the repo&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Lives in the README, changes with the code&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Mermaid&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Cloud/network architecture, spatial story&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Hand-drawn canvas&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Early design, messy thinking, group + annotate&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Hand-drawn canvas&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Needs a shareable URL for the team to edit&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Hand-drawn canvas&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Lots of boxes, obvious wiring, want a head start&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;AI-generated draft&lt;/strong&gt;, then refine&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Blank-page paralysis&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;AI-generated draft&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Must be exactly right, no review&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Hand-drawn&lt;/strong&gt; (own every box yourself)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  The real answer: you shouldn't have to choose per diagram
&lt;/h2&gt;

&lt;p&gt;The trap in every "X vs. Y" comparison is the word "vs." Real documents mix diagram types: the architecture is spatial, the auth flow is a sequence diagram, and half the boxes are the same ones you'd have drawn by hand. Picking one tool for the whole document means the wrong tool for half of it.&lt;/p&gt;

&lt;p&gt;The version that actually works is &lt;strong&gt;one surface that holds all three&lt;/strong&gt;. On &lt;a href="https://drawlyhub.com/demo?ref=devto" rel="noopener noreferrer"&gt;DrawlyHub&lt;/a&gt;, a Mermaid diagram renders as a container &lt;em&gt;on the same board&lt;/em&gt; as hand-placed boxes, Markdown notes, and a frame an AI agent drafted over MCP. Text where text wins; boxes where layout wins; generation where you just want a head start — and all of it on one canvas with one URL, organized into frames you can present.&lt;/p&gt;

&lt;h2&gt;
  
  
  The honest caveats
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Mermaid containers render Mermaid — they don't fix Mermaid's layout.&lt;/strong&gt; If a diagram is a layout fight in a &lt;code&gt;.md&lt;/code&gt; file, it's the same fight on a canvas. The point is that it can sit &lt;em&gt;next to&lt;/em&gt; the freeform parts, not that the grammar changes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI generation is a draft, not an architect.&lt;/strong&gt; Treat every generated frame as a first pass to review, not a source of truth.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Building boards from an agent is a Pro feature&lt;/strong&gt;, with a two-week no-card trial if you want to try the whole flow.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;

&lt;p&gt;Open the &lt;a href="https://drawlyhub.com/demo?ref=devto" rel="noopener noreferrer"&gt;demo board&lt;/a&gt; and look at how a Mermaid diagram, a few hand-placed boxes, and a Markdown note share one canvas — no account needed. Then pick the right tool for each part of your next diagram, instead of forcing one tool onto all of it.&lt;/p&gt;

</description>
      <category>mermaid</category>
      <category>diagrams</category>
      <category>ai</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Drawing architecture diagrams with an AI agent over MCP</title>
      <dc:creator>Sheel Khanna</dc:creator>
      <pubDate>Sun, 15 Nov 2026 03:10:28 +0000</pubDate>
      <link>https://dev.to/sheel_khanna_418791d4d635/drawing-architecture-diagrams-with-an-ai-agent-over-mcp-4769</link>
      <guid>https://dev.to/sheel_khanna_418791d4d635/drawing-architecture-diagrams-with-an-ai-agent-over-mcp-4769</guid>
      <description>&lt;p&gt;Ask any coding assistant to "diagram this service" and you get the same thing back: a fenced Mermaid block, or some ASCII boxes, or a PNG you drop into a doc and never touch again. It's fine. It's also a dead end — the moment a teammate wants to move a box, add a note, or present it, they're redrawing it by hand somewhere else.&lt;/p&gt;

&lt;p&gt;I wanted the other thing: an agent that draws onto a &lt;strong&gt;real whiteboard&lt;/strong&gt; — a shared canvas my team already opens, with nodes you can drag, connectors that stay attached, and sticky notes you can argue in. So I wired one up over &lt;a href="https://modelcontextprotocol.io" rel="noopener noreferrer"&gt;MCP&lt;/a&gt;, and it turned out to be less work than I expected. Here's how it went.&lt;/p&gt;

&lt;h2&gt;
  
  
  The gap: "diagram output" vs. "a thing your team uses"
&lt;/h2&gt;

&lt;p&gt;A Mermaid snippet is text that &lt;em&gt;renders&lt;/em&gt; a diagram. A whiteboard is an artifact your team &lt;em&gt;works on&lt;/em&gt;. Those are different objects with different half-lives:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The snippet lives in one chat transcript. Nobody finds it next week.&lt;/li&gt;
&lt;li&gt;The board has a URL. You share it, link it from the ticket, and open it in the standup.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If the agent can only produce the first, the human still has to do the translation into the second — which is exactly the tedious part. The interesting version of "AI draws my architecture" is the one where the output &lt;em&gt;is&lt;/em&gt; the shared artifact.&lt;/p&gt;

&lt;h2&gt;
  
  
  MCP is the missing socket
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://drawlyhub.com/demo?ref=devto" rel="noopener noreferrer"&gt;DrawlyHub&lt;/a&gt; (the whiteboard I work on) exposes an MCP server. MCP is just a standard way for an AI client — Claude, an IDE agent, your own script — to discover a tool's capabilities and call them with your authorization. So instead of the agent printing diagram syntax, it calls tools like "create a board," "add a frame," "place these nodes," "connect A to B."&lt;/p&gt;

&lt;p&gt;Connecting it is the ordinary OAuth dance, and the one detail worth watching is the consent screen:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The client hits &lt;code&gt;/.well-known/oauth-authorization-server&lt;/code&gt; and discovers the endpoints.&lt;/li&gt;
&lt;li&gt;It registers itself (open Dynamic Client Registration, RFC 7591 — standard for MCP).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You&lt;/strong&gt; get a consent screen in your browser and approve what the agent may do.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;That third step is the whole security model, and it's worth saying plainly: the agent can only ever act on your data &lt;em&gt;after you approve it on a screen you control&lt;/em&gt;. A client that isn't one of the first-party apps shows up labeled &lt;strong&gt;unverified&lt;/strong&gt;, so a look-alike can't dress itself up as something you trust. You're not handing out a&lt;br&gt;
standing key; you're granting a scoped, revocable session to a named app.&lt;/p&gt;
&lt;h2&gt;
  
  
  The demo: "draw me a three-tier setup on AWS"
&lt;/h2&gt;

&lt;p&gt;With the agent connected, I asked for something concrete:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;Draw a three-tier web architecture on a new board: CloudFront in front of an ALB,&lt;br&gt;
an ECS service behind it, RDS and an S3 bucket below. Label the connectors with the protocol.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;What came back wasn't a code block — it was a board. Under the hood the agent doesn't poke the canvas box by box. It asks the server to &lt;code&gt;describe_format&lt;/code&gt;, composes the whole diagram as one &lt;strong&gt;board document&lt;/strong&gt;, validates it, and submits it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="nf"&gt;describe_format&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;                      &lt;span class="c1"&gt;# learn the .drawly schema&lt;/span&gt;

&lt;span class="n"&gt;board&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="s2"&gt;"format"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"drawly-spec"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"version"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="s2"&gt;"title"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Three-tier web on AWS"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="s2"&gt;"frames"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"key"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"request-path"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"title"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Request path"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s2"&gt;"elements"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"box"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"cf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"x"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;120&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"y"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"w"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"h"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"CloudFront"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"palette"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"sky"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"box"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"alb"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"x"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;120&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"y"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;220&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"w"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"h"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ALB"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;         &lt;span class="s2"&gt;"palette"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"sky"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"box"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ecs"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"x"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;120&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"y"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;360&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"w"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"h"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ECS service"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"palette"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"violet"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"box"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"rds"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"x"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;420&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"y"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;360&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"w"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"h"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"RDS"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;         &lt;span class="s2"&gt;"palette"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"emerald"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"box"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"s3"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"x"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;420&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"y"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;220&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"w"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"h"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"S3 bucket"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;   &lt;span class="s2"&gt;"palette"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"emerald"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"link"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"k1"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"from"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"cf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"to"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"alb"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"HTTPS"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"link"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"k2"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"from"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"alb"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"to"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ecs"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"HTTP"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"link"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"k3"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"from"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ecs"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"to"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"rds"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"5432"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"link"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"k4"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"from"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ecs"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"to"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"s3"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"SDK"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nf"&gt;validate_board&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;board&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;         &lt;span class="c1"&gt;# dry-run: catches a dangling link or bad id&lt;/span&gt;
&lt;span class="nf"&gt;create_board&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;board&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;           &lt;span class="c1"&gt;# creates it, hands back the board's URL&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The declarative shape is the nice part: the agent authors the &lt;em&gt;whole&lt;/em&gt; diagram as data, &lt;code&gt;validate_board&lt;/code&gt; catches a connector pointing at nothing before anything is created, and &lt;code&gt;create_board&lt;/code&gt; returns a URL. Connectors are &lt;code&gt;link&lt;/code&gt; elements that reference box ids, so they stay attached when you move a box around later.&lt;/p&gt;

&lt;p&gt;I opened the board URL and the boxes were there, wired up, laid out on a frame I could pan and zoom. Then I did the thing you can't do with a Mermaid block: I grabbed the RDS box and moved it, dropped a sticky note on the ECS box that said "autoscaling TBD," and sent the link to a teammate to finish.&lt;/p&gt;

&lt;p&gt;For the parts that genuinely are better as code than as hand-placed boxes — a sequence diagram, say — the agent can drop a &lt;strong&gt;Mermaid container&lt;/strong&gt; onto the board instead, so the diagram renders from text but still lives on the same canvas as everything else. Text where text wins, boxes where boxes win, one surface either way.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why the board beats the snippet
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;It has a URL.&lt;/strong&gt; The architecture is linkable from the PR, the ticket, the doc. It doesn't evaporate with the chat.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;It's editable by humans.&lt;/strong&gt; The agent gives you a first draft in seconds; you refine it by dragging, not by re-prompting. Boards organize into frames (think slides), so one board can hold the request path, the data model, and the deploy pipeline side by side.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You can hand it off.&lt;/strong&gt; Share it view-only with a link, or give a teammate edit access, and present it frame by frame. The agent did the typing; the team does the thinking.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  The honest caveats
&lt;/h2&gt;

&lt;p&gt;This is early, and I'd rather tell you than have you find out:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;It's a first draft, not an architect.&lt;/strong&gt; The agent places what you describe; layout and correctness are still yours to own. It's a huge head start, not a replacement for judgment.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Creating boards from an agent is a Pro feature.&lt;/strong&gt; There's a two-week trial with no card if you want to kick the tires on the whole thing, including the MCP flow.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;It's a whiteboard, not a modeling tool.&lt;/strong&gt; If you need validated infrastructure-as-code or a cloud cost estimate, this isn't that. It's for thinking visually, fast, with an agent doing the grunt work of placement.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Open the live &lt;a href="https://drawlyhub.com/demo?ref=devto" rel="noopener noreferrer"&gt;demo board&lt;/a&gt; to see what the canvas feels like — no account needed.&lt;/li&gt;
&lt;li&gt;If you run an MCP-capable client, point it at DrawlyHub and ask it to draw something. The consent screen will walk you through what it's allowed to do.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you build something fun with it — or break it — I'd genuinely like to hear about it.&lt;br&gt;
The gap between "AI output" and "a thing my team actually uses" is the whole reason this exists, and MCP turned out to be the clean way to close it.&lt;/p&gt;

</description>
      <category>mcp</category>
      <category>ai</category>
      <category>webdev</category>
      <category>showdev</category>
    </item>
  </channel>
</rss>
