Stomra Guides

Stomra · Guide

Work orders

Walk the model, aim at something and say what should change. Your own AI assistant carries it out, and you see the building change where you stand.

1 2 3 4 5 your right GD1 · Glazed partition, in the lounge wall WORK ORDER · about 1 GD1 Glazed partition Move this 1 m to the right Enter
Press O in walk mode. The view holds still, what you aim at is named and numbered 1, and every other thing in view gets a number you can click to add. “Right” is your right, from where you stand.

What a work order is

A work order is a short request to change the model, written where you see the problem: “Move this 1 m to the right”, “a window here”, “make this door 1000 wide”. It is kept beside the model, numbered per project (O-1, O-2 …), with everything someone needs to carry it out without asking where you meant.

Anyone can carry out an order: a colleague by hand, or an AI assistant. Stomra has no AI of its own; the assistant is the one you already use, such as Claude or ChatGPT, connected to Stomra and working in your open tab. You see every change it makes, and Undo takes it back.

Walk mode and Modelling with your AI assistant introduce orders briefly. This guide goes through the whole round.

Write one in walk mode

  1. Aim and press O. The walk stops and the view holds still. A panel at the foot names what you aim at and the wall it sits in. Every thing in view carries a number; click a number to add that thing to the order as well.
  2. Say what should change. Type it in the language you use with your assistant. Or hold O a moment and speak: your browser's own dictation writes what you say into the field, and you correct it by hand. The Hold to say it button in the panel does the same, and the language is chosen beside it.
  3. Press Enter. The order is saved (“O-12 saved”) and you walk on. A pin with the order's number stands where you aimed, faint behind walls, with a dot on the plan map.

An order can be about a thing (“move this”), about a place (“a window here”), or both. On a touch screen, write an order from the walk's menu (Write an order).

G takes you from one open order to the next: you stand where it was written, looking as its author did, and the walk says which order it is and how it stands. The walk's menu lists the orders too.

What an order keeps

Words alone are ambiguous. “To the right” depends on where you stood. So an order keeps what an assistant, or a colleague, needs to act on it.

KeptFor example
Your wordsMove this 1 m to the right
What you aimed at, as it was thenGD1 · Glazed partition, in the lounge wall
The point you aimed aton the wall: how far along it and how high
Where you stood and which way you looked4.7 m in front of the partition
What your right means therefor this wall, to your right shortens the distance along it
Two picturesthe view as you saw it, and the same with a number on each thing in it, with a list of what the numbers are
Other things you clicked3 · the window beside it

The order also notes the state of the model when it was written, so an assistant can tell whether things have moved since.

Following orders

Project ▸ Work orders lists every order of the project, with how it stands: All, Open, and My prompts. An order opens to its two pictures and its thread, where people and assistants write what was done, asked or answered.

Open Taken Proposed Done yes no, with a reason carried out Question · asks the author Declined · with the reason Withdrawn · by its author
An order's life. The author's answer to a question opens it again; so does “Open again” after it was done.

Depending on who you are and how the order stands, the dialog offers Go there (walk mode starts where the order was written), Copy for my assistant (the order as text to paste into any chat), I take it, Let go, Done, Decline, Withdraw, Looks right and Open again. Below the order you can write a reply or a question.

A short message at the lower right of the app says when an order is saved, taken, has a question, is done or is declined, wherever you are in the project. In walk mode the walk says it instead. When you were away, the bell keeps it: the author hears what happened to their order, and everyone who may edit the project hears of a new one. Orders never send email.

How your assistant carries one out

