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.
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
- 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.
- 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.
- 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.
| Kept | For example |
|---|---|
| Your words | Move this 1 m to the right |
| What you aimed at, as it was then | GD1 · Glazed partition, in the lounge wall |
| The point you aimed at | on the wall: how far along it and how high |
| Where you stood and which way you looked | 4.7 m in front of the partition |
| What your right means there | for this wall, to your right shortens the distance along it |
| Two pictures | the 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 clicked | 3 · 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.
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.
- It reads the order: the words, what was aimed at, where you stood, the two pictures, and what has changed in the model since.
- 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.
- 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).
- 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.
- 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.
- 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.
- In walk mode, the proposal comes by itself: a panel says who proposes what, and the model as it would be is shown the way a version is. 0 goes back to the model as it is; G shows the proposal again from where the order was written.
- Y is yes. Your own tab makes the change, as your own Undo step, saves a version named after the order and marks it done.
- N is no. The model as it is comes back, and a small panel asks why. The order opens again with your reason, which the assistant reads before it proposes anew or asks.
- At your desk, a proposal is a message that stays until read, and Project ▸ Work orders shows it with what it would do, Yes, do it and No.
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…:
- Write, or say, what your assistant should do: “make the doors in notes 1 and 2 a metre wide”.
- Keep With the sketch ticked to send the picture of the view with your strokes and notes.
- 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
| Who | May |
|---|---|
| Everyone who may open the project | Write orders and prompts, reply in a thread, say no to a proposal shown to them. |
| The order's author | Withdraw it, answer a question, tick Looks right, open it again. |
| The project's editors, and their assistants | Take, 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
- The tab must be open, as for everything an assistant does in Stomra.
- An assistant sees an order when it next works in the project, when you paste it, or while it listens.
- Stomra does not read the words. It keeps them, with everything needed to act on them. That is why the assistant asks first and looks at the result afterwards.
- Taking and finishing an order are not Undo steps. The change an order leads to is: one Undo step, and a version in the History.
- Numbers go on whole elements. A stud inside a wall has none of its own; the order keeps the wall and the point you aimed at.
- Dictation is your browser's. Stomra hosts none; some browsers send the sound to their maker to write it out, and the first time the browser asks for the microphone.
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.