nixfredEXE.DEVFIELD GUIDE · BY NIX UNOFFICIAL
WHITEBOARD / WHITEBOARD FIELDCRAFT

Whiteboard fieldcraft

The board is what you’re delivering. Each of the four boards in this guide can be drawn in under five minutes, and each one ends with a single rule written at the bottom that the other person can take away.

Ask, draw, validate

  1. Ask three questions before you pick up a marker. What runs today, and where? Who or what needs access: humans, agents, CI? What has to stay secret?
  2. Draw from the left. Clients start on the left and exe.dev sits on the right, so arrows flow the way a request does.
  3. Say what you’re drawing as you draw it. Every box gets a one-line spoken sentence. The Say: lines on each board are written for that.
  4. Validate at every step. After each big arrow, ask “Is that right for you?” and correct the board on the spot.
  5. Write the rule at the bottom, for example “Secrets live on the network, not on the VM.”

Shared shapes and colors

ShapeMeans
Rounded rectangleexe.dev edge / control plane (exe.dev, the lobby)
SquareA VM (write its name and size)
Dashed rectangleA pool (write vCPU / GiB and region)
CylinderDisk or external data
Green arrowAllowed path (HTTPS through the proxy, integration calls)
Red arrowBlocked path (direct secret access, private network that does not exist)

The four boards

Sources for the boards

Every claim on these boards links to an exe.dev docs page, listed under each board. When you’re not sure, stop drawing and open the page: https://exe.dev/docs.md.

The four boards

← Teams, Work, Enterprise · Board: request path →