Learn

Architecture & pattern guides

Read the idea, build it on a Grid, prove it in a challenge. Short, practical guides — illustrated with RodGrid's own nodes — on system design, design patterns, flow modeling, and how to get the most out of the app.

All articles

Starting from a brief: the diagram generators

Answer an interview and get a validated architecture Grid, or describe a design pattern and get its roles drawn.

On the Dashboard's Diagrams tab, the AI Diagram Generator card writes the first version of a Grid from what you tell it. Architecture intake interviews you and shows a preview before it builds a Diagram Grid. Design pattern turns one short brief into a pattern Grid in a single run. Both create a new Grid. If a common shape will do, Starting from a template gives you one without spending credits; once the Grid exists, Writing a PRD from the diagram drafts the requirements that go with it.

One intake, a hotel booking site

Say you need a first architecture for a hotel booking site: guests search by city and dates, a room is held while they pay, and the same room can never be sold twice for the same night. With the card on Architecture intake:

  1. Start generator opens Architecture Intake to Grid. Name the intake in Grid title, choose a Preferred platform (Generic/Open, AWS, Azure or Google Cloud) and a Respondent profile, and press Start intake.
  2. Answer the questions one at a time with Save answer, which costs nothing. Edit answer reopens any earlier one; after a preview, an edit only counts once you generate again, at the same price.
  3. After the last answer, press Generate preview - 35 credits.
  4. If the preview shows no blockers, Create generated Grid opens the new Diagram Grid.

The platform has no default, and it only steers which catalog components get picked: AWS prefers AWS services and falls back to generic ones. The profile decides the questions: 13 for Staff architect, 12 for Business owner, 10 for Mixed business and technical. If you can say where the room hold lives and what expires it, answer as Staff architect. If you can only say who books and what the hotels need to see, choose Business owner: the staff-architect questions would ask for detail you do not have, and your guesses would come back as the draft.

NoteArchitecture intake is the one AI feature that asks for a plan: starting an intake needs Pro or above, and a preview is refused on a lower plan even with credits in hand. The pattern generator needs credits alone, and each run shows its price on its button. Balances, the welcome grant and failed runs are covered in AI credits: what they buy and how they are spent.

What "validated" checks

Before it checks anything, the generator repairs some wiring on its own. A frontend drawn straight to a database is rerouted through an API already on the draft or, when there is none, through an API node it adds. Provider fallback notes list every node with the component chosen and why, so an added node shows up there.

Then come the checks. Validation blockers stop the draft from becoming a Grid:

  • a component with no connection, or a connection the edge rules forbid that the repair could not fix;
  • 120 nodes or 240 edges, or more;
  • a high or critical finding from the model's own review of its draft, or a broken draft (no title, no components, a duplicated id, an edge to a missing node).

A blocked preview is still charged, because the model did answer. If a blocker follows from one of your answers, change it with Edit answer; a broken draft may clear with another run as it stands. Each run costs the full price. Review warnings do not block: a component that fell back to a custom node, a draft at or above the recommended size of 60 nodes or 120 edges, lower-severity review findings, connections the rules question. Check those first on the new Grid. So "validated" means the draft passed structural checks, not that the room hold is in the right place; AI Architecture Analysis: a review of your diagram reviews the design once the Grid exists.

Create generated Grid runs the checks once more on the laid-out draft and opens the new Grid under the preview's title. Each intake makes one Grid and then offers only Open generated Grid, and at most two intakes without a Grid can be open at once; Delete Intake frees a place and keeps any Grid it made.

A pattern from one paragraph

Switch the card to Design pattern. Pattern (optional) offers 22 names or Any pattern (let AI decide). The Brief holds up to 1,800 characters: "A stock price that several dashboards display and must refresh when it changes." Pick Observer and press Generate pattern Grid - 20 credits.

There are no questions and no preview: the new pattern Grid opens straight away. Its nodes are roles, not technologies: a subject and its observers rather than a message broker, with each relationship labelled by what it does, such as notifies or subscribes. Nothing validates it, so a role left unconnected stays on the Grid. On Free, a role your plan's palette does not include is drawn as the generic Component role, keeping the name the AI gave it.

Build first, then generate

Open the Observer Pattern Challenge and build it yourself: a subject, its observers, subscribe one way and notify the other, in six nodes or fewer. Then generate Observer from the Challenge's own description and put the two Grids side by side. Where the generated one has a relationship yours lacks, check it against the Challenge's requirements: you may have missed it, the generator may have added something the pattern does not need, or it may be another valid way to draw the same pattern. On Pro or above, run the intake on the Hotel Booking System Challenge's description after you have attempted it, and compare where each design puts the room hold.

Practice this