Nothing can wake an assistant by itself: it acts when you write to it, or while it works. So Stomra tells it in the places it already reads. When orders wait, the project summary and status say so, and so does the answer of whatever Stomra tool it calls. A good assistant then tells you and asks whether to carry them out. You can also say “carry out the open work orders”, or use Copy for my assistant and paste the order.

  1. It reads the order: the words, what was aimed at, where you stood, the two pictures, and what has changed in the model since.
  2. It looks at the neighbours: another opening in the same wall, the wall's ends, a wall that meets it where the thing would land.
  3. It asks before it changes anything. For your own order, it says in a sentence or two what it would do and asks; you may tell it to go ahead without asking. For an order someone else wrote, it proposes the change, and a person answers yes or no (next section).
  4. It asks the author when in doubt. If the words can be read two ways, or the model refuses the change, the order goes to Question with what it needs to know: “GP1 can move 400 mm before it meets GP2. 400 mm, or both doors?” It never guesses.
  5. It carries it out as one Undo step, and saves a version named after the order (“O-12: Move this 1 m to the right”), so the History lists it.
  6. It checks itself. It gets back what changed, said in your directions (“GD1 moved 1 000 mm to your right. Nothing else changed.”), anything the change left odd, and the same view again from where you stood, with the same numbers. If that does not match your words, it undoes the step and asks.

An order that cannot or should not be done is declined, with the reason in its thread. You tick Looks right when you have seen the result, or write what is wrong, which opens it again.

No order needed while you walk. While you are in walk mode, your assistant can see where you stand and what you aim at. “Move this door” typed in the chat means the door in front of you.

Proposals: yes or no where you stand

An order written by someone else is never carried out by an assistant directly. It proposes the change, and a person decides by looking at it.

where it stood after a yes 1 CHANGED O-1 · CLAUDE, FOR ANNA, PROPOSES Move the partition one metre to the right, as written. After a yes: GD1 · Glazed partition moved 1 000 mm to your right. Y Yes, do it N No, and why
A proposal shown in walk mode: the model as it would be, changed parts in amber, added ones in green, what would go as a red ghost.

If the model has changed since the proposal was made and no longer accepts it, nothing is changed and the assistant makes the proposal again.

Live review

Tell your assistant once: “take my orders as I write them”. It then waits for orders while you walk. A quiet line in the walk says so: Claude is listening: O says what should change.

The round is then: aim, press O, say it, press Enter. Within a second the assistant reads the order and proposes the change; you see it where you stand and press Y or N. Nothing is typed in the chat. Say “stop” in the chat when you are done.

How long an assistant keeps listening depends on the assistant: one that works on its own for long stretches goes on; a chat window may stop after a while and needs to be told to go on.

Prompts from the AI sketch

The same queue takes prompts from outside the walk. On any view, the AI sketch pen lets you ring things, draw arrows and add numbered notes (Arrow with text). Its menu, from the pen's drop-down or a right-click, offers Send prompt to assistant…:

  1. Write, or say, what your assistant should do: “make the doors in notes 1 and 2 a metre wide”.
  2. Keep With the sketch ticked to send the picture of the view with your strokes and notes.
  3. Send. The prompt waits under Project ▸ Work orders, and the sketch is cleared so you can draw the next one.

You can queue several prompts and let the assistant work through them in turn. New prompt… in Project ▸ Work orders sends one without a sketch, and My prompts lists yours.

A prompt is your own word to your own assistant, so it is carried out without a proposal or a question first, note by note. Only a note it cannot place becomes a question. Colleagues can see your prompts in the list, but their bell stays quiet.

Who may do what

WhoMay
Everyone who may open the projectWrite orders and prompts, reply in a thread, say no to a proposal shown to them.
The order's authorWithdraw it, answer a question, tick Looks right, open it again.
The project's editors, and their assistantsTake, carry out, ask, decline. Say yes to a proposal.

An assistant acts as the person whose tab it works in, under that person's rights, and gives its own name. The order then says, for example, “Taken by Claude, for Anna”. In the tab of someone who may only look, an assistant reads orders and changes nothing. A taken order is let go by itself after ten minutes without anything happening on it, so an assistant that has gone leaves nothing stuck.

Clients on the client portal do not write work orders; they mark up the issues they are sent.

Good to know

When a colleague's change touches your discipline on a shared project, it reaches you the same way, as a suggestion in Project ▸ Work orders: see Sharing by discipline.