Use a Frame when part of the Grid deserves a name. Use a group when you want several nodes to stay linked for a few actions. A frame is a shape everyone can see; a group has no name, and nothing on the canvas shows it. Neither one changes the design: components and edges stay as they are.
Frames and swimlanes: regions you can see
Place a Frame from the shapes in the palette (The node palette & component families shows where they live), resize it around a subsystem and double-click its label to name it. It paints behind your nodes, so clicking a node or an edge inside it still selects that node or edge. Dragging the frame carries every node fully inside it.
Drag the frame and Gateway and Billing Service go with it. Billing DB stays where it is, and its edge stretches.
A node that sticks out by a few pixels stays behind too, and arrow keys move the frame alone. A Swimlane behaves the same way and draws three horizontal bands, which suits separating responsibilities. Neither shape takes an edge. To record who owns a region instead of drawing around it, see From a picture to a model: governance and views.
Groups: a link between selected nodes
Select two or more nodes that are not already in a group and press Ctrl/⌘+G, or use Group on the selection bar. Ctrl/⌘+Shift+G or Ungroup releases them. What the link does depends on the action:
- Arrow-key nudges take the whole group, even with one member selected.
- Right-click on a member you had not selected selects the whole group.
- Copy and paste take what is selected, and a plain click selects one node. With the whole group selected, copy takes all of it and paste brings it back as a group.
- A drag moves only the node you grab unless all are selected.
Notes on the canvas
A sticky note holds a TODO or an open question, and free text holds a heading or a callout.
The two annotation shapes.
The floating comment carries replies, resolve and @mentions, so it is a conversation rather than a note, and it needs Premium (or a Premium owner's Grid, where any guest with edit access can place one). Sticky notes and free text only wire to other shapes, never to a system node; a floating comment can be pointed at a node.
All of these shapes, frames included, are layout and documentation only. Challenge Grids don't offer them. Architecture Analysis, Explain and the PRD generator leave them out; a Pattern Review reads their text as written context, not as components or connections.
Comments: a thread with an anchor
Right-click a node or an edge and choose Add comment, or write in the comments panel with nothing selected to comment on the whole Grid. The comment stays anchored to that target. When a discussion ends, Resolve it rather than delete it: it stays in the panel, and Reopen brings it back. Comments need Premium on that Grid, and the plan that counts is the owner's.
What makes a crowded Grid worse
- Framing everything. A frame around every pair of nodes is noise; frame the regions you'd name in a design review, and no more.
- Grouping when you meant framing. A group travels through nudges and, once fully selected, through copy and paste, but it carries no name. If the cluster deserves a label, it deserves a frame.
- Running Tidy over framed nodes. It leaves frames in place and moves the nodes; Working faster: shortcuts, search and tidy has the detail.
Your most crowded Grid, without touching an edge
Open it, put one frame around each part you could name out loud, and add one sticky note per open question. The News Feed Challenge has no shapes to practise on, but groups work there: group the nodes that serve a feed read and nudge them clear of the nodes that publish a post.